Method: customers.generateAdGroupThemes

Devuelve una lista de grupos de anuncios sugeridos y de 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. Una lista de nombres de recursos de grupos de anuncios en los que se agruparán las palabras clave. Formato de 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 vinculaciones sugeridas de grupos de anuncios o 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

Es el texto sugerido y la vinculación entre grupos de anuncios y campañas 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 BROAD/EXACT/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 del recurso: customers/{customerId}/adGroups/{adGroupId}
suggestedCampaign

string

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

UnusableAdGroup

Es un par de campañas y grupos de anuncios que no se pudo utilizar como sugerencia de palabras clave.

Es posible que los grupos de anuncios no se puedan utilizar 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 del recurso: customers/{customerId}/adGroups/{adGroupId}
campaign

string

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