Method: customers.generateAdGroupThemes

Muestra una lista de grupos de anuncios y modificaciones sugeridas (texto, tipo de concordancia) para las palabras clave determinadas.

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

Solicitud HTTP

POST https://googleads.googleapis.com/v14/customers/{customerId}:generateAdGroupThemes

La URL usa la sintaxis de la transcodificación gRPC.

Parámetros de ruta de acceso

Parámetros
customerId

string

Obligatorio. El ID del cliente.

Cuerpo de la solicitud

El cuerpo de la solicitud contiene datos con la siguiente estructura:

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

string

Obligatorio. Una lista de palabras clave para agrupar en los grupos de anuncios proporcionados.
adGroups[]

string

Obligatorio. Una lista de nombres de recursos de grupos de anuncios para agrupar palabras clave. Formato de nombre de recurso: customers/{customerId}/adGroups/{adGroupId}

Cuerpo de la respuesta

Mensaje de respuesta para KeywordPlanIdeaService.GenerateAdGroupThemes.

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

Representación JSON 
{
  "adGroupKeywordSuggestions": [
    {
      object (AdGroupKeywordSuggestion)
    }
  ],
  "unusableAdGroups": [
    {
      object (UnusableAdGroup)
    }
  ]
}
Campos
adGroupKeywordSuggestions[]

object (AdGroupKeywordSuggestion)

Una lista de vinculaciones sugeridas para grupos de anuncios/palabras clave.
unusableAdGroups[]

object (UnusableAdGroup)

Es una lista de los grupos de anuncios proporcionados que no se pudieron utilizar como sugerencias.

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.

AdGroupKeywordSuggestion

El texto sugerido y la vinculación del grupo de anuncios y la campaña para una palabra clave determinada.

Representación JSON 
{
  "keywordText": string,
  "suggestedKeywordText": string,
  "suggestedMatchType": enum (KeywordMatchType),
  "suggestedAdGroup": string,
  "suggestedCampaign": string
}
Campos
keywordText

string

El texto original de la palabra clave
suggestedKeywordText

string

Es la versión normalizada de keywordText para sugerencias de AMP, EXACTA y DE PHRASE.
suggestedMatchType

enum (KeywordMatchType)

Es el tipo de concordancia de palabras clave sugerido.
suggestedAdGroup

string

Es el grupo de anuncios sugerido para la palabra clave. Formato de nombre de recurso: customers/{customerId}/adGroups/{adGroupId}
suggestedCampaign

string

La campaña sugerida para la palabra clave. Formato de nombre de recurso: customers/{customerId}/campaigns/{campaignId}

UnusableAdGroup

Es un par de grupos de anuncios/campaña que no se ha podido utilizar como sugerencia de palabras clave.

Es posible que los grupos de anuncios no puedan utilizarse si el grupo de anuncios

  • pertenece a una campaña que no está HABILITADA ni DETENIDA
  • no está HABILITADA
Representación JSON 
{
  "adGroup": string,
  "campaign": string
}
Campos
adGroup

string

Es el nombre del recurso del grupo de anuncios. Formato de nombre de recurso: customers/{customerId}/adGroups/{adGroupId}
campaign

string

Es el nombre del recurso de la campaña. Formato de nombre de recurso: customers/{customerId}/campaigns/{campaignId}