Method: advertisers.reachForecast.retrievePlannableUserInterests

Получает сегменты аудитории Google (интересы пользователей), доступные для прогнозирования.

HTTP-запрос

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

URL имеет синтаксис gRPC Transcoding.

Параметры пути

Параметры
advertiserId

string (int64 format)

Обязательно. Идентификатор рекламодателя, для которого нужно получить список интересов пользователей, доступных для планирования.

Параметры запроса

Параметры
productCategory

enum (PlannableProductCategory)

Обязательно. Категория товаров, для которой нужно получить интересы пользователей, доступные для планирования.

Тело запроса

Тело запроса должно быть пустым.

Тело ответа

Ответ для reachForecast.retrievePlannableUserInterests.

Ниже приведена структура данных в ответе, полученном на запрос.

JSON-представление 
{
  "plannableUserInterests": [
    {
      object (PlannableUserInterest)
    }
  ]
}
Поля
plannableUserInterests[]

object (PlannableUserInterest)

Список сегментов аудитории Google, доступных для планирования.

Области авторизации

Требуется следующая область действия OAuth:

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

Дополнительную информацию вы найдете в OAuth 2.0 Overview.

PlannableUserInterest

Интерес пользователя, который можно использовать для таргетинга.

JSON-представление 
{
  "userInterestDisplayName": string,
  "userInterestPath": string,
  "userInterestType": string,
  "userInterest": {
    object (UserInterest)
  }
}
Поля
userInterestDisplayName

string

Только для вывода. Отображаемое название интереса, например "Любители активного отдыха".
userInterestPath

string

Только для вывода. Путь к категории интереса.
userInterestType

string

Только для вывода. Тип аудитории, например AFFINITY (аудитория по интересам) или IN_MARKET (заинтересованные покупатели).
userInterest

object (UserInterest)

Только для вывода. Идентификатор интереса пользователя.

Поле, которое будет заполнено в объекте, зависит от значения [productCategory][], указанного в запросе.

  • [userInterestCategory][] заполняется для YouTube.
  • Поле [userInterestUserList][] заполняется для открытых аукционов.

Категория интересов пользователей

Идентификатор интереса пользователя.

JSON-представление 
{
  "userInterestCategory": string,
  "userInterestUserList": string
}
Поля
userInterestCategory

string

Только для вывода. Название ресурса категории интересов. Заполняется, если в поле productCategory указано значение Youtube. Формат: customers/{customerId}/userInterests/{user_interest_id}
userInterestUserList

string

Только для вывода. Название ресурса списка пользователей. Заполняется, если в поле productCategory указано значение "Открытый аукцион". Формат: customers/{customerId}/userLists/{user_list_id}