Method: customers.generateInsightsFinderReport

Creates a saved report that can be viewed in the Insights Finder tool.

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

HTTP request

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

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 
{
  "baselineAudience": {
    object (BasicInsightsAudience)
  },
  "specificAudience": {
    object (BasicInsightsAudience)
  },
  "customerInsightsGroup": string
}
Fields
baselineAudience

object (BasicInsightsAudience)

Required. A baseline audience for this report, typically all people in a region.
specificAudience

object (BasicInsightsAudience)

Required. The specific audience of interest for this report. The insights in the report will be based on attributes more prevalent in this audience than in the report's baseline audience.
customerInsightsGroup

string

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

Response body

The response message for AudienceInsightsService.GenerateInsightsFinderReport, containing the shareable URL for the report.

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

JSON representation 
{
  "savedReportUrl": string
}
Fields
savedReportUrl

string

An HTTPS URL providing a deep link into the Insights Finder UI with the report inputs filled in according to the request.

Authorization scopes

Requires the following OAuth scope:

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

For more information, see the OAuth 2.0 Overview.