Method: customers.generateKeywordIdeas

Retorna uma lista de ideias de palavras-chave.

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

Solicitação HTTP

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

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

Parâmetros de caminho

Parâmetros
customerId

string

O ID do cliente com a recomendação.

Corpo da solicitação

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

Representação JSON 
{
  "geoTargetConstants": [
    string
  ],
  "includeAdultKeywords": boolean,
  "pageToken": string,
  "pageSize": integer,
  "keywordPlanNetwork": enum (KeywordPlanNetwork),
  "keywordAnnotation": [
    enum (KeywordPlanKeywordAnnotation)
  ],
  "aggregateMetrics": {
    object (KeywordPlanAggregateMetrics)
  },
  "historicalMetricsOptions": {
    object (HistoricalMetricsOptions)
  },
  "language": string,

  // Union field seed can be only one of the following:
  "keywordAndUrlSeed": {
    object (KeywordAndUrlSeed)
  },
  "keywordSeed": {
    object (KeywordSeed)
  },
  "urlSeed": {
    object (UrlSeed)
  },
  "siteSeed": {
    object (SiteSeed)
  }
  // End of list of possible types for union field seed.
}
Campos
geoTargetConstants[]

string

Os nomes de recursos do local a ser segmentado. O máximo é 10. Uma lista vazia PODE ser usada para especificar todas as áreas geográficas de segmentação.
includeAdultKeywords

boolean

Se verdadeiro, palavras-chave de conteúdo adulto serão incluídas na resposta. O valor padrão é falso.
pageToken

string

Token da página a ser recuperada. Se não for especificado, a primeira página de resultados será retornada. Para solicitar a próxima página de resultados, use o valor extraído de nextPageToken na resposta anterior. Os campos de solicitação precisam ser correspondentes nas páginas.
pageSize

integer

Número de resultados a serem recuperados em uma única página. Um máximo de 10.000 resultados pode ser retornado. Se o pageSize exceder esse valor, ele será ignorado. Se não for especificado, no máximo 10.000 resultados serão retornados. O servidor pode decidir limitar ainda mais o número de recursos retornados. Se a resposta tiver menos de 10.000 resultados,ela não poderá ser considerada como a última página de resultados.
keywordPlanNetwork

enum (KeywordPlanNetwork)

Rede de segmentação. Se não for definido, a rede de parceiros e de pesquisa do Google será usada.
keywordAnnotation[]

enum (KeywordPlanKeywordAnnotation)

As anotações de palavra-chave a serem incluídas na resposta.
aggregateMetrics

object (KeywordPlanAggregateMetrics)

Os campos agregados a serem incluídos na resposta.
historicalMetricsOptions

object (HistoricalMetricsOptions)

As opções para dados históricos de métricas.
language

string

O nome do recurso do idioma a ser segmentado. Cada palavra-chave pertence a um conjunto de idiomas; uma palavra-chave é incluída se o idioma é um de seus idiomas. Se não for definido, todas as palavras-chave serão incluídas.
Campo de união seed. O tipo de semente para gerar ideias de palavras-chave. seed pode ser apenas de um dos tipos a seguir:
keywordAndUrlSeed

object (KeywordAndUrlSeed)

Uma palavra-chave e um URL específico para gerar ideias, por exemplo, carros, www.example.com/carros.
keywordSeed

object (KeywordSeed)

Uma palavra-chave ou frase para gerar ideias, por exemplo, carros.
urlSeed

object (UrlSeed)

Um URL específico para gerar ideias, por exemplo, www.example.com/cars.
siteSeed

object (SiteSeed)

O site do qual gerar ideias, por exemplo, www.example.com.

Corpo da resposta

Mensagem de resposta para KeywordPlanIdeaService.GenerateKeywordIdeas.

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

Representação JSON 
{
  "results": [
    {
      object (GenerateKeywordIdeaResult)
    }
  ],
  "aggregateMetricResults": {
    object (KeywordPlanAggregateMetricResults)
  },
  "nextPageToken": string,
  "totalSize": string
}
Campos
results[]

object (GenerateKeywordIdeaResult)

Resultados da geração de ideias de palavras-chave.
aggregateMetricResults

object (KeywordPlanAggregateMetricResults)

