Authorized Buyers Marketplace API . buyers . publisherProfiles

Instance Methods

close()

Close httplib2 connections.

get(name, x__xgafv=None)

Gets the requested publisher profile by name.

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists publisher profiles. The returned publisher profiles aren't in any defined order. The order of the results might change. A new publisher profile can appear in any place in the list of returned results.

list_next()

Retrieves the next page of results.

Method Details

close()
Close httplib2 connections.
get(name, x__xgafv=None)
Gets the requested publisher profile by name.

Args:
  name: string, Required. Name of the publisher profile. Format: `buyers/{buyerId}/publisherProfiles/{publisherProfileId}` (required)
  x__xgafv: string, V1 error format.
    Allowed values
      1 - v1 error format
      2 - v2 error format

Returns:
  An object of the form:

    { # The values in the publisher profile are supplied by the publisher. All fields are not filterable unless stated otherwise.
  "audienceDescription": "A String", # Description on the publisher's audience.
  "directDealsContact": "A 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.
  "displayName": "A String", # Display name of the publisher profile. Can be used to filter the response of the publisherProfiles.list method.
  "domains": [ # 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.
    "A String",
  ],
  "isParent": True or False, # 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 "is_parent: true".
  "logoUrl": "A String", # A Google public URL to the logo for this publisher profile. The logo is stored as a PNG, JPG, or GIF image.
  "mediaKitUrl": "A String", # URL to additional marketing and sales materials.
  "mobileApps": [ # The list of apps represented in this publisher profile. Empty if this is a parent profile.
    { # A mobile application that contains a external app ID, name, and app store.
      "appStore": "A String", # The app store the app belongs to. Can be used to filter the response of the publisherProfiles.list method.
      "externalAppId": "A String", # The external ID for the app from its app store. Can be used to filter the response of the publisherProfiles.list method.
      "name": "A String", # The name of the app.
    },
  ],
  "name": "A String", # Name of the publisher profile. Format: `buyers/{buyer}/publisherProfiles/{publisher_profile}`
  "overview": "A String", # Overview of the publisher.
  "pitchStatement": "A String", # Statement explaining what's unique about publisher's business, and why buyers should partner with the publisher.
  "programmaticDealsContact": "A 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.
  "publisherCode": "A 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.
  "samplePageUrl": "A String", # URL to a sample content page.
  "topHeadlines": [ # Up to three key metrics and rankings. For example, "#1 Mobile News Site for 20 Straight Months".
    "A String",
  ],
}
list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)
Lists publisher profiles. The returned publisher profiles aren't in any defined order. The order of the results might change. A new publisher profile can appear in any place in the list of returned results.

Args:
  parent: string, Required. Parent that owns the collection of publisher profiles Format: `buyers/{buyerId}` (required)
  filter: string, Optional query string using the [Cloud API list filtering] (https://developers.google.com/authorized-buyers/apis/guides/list-filters) syntax.
  pageSize: integer, Requested page size. The server may return fewer results than requested. If requested more than 500, the server will return 500 results per page. If unspecified, the server will pick a default page size of 100.
  pageToken: string, The page token as returned from a previous ListPublisherProfilesResponse.
  x__xgafv: string, V1 error format.
    Allowed values
      1 - v1 error format
      2 - v2 error format

Returns:
  An object of the form:

    { # Response message for profiles visible to the buyer.
  "nextPageToken": "A String", # Token to fetch the next page of results.
  "publisherProfiles": [ # The list of matching publisher profiles.
    { # The values in the publisher profile are supplied by the publisher. All fields are not filterable unless stated otherwise.
      "audienceDescription": "A String", # Description on the publisher's audience.
      "directDealsContact": "A 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.
      "displayName": "A String", # Display name of the publisher profile. Can be used to filter the response of the publisherProfiles.list method.
      "domains": [ # 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.
        "A String",
      ],
      "isParent": True or False, # 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 "is_parent: true".
      "logoUrl": "A String", # A Google public URL to the logo for this publisher profile. The logo is stored as a PNG, JPG, or GIF image.
      "mediaKitUrl": "A String", # URL to additional marketing and sales materials.
      "mobileApps": [ # The list of apps represented in this publisher profile. Empty if this is a parent profile.
        { # A mobile application that contains a external app ID, name, and app store.
          "appStore": "A String", # The app store the app belongs to. Can be used to filter the response of the publisherProfiles.list method.
          "externalAppId": "A String", # The external ID for the app from its app store. Can be used to filter the response of the publisherProfiles.list method.
          "name": "A String", # The name of the app.
        },
      ],
      "name": "A String", # Name of the publisher profile. Format: `buyers/{buyer}/publisherProfiles/{publisher_profile}`
      "overview": "A String", # Overview of the publisher.
      "pitchStatement": "A String", # Statement explaining what's unique about publisher's business, and why buyers should partner with the publisher.
      "programmaticDealsContact": "A 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.
      "publisherCode": "A 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.
      "samplePageUrl": "A String", # URL to a sample content page.
      "topHeadlines": [ # Up to three key metrics and rankings. For example, "#1 Mobile News Site for 20 Straight Months".
        "A String",
      ],
    },
  ],
}
list_next()
Retrieves the next page of results.

        Args:
          previous_request: The request for the previous page. (required)
          previous_response: The response from the request for the previous page. (required)

        Returns:
          A request object that you can call 'execute()' on to request the next
          page. Returns None if there are no more items in the collection.