REST Resource: buyers.publisherProfiles

  • Publisher profiles provide information supplied by publishers to give buyers an overview of their content and main points.

  • Each publisher profile includes details such as the publisher's display name, associated domains and mobile apps, contact information for direct and programmatic deals, media kit and sample page URLs, an overview, pitch statement, key metrics, and audience description.

  • Mobile applications within a publisher profile are described by their external app ID, name, and the type of app store they belong to, such as Apple iTunes or Google Play.

  • A publisher can have one parent profile representing all inventory and multiple child profiles for branding specific portions of inventory.

  • Publisher profiles can be retrieved individually by name using the get method or listed using the list method, with options to filter by display name, domains, mobile app ID, app store type, whether it's a parent profile, or publisher code.

Resource: PublisherProfile

The values in the publisher profile are supplied by the publisher. All fields are not filterable unless stated otherwise.

JSON representation 
{
  "name": string,
  "displayName": string,
  "domains": [
    string
  ],
  "mobileApps": [
    {
      object (PublisherProfileMobileApplication)
    }
  ],
  "logoUrl": string,
  "directDealsContact": string,
  "programmaticDealsContact": string,
  "mediaKitUrl": string,
  "samplePageUrl": string,
  "overview": string,
  "pitchStatement": string,
  "topHeadlines": [
    string
  ],
  "audienceDescription": string,
  "isParent": boolean,
  "publisherCode": string
}
Fields
name

string

Name of the publisher profile. Format: buyers/{buyer}/publisherProfiles/{publisherProfile}
displayName

string

Display name of the publisher profile. Can be used to filter the response of the publisherProfiles.list method.
domains[]

string

The list of domains represented in this publisher profile. Empty if this is a parent profile. These are top private domains, meaning that these will not contain a string like "photos.google.co.uk/123", but will instead contain "google.co.uk". Can be used to filter the response of the publisherProfiles.list method.
mobileApps[]

object (PublisherProfileMobileApplication)

The list of apps represented in this publisher profile. Empty if this is a parent profile.
logoUrl

string

A Google public URL to the logo for this publisher profile. The logo is stored as a PNG, JPG, or GIF image.
directDealsContact

string

Contact information for direct reservation deals. This is free text entered by the publisher and may include information like names, phone numbers and email addresses.
programmaticDealsContact

string

Contact information for programmatic deals. This is free text entered by the publisher and may include information like names, phone numbers and email addresses.
mediaKitUrl

string

URL to additional marketing and sales materials.
samplePageUrl

string

URL to a sample content page.
overview

string

Overview of the publisher.
pitchStatement

string

Statement explaining what's unique about publisher's business, and why buyers should partner with the publisher.
topHeadlines[]

string

Up to three key metrics and rankings. For example, "#1 Mobile News Site for 20 Straight Months".
audienceDescription

string

Description on the publisher's audience.
isParent

boolean

Indicates if this profile is the parent profile of the seller. A parent profile represents all the inventory from the seller, as opposed to child profile that is created to brand a portion of inventory. One seller has only one parent publisher profile, and can have multiple child profiles. See https://support.google.com/admanager/answer/6035806 for details. Can be used to filter the response of the publisherProfiles.list method by setting the filter to "isParent: true".
publisherCode

string

A unique identifying code for the seller. This value is the same for all of the seller's parent and child publisher profiles. Can be used to filter the response of the publisherProfiles.list method.

PublisherProfileMobileApplication

A mobile application that contains a external app ID, name, and app store.

JSON representation 
{
  "externalAppId": string,
  "name": string,
  "appStore": enum (AppStoreType)
}
Fields
externalAppId

string

The external ID for the app from its app store. Can be used to filter the response of the publisherProfiles.list method.
name

string

The name of the app.
appStore

enum (AppStoreType)

The app store the app belongs to. Can be used to filter the response of the publisherProfiles.list method.

AppStoreType

The types of mobile application stores.

Enums
APP_STORE_TYPE_UNSPECIFIED A placeholder for an unknown app store.
APPLE_ITUNES Apple iTunes
GOOGLE_PLAY Google Play
ROKU Roku
AMAZON_FIRE_TV Amazon Fire TV
PLAYSTATION PlayStation
XBOX Xbox
SAMSUNG_TV Samsung TV
AMAZON Amazon Appstore
OPPO OPPO App Market
SAMSUNG Samsung Galaxy Store
VIVO VIVO App Store
XIAOMI Xiaomi GetApps
LG_TV LG TV

Methods

get

 Gets the requested publisher profile by name.

list

 Lists publisher profiles.