Method: customers.generateTargetingSuggestionMetrics

Returns potential reach metrics for targetable audiences.

This method helps answer questions like "How many Men aged 18+ interested in Camping can be reached on YouTube?"

List of thrown errors: AudienceInsightsError AuthenticationError AuthorizationError FieldError HeaderError InternalError QuotaError RangeError RequestError

HTTP request

POST https://googleads.googleapis.com/v19/customers/{customerId}:generateTargetingSuggestionMetrics

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
customerId

string

Required. The ID of the customer.

Request body

The request body contains data with the following structure:

JSON representation 
{
  "audiences": [
    {
      object (BasicInsightsAudience)
    }
  ],
  "customerInsightsGroup": string
}
Fields
audiences[]

object (BasicInsightsAudience)

Required. Audiences to request metrics for.
customerInsightsGroup

string

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

Response body

Response message for AudienceInsightsService.GenerateTargetingSuggestionMetrics.

If successful, the response body contains data with the following structure:

JSON representation 
{
  "suggestions": [
    {
      object (TargetingSuggestionMetrics)
    }
  ]
}
Fields
suggestions[]

object (TargetingSuggestionMetrics)

Suggested targetable audiences. There will be one suggestion for each [GenerateTargetingSuggestionMetricsRequest.audiences] requested, matching the order requested.

Authorization scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/adwords

For more information, see the OAuth 2.0 Overview.