Object Types

MultiLocaleString

The MultiLocaleString object represents a textual fields with values for multiple locales. It contains two fields: localized and preferredLocale . See below for a detailed description of these fields, allowed values, and sample JSON.

MultiLocaleString Schema

Field Name Sub-Field Name Required Description
localized   Yes Maps a locale to a localized version of the string. Each key is a Locale record converted to string format, with the language, country and variant separated by underscores. Examples: 'en', 'de_DE', 'en_US_WIN', 'de_POSIX', 'fr_MAC'.
preferredLocale   No The preferred locale to use, based on standard rules.
  country No An uppercase two-letter country code as defined by  ISO-3166 .
  language Yes A lowercase two-letter language code as defined by  ISO-639 .

Sample JSON of multiLocaleString

{
   "address":{
      "localized":{
         "en_US":"2029 Stierlin Ct, Mountain View, CA 94043"
      },
      "preferredLocale":{
         "country":"US",
         "language":"en"
      }
   }
}

MultiLocaleRichText

The MultiLocaleRichText object represents a textual fields with values for multiple locales. It contains two fields: localized and preferredLocale . See below for a detailed description of these fields, allowed values, and sample JSON.

MultiLocaleRichText Schema

Field Name Sub-Field Name Required Description
localized   Yes Maps a locale to a localized version of the string. Each key is a Locale record converted to string format, with the language, country and variant separated by underscores. Examples: 'en', 'de_DE', 'en_US_WIN', 'de_POSIX', 'fr_MAC'.
  rawText No Rich text represented in string.
preferredLocale   No The preferred locale to use, based on standard rules.
  country No An uppercase two-letter country code as defined by  ISO-3166 .
  language Yes A lowercase two-letter language code as defined by  ISO-639 .

Sample JSON of multiLocaleRichText

{
   "summary":{
      "preferredLocale":{
         "country":"US",
         "language":"en"
      },
      "localized":{
         "en_US":{
            "rawText":"Awesome summary of me."
         }
      }
   }
}

MultiLocaleUrl

The MultiLocaleUrl object represents a textual fields with values for multiple locales. It contains two fields: localized and preferredLocale . See below for a detailed description of these fields, allowed values, and sample JSON.

MultiLocaleUrl Schema

Field Name Sub-Field Name Required Description
localized   Yes Maps a locale to a localized version of the string. Each key is a Locale record converted to string format, with the language, country and variant separated by underscores. Examples: 'en', 'de_DE', 'en_US_WIN', 'de_POSIX', 'fr_MAC'.
preferredLocale   No The preferred locale to use, based on standard rules.
  country No An uppercase two-letter country code as defined by  ISO-3166 .
  language Yes A lowercase two-letter language code as defined by  ISO-639 .

Sample JSON of multiLocaleUrl

{
   "url":{
      "localized":{
         "en_US":"http://www.linkedin-other.com"
      },
      "preferredLocale":{
         "country":"US",
         "language":"en"
      }
   }
}

Date

The Date object represents a date of day, month and year.

Date Schema

Field Name Required Type
day No Day represented in integer. Valid range from 1 to 31 depending on month.
month No Month represented in integer. Valid range from 1 to 12.
year No Year represented in integer.

Sample JSON of date

{
   "birthDate":{
      "day":1,
      "month":1,
      "year":1974
   }
}

LocaleString

The LocaleString object represents a textual fields with the specified locale. It contains two fields: locale and value . See below for a detailed description of these fields, allowed values, and sample JSON.

LocaleString Schema

Field Name Sub-Field Name Required Description
locale   Yes Maps a locale to a localized version of the string. Each key is a Locale record converted to string format, with the language, country and variant separated by underscores. Examples: 'en', 'de_DE', 'en_US_WIN', 'de_POSIX', 'fr_MAC'.
  country No An uppercase two-letter country code as defined by  ISO-3166 .
  language Yes A lowercase two-letter language code as defined by  ISO-639 .
value   Yes The value represented in string.

Sample JSON of LocaleString

{
   "name":{
      "locale":{
         "country":"US",
         "language":"en"
      },
      "value":"California"
   }
}

Locale

