Method: customers.generateKeywordHistoricalMetrics

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

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

Solicitud HTTP

POST https://googleads.googleapis.com/v16/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

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

boolean

Si es "true", 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 a la que se orientará El máximo es 10. PUEDE usar una lista vacía para especificar todas las ubicaciones geográficas para la segmentación.
keywordPlanNetwork

enum (KeywordPlanNetwork)

Red de segmentación. Si no la estableces, se utilizará la Búsqueda de Google y la Red de socios.
aggregateMetrics

object (KeywordPlanAggregateMetrics)

Los campos de agregación que se incluirán en la respuesta.
historicalMetricsOptions

object (HistoricalMetricsOptions)

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

string

El nombre del recurso del idioma de destino. Cada palabra clave pertenece a un conjunto de idiomas; una palabra clave se incluye si el idioma es uno de sus idiomas. Si no la estableces, 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)

Lista de palabras clave y sus métricas históricas.
aggregateMetricResults

object (KeywordPlanAggregateMetricResults)

Las métricas globales 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 la Descripción general de OAuth 2.0.

GenerateKeywordHistoricalMetricsResult

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 GenerateKeywordHistoricalMetricsResult.
keywordMetrics

object (KeywordPlanHistoricalMetrics)

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

string

El texto de la búsqueda asociado con una o más palabras clave. Tenga en cuenta que eliminaremos las duplicaciones de su lista de palabras clave y eliminaremos las variantes cercanas antes de mostrar las palabras clave como texto. Por ejemplo, si tu solicitud originalmente contenía las palabras clave "auto" y "automóviles", la búsqueda que se mostrará solo incluirá "autos". La lista de consultas con anulación de duplicación se incluirá en el campo closeVariants.