- Solicitação HTTP
- Parâmetros de caminho
- Corpo da solicitação
- Corpo da resposta
- Escopos de autorização
- BasicInsightsAudience (em inglês)
- AudienceInsightsTopic
- Faça um teste
Cria um relatório salvo que pode ser acessado na ferramenta Insights Finder.
Lista de erros gerados: AuthenticationError AuthorizationError FieldError HeaderError InternalError QuotaError RangeError RequestError
Solicitação HTTP
POST https://googleads.googleapis.com/v16/customers/{customerId}:generateInsightsFinderReport
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 |
---|
{ "baselineAudience": { object ( |
Campos | |
---|---|
baselineAudience |
Obrigatório. Um público-alvo de referência para este relatório, normalmente todas as pessoas em uma região. |
specificAudience |
Obrigatório. O público-alvo específico de interesse desse relatório. Os insights do relatório vão ser baseados nos atributos mais predominantes nesse público-alvo do que no público-alvo de referência do relatório. |
customerInsightsGroup |
O nome do cliente para quem está planejado. Esse é um valor definido pelo usuário. |
Corpo da resposta
A mensagem de resposta para AudienceInsightsService.GenerateInsightsFinderReport
, contendo o URL compartilhável do relatório.
Se bem-sucedido, o corpo da resposta incluirá dados com a estrutura a seguir:
Representação JSON |
---|
{ "savedReportUrl": string } |
Campos | |
---|---|
savedReportUrl |
Um URL HTTPS que fornece um link direto para a interface do Insights Finder com as entradas do relatório preenchidas de acordo com a solicitação. |
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.
BasicInsightsAudience
Uma descrição de um público-alvo usado para solicitar insights.
Representação JSON |
---|
{ "countryLocation": [ { object ( |
Campos | |
---|---|
countryLocation[] |
Obrigatório. Os países deste público-alvo. |
subCountryLocations[] |
Atributos de localização geográfica da sub-região. Se estiver presente, cada um deles precisa estar em um dos países desse público-alvo. |
gender |
Gênero para o público. Se ausente, o público-alvo não fará a restrição por gênero. |
ageRanges[] |
Faixa etária do público-alvo. Se ausente, o público-alvo representa todas as pessoas maiores de 18 anos que correspondem aos outros atributos. |
userInterests[] |
Interesses do usuário que definem esse público-alvo. Há suporte para públicos-alvo de afinidade e no mercado. |
topics[] |
Tópicos, representados por entidades do Mapa de informações e/ou categorias de produtos e serviços, em que esse público-alvo tem interesse. |
AudienceInsightsTopic
Uma entidade ou categoria que representa um tópico que define um público-alvo.
Representação JSON |
---|
{ // Union field |
Campos | |
---|---|
Campo de união topic . Um atributo de entidade ou categoria. topic pode ser apenas de um dos tipos a seguir: |
|
entity |
Uma entidade do Mapa de informações |
category |
Uma categoria de produto e serviço |