Deliver On-Demand Content

 

ON THIS PAGE      Show

 

 

 

 

What is On-Demand?

On-Demand delivery is very flexible, allowing you to more carefully select the content to send to AP Media Agent or AP Media API. With On-Demand, you can select either an individual story (and, if any, its linked media) or an individual media item in AP Newsroom and have the items automatically delivered to your CMS via Media API or Media Agent.

How does On-Demand Delivery Work?

  1. On-Demand delivery provides you with the default queue to which AP Newsroom users will be sending content. You (your organization's On-Demand Administrator) can optionally create one or more additional queues. Learn how to set up On-Demand queues >>

  2. You configure your Media Agent or programmatically integrate with AP Media API to ingest content from these On-Demand queues. Learn how to ingest content from On-Demand queues >>

  3. Users select content in AP Newsroom and send it to one or more On-Demand queues. Learn about selecting On-Demand content in AP Newsroom >>

  4. Content items from the On-Demand queues are automatically delivered to your CMS via Media Agent or Media API.

How do I set up On-Demand Queues?

You can create up to nine On-Demand queues in addition to the default queue. Once a queue is created, it may be renamed, disabled or deleted.

  1. On the configuration dashboard, scroll down to the On-Demand Queues section.

  2. To add an On-Demand queue, click the plus sign at the top right of this section:

  1. In the Create queue dialog box, enter the queue name and description:

  1. Make sure that the Enabled option is selected.

 

 

 Important

 

 

When you create a new queue on the dashboard and enable it, the queue appears in AP Newsroom right away. Content sent by AP Newsroom users to On-Demand queues stays there for seven days. If you are not planning to configure your agent soon to process the new queue, it is recommended to disable the queue until you are ready to add it to the content profile and configure your agent to ingest content from the queue.

 

 

 

 

  1. Click OK.

  2. Repeat steps 2-5 for any new queue that you want to create.

To rename or disable a queue:

  1. Click Options for the queue you want to edit, and then select Edit from the menu:

The Edit Queue window opens:

  1. Do one or more of the following:

    • Rename the queue by typing the new name in the Name box.

    • Disable the queue by clicking the Enabled slider to deselect it.

  2. Click OK.

To delete a queue:

  1. Disable the queue as described above.

  2. Click Options for the queue you want to delete, and then select Delete from the menu:

  1. Click OK to confirm:

How do I ingest content from On-Demand queues?

If you are using AP Media Agent

  1. On the configuration dashboard, navigate to your desired profile.

  2. On the Select Content tab, in the AP Newsroom On-Demand section, select one or more On-Demand queue check boxes:

  1. Click Save Profile at the bottom of the page to save your selections.

  2. Make sure that your profile is assigned to an agent that is ingesting content.

If you are accessing the content programmatically via AP Media API

To ingest content from the default On-Demand queue, use the following request URL and supply the API key in the x-api-key request header:

https://api.ap.org/media/v/content/ondemand

To ingest content from an On-Demand queue that you have created, add the queue ID to the request URL; for example:

https://api.ap.org/media/v/content/ondemand?queue=5e66aea63ca1110b2cc7afea

Make sure to supply the API key in the x-api-key request header.

You can find the queue ID in the On-Demand Queues section of the configuration dashboard in AP Newsroom:

To learn more, refer to the AP Media API Developer documentation.

How do I select my On-Demand content in AP Newsroom?

  1. In AP Newsroom, perform a search to locate the desired content.

  2. In search results, click    for the content item that you want to send to On-Demand, and then click Send To On-Demand.

  3. In the Send To On-Demand dialog box, select one or more On-Demand queues to which you want to send the content item.

  4. Click Send To On-Demand.