Method: customers.generateKeywordHistoricalMetrics

Muestra una lista de métricas históricas de palabras clave.

Lista de errores generados: AuthenticationError AuthorizationError CollectionSizeError HeaderError InternalError QuotaError RequestError

Solicitud HTTP

POST https://googleads.googleapis.com/v18/customers/{customerId}:generateKeywordHistoricalMetrics

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

Parámetros de ruta de acceso

Parámetros
customerId

string

El ID del cliente con la recomendación.

Cuerpo de la solicitud

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

Representación JSON 
{
  "keywords": [
    string
  ],
  "includeAdultKeywords": boolean,
  "geoTargetConstants": [
    string
  ],
  "keywordPlanNetwork": enum (KeywordPlanNetwork),
  "aggregateMetrics": {
    object (KeywordPlanAggregateMetrics)
  },
  "historicalMetricsOptions": {
    object (HistoricalMetricsOptions)
  },
  "language": string
}
Campos
keywords[]

string

Es una lista de palabras clave para obtener métricas históricas. No se mostrarán todas las entradas como resultado de la anulación de duplicación casi exacta. Por ejemplo, si se solicitan estadísticas para "auto" y "autos", solo se mostrará "auto". Se puede usar un máximo de 10,000 palabras clave.
includeAdultKeywords

boolean

Si es verdadero, se incluirán palabras clave para adultos en la respuesta. El valor predeterminado es falso.
geoTargetConstants[]

string

Los nombres de los recursos de la ubicación de segmentación El máximo es 10. SE PUEDE usar una lista vacía para especificar todas las ubicaciones geográficas de segmentación.
keywordPlanNetwork

enum (KeywordPlanNetwork)

Red de segmentación. Si no se establece, se usará la red de socios y la Búsqueda de Google.
aggregateMetrics

object (KeywordPlanAggregateMetrics)

Son los campos agregados que se incluirán en la respuesta.
historicalMetricsOptions

object (HistoricalMetricsOptions)

Las opciones para los datos de métricas históricas.
language

string

Es el nombre del recurso del idioma al que se segmentará. Cada palabra clave pertenece a un conjunto de idiomas. Se incluye una palabra clave si el idioma es uno de sus idiomas. Si no se establece, se incluirán todas las palabras clave.

Cuerpo de la respuesta

Mensaje de respuesta para KeywordPlanIdeaService.GenerateKeywordHistoricalMetrics.

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

Representación JSON 
{
  "results": [
    {
      object (GenerateKeywordHistoricalMetricsResult)
    }
  ],
  "aggregateMetricResults": {
    object (KeywordPlanAggregateMetricResults)
  }
}
Campos
results[]

object (GenerateKeywordHistoricalMetricsResult)

Es la lista de palabras clave y sus métricas históricas.
aggregateMetricResults

object (KeywordPlanAggregateMetricResults)

Las métricas agregadas de todas las palabras clave

Permisos de autorización

Requiere el siguiente alcance de OAuth:

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

Para obtener más información, consulta OAuth 2.0 Overview.

GenerateKeywordHistoricalMetricsResult

Es el resultado de generar métricas históricas de palabras clave.

Representación JSON 
{
  "closeVariants": [
    string
  ],
  "keywordMetrics": {
    object (KeywordPlanHistoricalMetrics)
  },
  "text": string
}
Campos
closeVariants[]

string

Es la lista de variantes cercanas de las palabras clave solicitadas cuyas estadísticas se combinan en este GenerateKeywordHistoricalMetricsResult.
keywordMetrics

object (KeywordPlanHistoricalMetrics)

Las métricas históricas del texto y sus variantes cercanas
text

string

Es el texto de la búsqueda asociado con una o más palabras clave. Ten en cuenta que quitamos los duplicados de tu lista de palabras clave y eliminamos las variantes cercanas antes de mostrar las palabras clave como texto. Por ejemplo, si tu solicitud originalmente contenía las palabras clave "auto" y "autos", la búsqueda que se muestra solo contendrá "autos". La lista de consultas sin duplicados se incluirá en el campo closeVariants.