Method: customers.generateKeywordIdeas

Muestra una lista de ideas para palabras clave.

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

Solicitud HTTP

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

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 
{
  "geoTargetConstants": [
    string
  ],
  "includeAdultKeywords": boolean,
  "pageToken": string,
  "pageSize": integer,
  "keywordPlanNetwork": enum (KeywordPlanNetwork),
  "keywordAnnotation": [
    enum (KeywordPlanKeywordAnnotation)
  ],
  "aggregateMetrics": {
    object (KeywordPlanAggregateMetrics)
  },
  "historicalMetricsOptions": {
    object (HistoricalMetricsOptions)
  },
  "language": string,

  // Union field seed can be only one of the following:
  "keywordAndUrlSeed": {
    object (KeywordAndUrlSeed)
  },
  "keywordSeed": {
    object (KeywordSeed)
  },
  "urlSeed": {
    object (UrlSeed)
  },
  "siteSeed": {
    object (SiteSeed)
  }
  // End of list of possible types for union field seed.
}
Campos
geoTargetConstants[]

string

Los nombres de recursos de la ubicación a la que se orientará. El máximo es 10. Se PUEDE usar una lista vacía para especificar todas las ubicaciones geográficas de segmentación.
includeAdultKeywords

boolean

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

string

El token de la página que se recuperará. Si no se especifica, se mostrará la primera página de resultados. Para solicitar la siguiente página de resultados, usa el valor obtenido de nextPageToken en la respuesta anterior. Los campos de solicitud deben coincidir en todas las páginas.
pageSize

integer

Cantidad de resultados que se deben recuperar en una sola página. Se pueden mostrar un máximo de 10,000 resultados. Si el valor de pageSize supera esta cantidad, se ignora. Si no se especifica, se mostrarán 10,000 resultados como máximo. El servidor puede decidir limitar aún más la cantidad de recursos que se devuelven. Si la respuesta contiene menos de 10,000 resultados, es posible que no se considere como la última página de resultados.
keywordPlanNetwork

enum (KeywordPlanNetwork)

Red de segmentación. Si no se establece, se utilizará la Red de Búsqueda y socios de Google.
keywordAnnotation[]

enum (KeywordPlanKeywordAnnotation)

Son las anotaciones de palabras clave que se incluirán en la respuesta.
aggregateMetrics

object (KeywordPlanAggregateMetrics)

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

object (HistoricalMetricsOptions)

Las opciones para los datos históricos de las métricas.
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.
Campo de unión seed. Es el tipo de valor inicial para generar ideas de palabras clave. Las direcciones (seed) solo pueden ser una de las siguientes opciones:
keywordAndUrlSeed

object (KeywordAndUrlSeed)

Una palabra clave y una URL específica para generar ideas, por ejemplo, automóviles, www.example.com/autos.
keywordSeed

object (KeywordSeed)

Una palabra clave o frase para generar ideas, por ejemplo, automóviles.
urlSeed

object (UrlSeed)

Una URL específica para generar ideas, por ejemplo, www.example.com/automóviles.
siteSeed

object (SiteSeed)

Es el sitio desde el que se generan ideas, por ejemplo, www.example.com.

Cuerpo de la respuesta

Mensaje de respuesta para KeywordPlanIdeaService.GenerateKeywordIdeas.

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

Representación JSON 
{
  "results": [
    {
      object (GenerateKeywordIdeaResult)
    }
  ],
  "aggregateMetricResults": {
    object (KeywordPlanAggregateMetricResults)
  },
  "nextPageToken": string,
  "totalSize": string
}
Campos
results[]

object (GenerateKeywordIdeaResult)

Resultados de la generación de ideas para palabras clave.
aggregateMetricResults

object (KeywordPlanAggregateMetricResults)

Las métricas agregadas de todas las ideas para palabras clave.
nextPageToken

string

Es el token de paginación que se usa para recuperar la siguiente página de resultados. Pasa el contenido de esta cadena como el atributo pageToken de la siguiente solicitud. No se muestra nextPageToken para la última página.
totalSize

