API Workflows

  • The LIST API can be used to retrieve a list of Publishers.

  • Creating a new Publisher requires a unique externalPublisherId and involves calling the Create and Get APIs, with the option to upload a logo.

  • To update a Publisher, you may need to use the LIST API to find it, then use the Patch API with an updateMask to specify the fields to be changed.

  • Important fields to provide or update for a Publisher include Display Name, Description, Contact Information, Logo, and Forecast.

This guide describes common API workflows for creating, retrieving, and updating publishers in Display & Video 360.

Get a list of Publishers

Call LIST API.

Create a new Publisher

  1. externalPublisherId is required and must be unique. externalPublisherIds can be populated for additional publisher IDs.
  2. Call Create API. A unique name will be assigned, and can be used to get the created Publisher.
  3. Call Get API to see details of the created Publisher.
  4. Optionally, Upload a logo for the created Publisher.

Update Publisher

  1. If you don't store the created Publisher Name, call the LIST API to find the Publisher you want to update.
  2. Update the fields based on results from the LIST API.
  3. Call the Patch API to update the Publisher. The updateMask is required. It indicates which fields you want the update to be applied to. Only fields that are allowed to be updated can be set in the updateMask.

Important fields to provide:

  • Display Name
  • Description
  • Contact Information
  • Logo
  • Forecast
    • Provide publisher owned DOMAIN_NAME under 'breakdowns'
    • Provide publisher owned App under 'appsBreakdown'