Linked Media

 

ON THIS PAGE      Show

 

 

 

 

About Linked Media

Text story items may contain references to linked media (for example, pictures, graphics, audio and video linked to the story by an AP editorial staff member). Linked media files may be available in the same formats as media renditions shown in the right column of the Content Item Formats and Renditions table.

Linked media references are delivered as associations in the JSON text story item.

Story with Linked Media Example

Structure Example

For brevity, this example shows only one text story item with three linked pictures and one linked video (the complete structure is illustrated only for the first linked picture):

 

  Tip

 

  • JSON text story items (such as 'Text Story Item' in the example above) are delivered in the JSON feed or JSON item metadata files, which your agent downloads when you select the JSON: Feed Files or JSON: Item Files option on the configuration dashboard.

  • Linked media item files ('Linked Picture Item 1', 'Linked Picture Item 2', 'Linked Picture Item 3' and 'Linked Video Item' files in the example above) are downloaded by the agent when you select the JSON: Associated Item Files option on the configuration dashboard.

 

 

 

JSON Example

This JSON example shows a text story item with three linked pictures and a video in associations and a link to the NITF story download in renditions.

// Example:
 "item": {
   "uri": "https://api.ap.org/media/v/content/a849ac631b0849f19bd7550e182c845c",
   "altids": {
      "itemid": "a849ac631b0849f19bd7550e182c845c"...},
   "version": 3,
   "type": "text",
    ...
   "headline": "Cleanup, power restoration begin after 3rd nor'easter",
    ...
   "associations": {
     "1": {
       "uri": "https://api.ap.org/media/v/content/8569b66ad5754931bc44c692a8a325ed",
       "altids": {
         "itemid": "8569b66ad5754931bc44c692a8a325ed",
         "etag": "8569b66ad5754931bc44c692a8a325ed_0a1aza3c0"},
       "version": 0, 
       "type": "picture",
       "headline": "Northeast Storm Massachusetts"},
     "2": {
       "uri": "https://api.ap.org/media/v/content/22bbe96a632f4d01af1f72c0ca6b47c4",
       "altids": {
         "itemid": "22bbe96a632f4d01af1f72c0ca6b47c4",
         "etag": "22bbe96a632f4d01af1f72c0ca6b47c4_0a1aza3c0"},
       "version": 1,  
       "type": "picture",
       "headline": "Winter Weather Virginia"},
     "3": {
       "uri": "https://api.ap.org/media/v/content/dc7b00bb74844d00bc04c74f8e1f0b8b",
       "altids": {
         "itemid": "dc7b00bb74844d00bc04c74f8e1f0b8b",
         "etag": "dc7b00bb74844d00bc04c74f8e1f0b8b_0a1aza3c0"},
       "version": 0, 
       "type": "picture",
       "headline": "Northeast Storm New Hampshire"},
     "4": {
       "uri": "https://api.ap.org/media/v/content/548ae9f9bd5d448091ee10ac5bd727fe",
       "altids": {
         "itemid": "548ae9f9bd5d448091ee10ac5bd727fe",
         "etag": "548ae9f9bd5d448091ee10ac5bd727fe_0a16aza19c0"},
       "version": 0, 
       "type": "video",
       "headline": "Latest Nor'easter Hits New England"}},
   "renditions": {
     "nitf": {
       "title": "NITF Story Download",
       "rel": "Story",
        ... 
       "href": "https://api.ap.org/media/v/content/a849ac631b0849f19bd7550e182c845c/download?type=text&format=NITF"}}}