Method: customers.generateKeywordIdeas

Muestra una lista de ideas para palabras clave.

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

Solicitud HTTP

POST https://googleads.googleapis.com/v14/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. PUEDE usar una lista vacía para especificar todas las ubicaciones geográficas de segmentación.
includeAdultKeywords

boolean

Si es "true", las palabras clave para adultos se incluirán 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 página siguiente de resultados, usa el valor obtenido de nextPageToken en la respuesta anterior. Los campos de la solicitud deben coincidir en todas las páginas.
pageSize

integer

Cantidad de resultados para recuperar en una sola página. Se puede mostrar un máximo de 10,000 resultados; si el pageSize supera este valor, se ignorará. 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 muestran. 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 la estableces, se utilizará la Búsqueda de Google y la Red de socios.
keywordAnnotation[]

enum (KeywordPlanKeywordAnnotation)

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 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.
Campo de unión seed. Es el tipo de origen para generar ideas para 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 y www.example.com/automóviles.
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/autos.
siteSeed

object (SiteSeed)

Es el sitio del que se generarán 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)

Son las métricas totales 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 string 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.

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.

KeywordPlanKeywordAnnotation

Enumera las anotaciones del plan de palabras clave que se pueden solicitar.

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

KeywordAndUrlSeed

Palabra clave y origen de URL

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

string

Se requiere al menos una palabra clave.
url

string

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

KeywordSeed

Palabra clave inicial

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

string

Se requiere al menos una palabra clave.

UrlSeed

URL inicial

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

string

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

SiteSeed

Origen 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, solo se devuelve información pública.

GenerateKeywordIdeaResult

Es el resultado que se genera de las 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 GenerateKeywordIdeaResult. Consulte https://support.google.com/google-ads/answer/9342105 para ver la definición de "variantes cercanas".
text

string

Texto de la idea de palabra clave. Al igual que en las métricas históricas del plan de palabras clave, es posible que este texto no sea 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 para la palabra clave.

KeywordConcept

Es 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 concepto 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 de planes de palabras clave.

Enumeradores
UNSPECIFIED La clasificación del grupo de conceptos es diferente de “marca” o “sin marca”. Este es un bucket de captura de todas las clasificaciones que no son de las siguientes.
UNKNOWN El valor es desconocido en esta versión.
BRAND La clasificación de grupos de conceptos se basa en BRAND.
OTHER_BRANDS La clasificación de grupos de conceptos basada en BRAND no se ajusta bien a 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 grupos de conceptos no se basa en BRAND. Se devuelve para palabras clave genéricas que no tienen una asociación de marca.