Method: advertisers.reachForecast.retrievePlannableUserInterests

Pobiera listy odbiorców Google (zainteresowania użytkowników) dostępne do prognozowania.

Żądanie HTTP

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

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
advertiserId

string (int64 format)

Wymagane. Identyfikator reklamodawcy, dla którego chcesz wyświetlić listę zainteresowań użytkowników, na które można kierować reklamy.

Parametry zapytania

Parametry
productCategory

enum (PlannableProductCategory)

Wymagane. Kategoria produktów, dla której chcesz pobrać możliwe do zaplanowania zainteresowania użytkowników.

Treść żądania

Treść żądania musi być pusta.

Treść odpowiedzi

Odpowiedź dla reachForecast.retrievePlannableUserInterests.

W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:

Zapis JSON 
{
  "plannableUserInterests": [
    {
      object (PlannableUserInterest)
    }
  ]
}
Pola
plannableUserInterests[]

object (PlannableUserInterest)

Lista zainteresowań użytkowników, które można uwzględnić w planowaniu (odbiorcy Google).

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Więcej informacji znajdziesz w OAuth 2.0 Overview.

PlannableUserInterest

Możliwe do zaplanowania zainteresowanie użytkownika używane do kierowania.

Zapis JSON 
{
  "userInterestDisplayName": string,
  "userInterestPath": string,
  "userInterestType": string,
  "userInterest": {
    object (UserInterest)
  }
}
Pola
userInterestDisplayName

string

Tylko dane wyjściowe. Wyświetlana nazwa zainteresowania, np. „Entuzjaści aktywności na świeżym powietrzu”.
userInterestPath

string

Tylko dane wyjściowe. Ścieżka kategorii zainteresowania.
userInterestType

string

Tylko dane wyjściowe. Typ odbiorców, np. „AFFINITY”, „IN_MARKET”.
userInterest

object (UserInterest)

Tylko dane wyjściowe. Identyfikator zainteresowania użytkownika.

Pole [productCategory][] określone w żądaniu określa pole wypełnione w obiekcie.

  • [userInterestCategory][] jest wypełniany w przypadku „YouTube”.
  • [userInterestUserList][] jest wypełniany w przypadku „aukcji otwartej”.

ZainteresowanieUżytkownika

Identyfikator zainteresowania użytkownika.

Zapis JSON 
{
  "userInterestCategory": string,
  "userInterestUserList": string
}
Pola
userInterestCategory

string

Tylko dane wyjściowe. Nazwa zasobu kategorii zainteresowań. Wypełniane, gdy productCategory ma wartość „YouTube”. Format: customers/{customerId}/userInterests/{user_interest_id}
userInterestUserList

string

Tylko dane wyjściowe. Nazwa zasobu listy użytkowników. Wypełniane, gdy productCategory ma wartość „Aukcja otwarta”. Format: customers/{customerId}/userLists/{user_list_id}