Method: advertisers.reachForecast.retrievePlannableUserInterests

Recupera os públicos-alvo do Google (interesses do usuário) disponíveis para estimativa.

Solicitação HTTP

GET https://displayvideo.googleapis.com/v4/advertisers/{advertiserId}/reachForecast:retrievePlannableUserInterests

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

Parâmetros de caminho

Parâmetros
advertiserId

string (int64 format)

Obrigatório. O ID do anunciante para listar os interesses do usuário planejáveis.

Parâmetros de consulta

Parâmetros
productCategory

enum (PlannableProductCategory)

Obrigatório. A categoria dos produtos para recuperar os interesses do usuário planejáveis.

Corpo da solicitação

O corpo da solicitação precisa estar vazio.

Corpo da resposta

Resposta para reachForecast.retrievePlannableUserInterests.

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

Representação JSON 
{
  "plannableUserInterests": [
    {
      object (PlannableUserInterest)
    }
  ]
}
Campos
plannableUserInterests[]

object (PlannableUserInterest)

A lista de interesses do usuário planejáveis (públicos-alvo do Google).

Escopos de autorização

Requer o seguinte escopo OAuth:

  • https://www.googleapis.com/auth/display-video

Para mais informações, consulte OAuth 2.0 Overview.

PlannableUserInterest

Um interesse do usuário planejável usado para segmentação.

Representação JSON 
{
  "userInterestDisplayName": string,
  "userInterestPath": string,
  "userInterestType": string,
  "userInterest": {
    object (UserInterest)
  }
}
Campos
userInterestDisplayName

string

Apenas saída. O nome de exibição do interesse, por exemplo, "Entusiastas de atividades ao ar livre".
userInterestPath

string

Apenas saída. O caminho da categoria do interesse.
userInterestType

string

Apenas saída. O tipo de público-alvo, por exemplo, "AFINIDADE", "NO_MERCADO".
userInterest

object (UserInterest)

Apenas saída. O identificador do interesse do usuário.

A [productCategory][] especificada na solicitação determina o campo preenchido no objeto.

  • [userInterestCategory][] é preenchido para "YouTube".
  • [userInterestUserList][] é preenchido para "Leilão aberto".

UserInterest

O identificador de um interesse do usuário.

Representação JSON 
{
  "userInterestCategory": string,
  "userInterestUserList": string
}
Campos
userInterestCategory

string

Apenas saída. O nome do recurso da categoria de interesse. Preenchido quando productCategory é "YouTube". Formato: customers/{customerId}/userInterests/{user_interest_id}
userInterestUserList

string

Apenas saída. O nome do recurso da lista de usuários. Preenchido quando productCategory é "Leilão aberto". Formato: customers/{customerId}/userLists/{user_list_id}