- Solicitação HTTP
- Parâmetros de caminho
- Corpo da solicitação
- Corpo da resposta
- Escopos de autorização
- AdGroupKeywordSuggestion
- UnusableAdGroup
- Faça um teste
Mostra uma lista de grupos de anúncios sugeridos e das 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/v16/customers/{customerId}:generateAdGroupThemes
O URL usa a sintaxe de transcodificação gRPC.
Parâmetros de caminho
Parâmetros | |
---|---|
customerId |
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[] |
Obrigatório. Uma lista de palavras-chave a serem agrupadas nos grupos de anúncios fornecidos. |
adGroups[] |
Obrigatório. Uma lista de nomes de recursos de grupos de anúncios em que as palavras-chave serão agrupadas. Formato do nome do recurso: |
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 ( |
Campos | |
---|---|
adGroupKeywordSuggestions[] |
Uma lista de pares sugeridos de grupo de anúncios/palavra-chave. |
unusableAdGroups[] |
Uma lista de grupos de anúncios fornecidos que não podem 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 ( |
Campos | |
---|---|
keywordText |
O texto original da palavra-chave. |
suggestedKeywordText |
A versão normalizada de keywordText para sugestões AMPLA/EXATA/DE FRASE. |
suggestedMatchType |
O tipo de correspondência de palavra-chave sugerido. |
suggestedAdGroup |
O grupo de anúncios sugerido para a palavra-chave. Formato do nome do recurso: |
suggestedCampaign |
A campanha sugerida para a palavra-chave. Formato do nome do recurso: |
UnusableAdGroup
Um par de grupo de anúncios/campanha que não pode ser usado como uma sugestão de palavras-chave.
Grupos de anúncios podem não ser utilizáveis se o grupo de anúncios
- pertence a uma campanha que não está ATIVADA ou PAUSADA
- não está ATIVADO
Representação JSON |
---|
{ "adGroup": string, "campaign": string } |
Campos | |
---|---|
adGroup |
O nome do recurso do grupo de anúncios. Formato do nome do recurso: |
campaign |
O nome do recurso da campanha. Formato do nome do recurso: |