Method: customers.generateInsightsFinderReport

Crea un informe guardado que se puede ver en la herramienta Insights Finder.

Lista de errores arrojados: AuthenticationError AuthorizationError FieldError HeaderError InternalError QuotaError RangeError RequestError

Solicitud HTTP

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

La URL usa la sintaxis de la transcodificación gRPC.

Parámetros de ruta de acceso

Parámetros
customerId

string

Obligatorio. El ID del cliente.

Cuerpo de la solicitud

El cuerpo de la solicitud contiene datos con la siguiente estructura:

Representación JSON 
{
  "baselineAudience": {
    object (BasicInsightsAudience)
  },
  "specificAudience": {
    object (BasicInsightsAudience)
  },
  "customerInsightsGroup": string
}
Campos
baselineAudience

object (BasicInsightsAudience)

Obligatorio. Es un público de referencia para este informe que suele estar compuesto por todas las personas de una región.
specificAudience

object (BasicInsightsAudience)

Obligatorio. El público específico de interés para este informe. Las estadísticas del informe se basarán en atributos que sean más frecuentes en este público que en el público de referencia del informe.
customerInsightsGroup

string

El nombre del cliente para el que se planifica Este es un valor definido por el usuario.

Cuerpo de la respuesta

El mensaje de respuesta para AudienceInsightsService.GenerateInsightsFinderReport, que contiene la URL para compartir del informe.

Si se ejecuta correctamente, el cuerpo de la respuesta contendrá datos con la siguiente estructura:

Representación JSON 
{
  "savedReportUrl": string
}
Campos
savedReportUrl

string

Una URL HTTPS que proporciona un vínculo directo a la IU de Insights Finder con las entradas del informe completadas de acuerdo con la solicitud.

Permisos de autorización

Requiere el siguiente alcance de OAuth:

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

Para obtener más información, consulta la Descripción general de OAuth 2.0.

BasicInsightsAudience

Es una descripción de un público que se utiliza para solicitar estadísticas.

Representación JSON 
{
  "countryLocation": [
    {
      object (LocationInfo)
    }
  ],
  "subCountryLocations": [
    {
      object (LocationInfo)
    }
  ],
  "gender": {
    object (GenderInfo)
  },
  "ageRanges": [
    {
      object (AgeRangeInfo)
    }
  ],
  "userInterests": [
    {
      object (UserInterestInfo)
    }
  ],
  "topics": [
    {
      object (AudienceInsightsTopic)
    }
  ]
}
Campos
countryLocation[]

object (LocationInfo)

Obligatorio. Son los países de este público.
subCountryLocations[]

object (LocationInfo)

Atributos de ubicación geográfica de subpaíses. Si están presentes, cada uno de ellos debe estar incluido en uno de los países de este público.
gender

object (GenderInfo)

El género del público. Si está ausente, el público no establece restricciones por género.
ageRanges[]

object (AgeRangeInfo)

Rangos de edad del público Si está ausente, el público representa a todas las personas mayores de 18 años que coinciden con los otros atributos.
userInterests[]

object (UserInterestInfo)

Intereses del usuario que definen este público. Se admiten los públicos afines y en el mercado.
topics[]

object (AudienceInsightsTopic)

Son los temas, representados por las entidades del Gráfico de conocimiento o las categorías de productos y servicios, que les interesan a este público.

AudienceInsightsTopic

Es una entidad o categoría que representa un tema que define un público.

Representación JSON 
{

  // Union field topic can be only one of the following:
  "entity": {
    object (AudienceInsightsEntity)
  },
  "category": {
    object (AudienceInsightsCategory)
  }
  // End of list of possible types for union field topic.
}
Campos
Campo de unión topic. Un atributo de entidad o categoría Las direcciones (topic) solo pueden ser una de las siguientes opciones:
entity

object (AudienceInsightsEntity)

Una entidad del Gráfico de conocimiento
category

object (AudienceInsightsCategory)

Una categoría de producto y servicio