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/v15/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 mostrará "auto". Se puede usar un máximo de 10,000 palabras clave.
includeAdultKeywords

boolean

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

string

Los nombres de 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 de 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 agregados que se incluirán en la respuesta.
historicalMetricsOptions

object (HistoricalMetricsOptions)

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

string

Es el nombre del recurso del idioma de destino. Cada palabra clave pertenece a un conjunto de idiomas. Se incluye una palabra clave 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)

Son las métricas totales 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 eliminamos la duplicación de su lista de palabras clave, lo que elimina las variantes cercanas antes de mostrar las palabras clave como texto. Por ejemplo, si originalmente tu solicitud contenía las palabras clave "auto" y "autos", la búsqueda resultante solo contendrá "autos". La lista de consultas anuladas se incluirá en el campo closeVariants.