Method: customers.generateAdGroupThemes

Muestra una lista de grupos de anuncios sugeridos 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/v16/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. Es una lista de nombres de recursos de los grupos de anuncios en los que se agruparán las palabras clave. Formato del nombre del 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 combinaciones sugeridas de grupos de anuncios y palabras clave.
unusableAdGroups[]

object (UnusableAdGroup)

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

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.

AdGroupKeywordSuggestion

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

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

string

Es el texto original de la palabra clave.
suggestedKeywordText

string

Es la versión normalizada de keywordText para las sugerencias de concordancia amplia, exacta o de frase.
suggestedMatchType

enum (KeywordMatchType)

El tipo de concordancia de palabras clave sugerido.
suggestedAdGroup

string

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

string

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

UnusableAdGroup

Un par de grupo de anuncios/campaña que no se pudo usar como sugerencia para palabras clave.

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

  • Pertenece a una campaña que no está HABILITADA ni PAUSADA.
  • 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

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