As métricas agregadas para todas as ideias de palavras-chave.
nextPageToken

string

Token de paginação usado para recuperar a próxima página de resultados. Transmita o conteúdo dessa string como o atributo pageToken da próxima solicitação. nextPageToken não é retornado para a última página.
totalSize

string (int64 format)

Número total de resultados disponíveis.

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.

KeywordPlanKeywordAnnotation

Enumera as anotações do plano de palavras-chave que podem ser solicitadas.

Enums
UNSPECIFIED Não especificado.
UNKNOWN O valor é desconhecido nesta versão.
KEYWORD_CONCEPT Retorna o conceito de palavra-chave e os dados do grupo de conceito.

KeywordAndUrlSeed

Semente de palavra-chave e URL

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

string

Requer pelo menos uma palavra-chave.
url

string

O URL que será rastreado para gerar ideias de palavras-chave.

KeywordSeed

Semente de palavra-chave

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

string

Requer pelo menos uma palavra-chave.

UrlSeed

Semente de URL

Representação JSON 
{
  "url": string
}
Campos
url

string

O URL que será rastreado para gerar ideias de palavras-chave.

SiteSeed

Semente do site

Representação JSON 
{
  "site": string
}
Campos
site

string

O nome de domínio do site. Se o cliente que está solicitando as ideias não for o proprietário do site, somente informações públicas serão retornadas.

GenerateKeywordIdeaResult

O resultado da geração de ideias de palavras-chave.

Representação JSON 
{
  "keywordIdeaMetrics": {
    object (KeywordPlanHistoricalMetrics)
  },
  "keywordAnnotations": {
    object (KeywordAnnotations)
  },
  "closeVariants": [
    string
  ],
  "text": string
}
Campos
keywordIdeaMetrics

object (KeywordPlanHistoricalMetrics)

O histórico de métricas da palavra-chave.
keywordAnnotations

object (KeywordAnnotations)

As anotações da palavra-chave. Os dados da anotação são fornecidos apenas se solicitados.
closeVariants[]

string

A lista de variantes aproximadas das palavras-chave solicitadas que são combinadas nesse GenerateKeywordIdeaResult. Acesse https://support.google.com/google-ads/answer/9342105 para conferir a definição de "variantes aproximadas".
text

string

Texto da ideia de palavra-chave. Assim como nas métricas históricas do plano de palavras-chave, esse texto pode não ser uma palavra-chave real, mas a forma canônica de várias palavras-chave. Consulte a mensagem KeywordPlanKeywordHistoryMetrics no KeywordPlanService.

KeywordAnnotations

As anotações das palavras-chave do plano de palavras-chave.

Representação JSON 
{
  "concepts": [
    {
      object (KeywordConcept)
    }
  ]
}
Campos
concepts[]

object (KeywordConcept)

Lista de conceitos da palavra-chave.

KeywordConcept

O conceito da palavra-chave.

Representação JSON 
{
  "name": string,
  "conceptGroup": {
    object (ConceptGroup)
  }
}
Campos
name

string

O nome do conceito da palavra-chave no conceitoGroup.
conceptGroup

object (ConceptGroup)

O grupo conceitual dos detalhes do conceito.

ConceptGroup

O grupo para o conceito de palavra-chave.

Representação JSON 
{
  "name": string,
  "type": enum (KeywordPlanConceptGroupType)
}
Campos
name

string

O nome do grupo de conceitos.
type

enum (KeywordPlanConceptGroupType)

O tipo de grupo conceitual.

KeywordPlanConceptGroupType

Enumera os tipos de grupos conceituais de planos de palavras-chave.

Enums
UNSPECIFIED A classificação do grupo conceitual é diferente de marca/sem marca. Esse é um bucket abrangente para todas as classificações que não estão nas seguintes opções.
UNKNOWN O valor é desconhecido nesta versão.
BRAND A classificação do grupo de conceitos é baseada em BRAND.
OTHER_BRANDS A classificação do grupo de conceitos com base em BRAND, que não se encaixava bem com as classificações de BRAND. Geralmente, são outliers e podem ter pouquíssimas palavras-chave nesse tipo de classificação.
NON_BRAND Essa classificação de grupos de conceitos não é baseada em BRAND. É retornado para palavras-chave genéricas que não têm uma associação de marca.