string (int64 format)

Cantidad total de resultados disponibles.

Alcances 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.

KeywordPlanKeywordAnnotation

Enumera las anotaciones de planes de palabras clave que se pueden solicitar.

Enumeraciones
UNSPECIFIED No se especifica.
UNKNOWN El valor es desconocido en esta versión.
KEYWORD_CONCEPT Muestra los datos del concepto de palabra clave y del grupo de conceptos.

KeywordAndUrlSeed

Palabra clave y URL inicial

Representación JSON 
{
  "keywords": [
    string
  ],
  "url": string
}
Campos
keywords[]

string

Se requiere, al menos, una palabra clave.
url

string

Es la URL que se rastreará para generar ideas de palabras clave.

KeywordSeed

Semilla de palabras clave

Representación JSON 
{
  "keywords": [
    string
  ]
}
Campos
keywords[]

string

Se requiere, al menos, una palabra clave.

UrlSeed

Origen de la URL

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

string

La URL que se rastreará a fin de generar ideas para palabras clave.

SiteSeed

Semilla del sitio

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

string

Es el nombre de dominio del sitio. Si el cliente que solicita las ideas no es propietario del sitio proporcionado, solo se muestra información pública.

GenerateKeywordIdeaResult

Es el resultado de generar ideas para palabras clave.

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

object (KeywordPlanHistoricalMetrics)

Las métricas históricas de la palabra clave.
keywordAnnotations

object (KeywordAnnotations)

Las anotaciones de la palabra clave. Los datos de anotación solo se proporcionan si se solicitan.
closeVariants[]

string

Es la lista de variantes cercanas de las palabras clave solicitadas que se combinan en este GenerateKeywordIdeaResult. Consulta https://support.google.com/google-ads/answer/9342105 para conocer la definición de "variantes similares".
text

string

Texto de la idea para palabra clave Al igual que en las métricas históricas del plan de palabras clave, este texto no puede ser una palabra clave real, sino la forma canónica de varias palabras clave. Consulta el mensaje KeywordPlanKeywordHistoricalMetrics en KeywordPlanService.

KeywordAnnotations

Las anotaciones de las palabras clave del plan de palabras clave

Representación JSON 
{
  "concepts": [
    {
      object (KeywordConcept)
    }
  ]
}
Campos
concepts[]

object (KeywordConcept)

Es la lista de conceptos de la palabra clave.

KeywordConcept

El concepto de la palabra clave

Representación JSON 
{
  "name": string,
  "conceptGroup": {
    object (ConceptGroup)
  }
}
Campos
name

string

Es el nombre del concepto de la palabra clave en conceptGroup.
conceptGroup

object (ConceptGroup)

Es el grupo de conceptos de los detalles del concepto.

ConceptGroup

Es el grupo de conceptos del concepto de palabra clave.

Representación JSON 
{
  "name": string,
  "type": enum (KeywordPlanConceptGroupType)
}
Campos
name

string

Es el nombre del grupo de conceptos.
type

enum (KeywordPlanConceptGroupType)

Es el tipo de grupo de conceptos.

KeywordPlanConceptGroupType

Enumera los tipos de grupos de conceptos del plan de palabras clave.

Enumeraciones
UNSPECIFIED La clasificación de grupo de conceptos es diferente de la de marca/sin marca. Este es un bucket de captura general para todas las clasificaciones que no se incluyen en las siguientes opciones.
UNKNOWN El valor es desconocido en esta versión.
BRAND La clasificación de grupo de conceptos se basa en BRAND.
OTHER_BRANDS La clasificación de grupos de conceptos basada en BRAND, que no encajaba bien con las clasificaciones de BRAND Por lo general, son valores atípicos y pueden tener muy pocas palabras clave en este tipo de clasificación.
NON_BRAND Esta clasificación de grupo de conceptos no se basa en BRAND. Este valor se muestra para las palabras clave genéricas que no tienen una asociación de marca.