Method: advertisers.reachForecast.retrievePlannableUserInterests

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

HTTP-запрос

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

В URL-адресе используется синтаксис транскодирования gRPC .

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

Параметры
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 .

Планируемый интерес пользователя

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

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}