The Locale object represents a country and language . See below for a detailed description of these fields, allowed values, and sample JSON.

Locale Schema

Field Name Required Description
country No An uppercase two-letter country code as defined by  ISO-3166 .
language Yes A lowercase two-letter language code as defined by  ISO-639 .

Sample JSON of Locale

{
   "locale":{
      "country":"US",
      "language":"en"
   }
}

Video

The Video object represents the metadata for a video content.

Video Schema

Field Name Required Format Description
description Optional MultiLocaleString Description of this video.
duration Optional int Duration of the video in milliseconds.
height Yes int Height of this video in pixels.
htmlEmbedCode Optional String The html embed code for this video.
title Optional MultiLocaleString Title of this video.
url Yes String The external url of this video.
width Yes int Width of this video in pixels.

Sample JSON of Video

{
   "description":{
      "localized":{
         "en_US":"Description of the video"
      },
      "preferredLocale":{
         "country":"US",
         "language":"en"
      }
   },
   "duration":60000,
   "height":720,
   "title":{
      "localized":{
         "en_US":"Title of the video"
      },
      "preferredLocale":{
         "country":"US",
         "language":"en"
      }
   },
   "url":"https://linkedin.com",
   "width":1080
}

Image

The Image object represents the metadata for an image content.

Image Schema

Field Name Required Format Description
description Optional MultiLocaleString Description of this image.
height Yes int Height of this image in pixels.
htmlEmbedCode Optional String The html embed code for this image.
slideShareImage Optional SlideShareImage Urn The urn to slideshow for this image if uploaded to SlideShare.
title Optional MultiLocaleString Title of this image.
url Yes String The external url of this image.
width Yes int Width of this image in pixels.

Sample JSON of Image

{
   "description":{
      "localized":{
         "en_US":"Description of the image"
      },
      "preferredLocale":{
         "country":"US",
         "language":"en"
      }
   },
   "height":720,
   "title":{
      "localized":{
         "en_US":"Title of the image"
      },
      "preferredLocale":{
         "country":"US",
         "language":"en"
      }
   },
   "url":"https://linkedin.com",
   "width":1080
}

Document

The Document object represents the metadata for a document content. The document is in text files, e.g., .pdf, .doc, .ppt, .pps, .rtf.

Image Schema

Field Name Required Format Description
description Optional MultiLocaleString Description of this document.
height Yes int Height of this document in pixels.
htmlEmbedCode Optional String The html embed code for this document.
slideshow Optional SlideShareSlideShowUrn The urn to slideshow for this document if uploaded to SlideShare.
title Optional MultiLocaleString Title of this document.
url Yes String The external url of this document.
width Yes int Width of this document in pixels.

Sample JSON of Document

{
   "description":{
      "localized":{
         "en_US":"Description of the document"
      },
      "preferredLocale":{
         "country":"US",
         "language":"en"
      }
   },
   "height":720,
   "title":{
      "localized":{
         "en_US":"Title of the document"
      },
      "preferredLocale":{
         "country":"US",
         "language":"en"
      }
   },
   "url":"https://linkedin.com",
   "width":1080
}

The Link object represents the metadata for a link content. The link contains a url that doesn not point to an image, video or document.

Field Name Required Format Description
description Optional MultiLocaleString Description of this link.
title Optional MultiLocaleString Title of this link.
url Yes String The external url of this link.
{
   "description":{
      "localized":{
         "en_US":"Description of the document"
      },
      "preferredLocale":{
         "country":"US",
         "language":"en"
      }
   },
   "title":{
      "localized":{
         "en_US":"Title of the document"
      },
      "preferredLocale":{
         "country":"US",
         "language":"en"
      }
   },
   "url":"https://linkedin.com"
}

AuditStamp

The AuditStamp object represents the metadata of when an object is acted upon.

AuditStamp Schema

Field Name Required Format Description
actor Yes Urn The entity authorized the change.
impersonator Optional Urn The entity which performs the change on behalf of the actor. Must be authorized to act as the actor.
time Yes long When the event happened in epoch time.

Sample JSON of AuditStamp

{
   "actor":"urn:li:person:123ABC",
   "time":1332187798000
}