customers

Changed on

Returns a collection of attributes that are represented in an audience of interest, with metrics that compare each attribute's share of the audience with its share of a baseline audience. List of thrown errors: AudienceInsightsError AuthenticationError AuthorizationError FieldError HeaderError InternalError QuotaError RangeError RequestError

post/v23/customers/{+customerId}:generateAudienceCompositionInsights

Request

  • Base URL: https://searchads360.googleapis.com
  • URL: https://searchads360.googleapis.com/v23/customers/{+customerId}:generateAudienceCompositionInsights
  • Auth: OAuth 2 (implicit, authorization URL https://accounts.google.com/o/oauth2/auth, scopes: https://www.googleapis.com/auth/doubleclicksearch) and OAuth 2 (authorization code, authorization URL https://accounts.google.com/o/oauth2/auth, token URL https://accounts.google.com/o/oauth2/token, scopes: https://www.googleapis.com/auth/doubleclicksearch)

Path parameters

customerIdstring required

Required. The ID of the customer.

Request body

customerInsightsGroupstring

The name of the customer being planned for. This is a user-defined value.

dataMonthstring

The one-month range of historical data to use for insights, in the format "yyyy-mm". If unset, insights will be returned for the last thirty days of data.

dimensionsstring[]

Required. The audience dimensions for which composition insights should be returned. Supported dimensions are KNOWLEDGE_GRAPH, GEO_TARGET_COUNTRY, SUB_COUNTRY_LOCATION, YOUTUBE_CHANNEL, YOUTUBE_LINEUP, AFFINITY_USER_INTEREST, IN_MARKET_USER_INTEREST, .

Response

Successful response

Changes

  • 3c8ec4f526ecRevision changes
    • breaking

      removed the request body

    • breaking

      removed the media type */* for the response with the status