Method: customers.generateAdGroupThemes

Mostra uma lista de grupos de anúncios sugeridos e modificações sugeridas (texto, tipo de correspondência) para as palavras-chave fornecidas.

Lista de erros gerados: AuthenticationError AuthorizationError CollectionSizeError HeaderError InternalError QuotaError RequestError

Solicitação HTTP

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

O URL usa a sintaxe de transcodificação gRPC.

Parâmetros de caminho

Parâmetros
customerId

string

Obrigatório. O ID do cliente.

Corpo da solicitação

O corpo da solicitação contém dados com a seguinte estrutura:

Representação JSON 
{
  "keywords": [
    string
  ],
  "adGroups": [
    string
  ]
}
Campos
keywords[]

string

Obrigatório. Uma lista de palavras-chave a serem agrupadas nos grupos de anúncios fornecidos.
adGroups[]

string

Obrigatório. Uma lista de nomes de recursos dos grupos de anúncios nos quais as palavras-chave serão agrupadas. Formato do nome do recurso: customers/{customerId}/adGroups/{adGroupId}

Corpo da resposta

Mensagem de resposta para KeywordPlanIdeaService.GenerateAdGroupThemes.

Se bem-sucedido, o corpo da resposta incluirá dados com a estrutura a seguir:

Representação JSON 
{
  "adGroupKeywordSuggestions": [
    {
      object (AdGroupKeywordSuggestion)
    }
  ],
  "unusableAdGroups": [
    {
      object (UnusableAdGroup)
    }
  ]
}
Campos
adGroupKeywordSuggestions[]

object (AdGroupKeywordSuggestion)

Uma lista de pares sugeridos de grupo de anúncios/palavra-chave.
unusableAdGroups[]

object (UnusableAdGroup)

Uma lista de grupos de anúncios fornecidos que não puderam ser usados como sugestões.

Escopos de autorização

Requer o seguinte escopo OAuth:

  • https://www.googleapis.com/auth/adwords

Para mais informações, consulte a Visão geral do OAuth 2.0.

AdGroupKeywordSuggestion

O texto sugerido e o par de Grupo de anúncios/campanha para uma determinada palavra-chave.

Representação JSON 
{
  "keywordText": string,
  "suggestedKeywordText": string,
  "suggestedMatchType": enum (KeywordMatchType),
  "suggestedAdGroup": string,
  "suggestedCampaign": string
}
Campos
keywordText

string

O texto original da palavra-chave.
suggestedKeywordText

string

A versão normalizada de keywordText para sugestões AMPLA/EXATAS/DE FRASE.
suggestedMatchType

enum (KeywordMatchType)

O tipo de correspondência de palavra-chave sugerido.
suggestedAdGroup

string

O grupo de anúncios sugerido para a palavra-chave. Formato do nome do recurso: customers/{customerId}/adGroups/{adGroupId}
suggestedCampaign

string

A campanha sugerida para a palavra-chave. Formato do nome do recurso: customers/{customerId}/campaigns/{campaignId}

UnusableAdGroup

Um par grupo de anúncios/campanha que não pode ser usado como sugestão para palavras-chave.

Os grupos de anúncios podem não ser utilizáveis se o grupo de anúncios

  • pertence a uma campanha que não está ATIVA nem PAUSADA
  • não está ATIVADO
Representação JSON 
{
  "adGroup": string,
  "campaign": string
}
Campos
adGroup

string

O nome do recurso do grupo de anúncios. Formato do nome do recurso: customers/{customerId}/adGroups/{adGroupId}
campaign

string

O nome do recurso da campanha. Formato do nome do recurso: customers/{customerId}/campaigns/{campaignId}