- Solicitud HTTP
- Parámetros de ruta de acceso
- Cuerpo de la solicitud
- Cuerpo de la respuesta
- Permisos de autorización
- KeywordPlanKeywordAnnotation
- KeywordAndUrlSeed
- KeywordSeed
- UrlSeed
- SiteSeed
- GenerateKeywordIdeaResult
- KeywordAnnotations
- KeywordConcept
- ConceptGroup
- KeywordPlanConceptGroupType
- Pruébala
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/v15/customers/{customerId}:generateKeywordIdeas
La URL usa la sintaxis de la transcodificación gRPC.
Parámetros de ruta de acceso
Parámetros | |
---|---|
customerId |
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 ( |
Campos | |
---|---|
geoTargetConstants[] |
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 |
Si es "true", las palabras clave para adultos se incluirán en la respuesta. El valor predeterminado es falso. |
pageToken |
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 |
pageSize |
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 |
Red de segmentación. Si no la estableces, se utilizará la Búsqueda de Google y la Red de socios. |
keywordAnnotation[] |
Las anotaciones de palabras clave que se incluirán en la respuesta. |
aggregateMetrics |
Los campos agregados que se incluirán en la respuesta. |
historicalMetricsOptions |
Las opciones de los datos de métricas históricas. |
language |
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 |
Una palabra clave y una URL específica para generar ideas, por ejemplo, automóviles y www.example.com/automóviles. |
keywordSeed |
Una palabra clave o frase para generar ideas, por ejemplo, automóviles. |
urlSeed |
Una URL específica para generar ideas, por ejemplo, www.example.com/autos. |
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 ( |
Campos | |
---|---|
results[] |
Resultados de la generación de ideas para palabras clave |
aggregateMetricResults |
Son las métricas totales de todas las ideas para palabras clave. |
nextPageToken |
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 |
totalSize |
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[] |
Se requiere al menos una palabra clave. |
url |
La URL que se rastreará para generar ideas de palabras clave. |
KeywordSeed
Palabra clave inicial
Representación JSON |
---|
{ "keywords": [ string ] } |
Campos | |
---|---|
keywords[] |
Se requiere al menos una palabra clave. |
UrlSeed
URL inicial
Representación JSON |
---|
{ "url": string } |
Campos | |
---|---|
url |
La URL que se rastreará para generar ideas de palabras clave. |
SiteSeed
Origen del sitio
Representación JSON |
---|
{ "site": string } |
Campos | |
---|---|
site |
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 ( |
Campos | |
---|---|
keywordIdeaMetrics |
Las métricas históricas de la palabra clave. |
keywordAnnotations |
Las anotaciones de la palabra clave Los datos de anotación solo se proporcionan si se solicitan. |
closeVariants[] |
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 |
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 ( |
Campos | |
---|---|
concepts[] |
Es la lista de conceptos para la palabra clave. |
KeywordConcept
Es el concepto de la palabra clave.
Representación JSON |
---|
{
"name": string,
"conceptGroup": {
object ( |
Campos | |
---|---|
name |
Es el nombre del concepto de la palabra clave en conceptGroup. |
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 ( |
Campos | |
---|---|
name |
Es el nombre del grupo de conceptos. |
type |
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. |