Method: advertisers.reachForecast.retrievePlannableProducts

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

HTTP-запрос

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

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

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

Параметры
advertiserId

string ( int64 format)

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

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

Параметры
plannableLocationId

string

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

Текст запроса

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

Ответный текст

Ответ на запрос reachForecast.retrievePlannableProducts

В случае успеха тело ответа будет содержать данные следующей структуры:

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

object ( ProductMetadata )

Только для вывода. Список метаданных продукта, демонстрирующий возможности таргетинга.

Области полномочий

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

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

Для получения более подробной информации см.OAuth 2.0 Overview .

Метаданные продукта

Метаданные для планируемого продукта.

JSON-представление 
{
  "plannableProductDescription": string,
  "plannableProductCode": string,
  "plannableTargeting": {
    object (PlannableTargeting)
  },
  "displayName": string,
  "plannableProductCoreAttributes": {
    object (PlannableProductCoreAttributes)
  }
}
Поля
plannableProductDescription

string

Только вывод. Текстовое описание рекламируемого товара.

plannableProductCode

string

Только вывод. Планируемый код продукта (например, "YOUTUBE_REACH_MIX").

plannableTargeting

object ( PlannableTargeting )

Только вывод. Возможности целевого маркетинга, доступные для данного продукта.

displayName

string

Только вывод. Название, связанное с рекламным продуктом. Например: "Видеопросмотровая кампания".

plannableProductCoreAttributes

object ( PlannableProductCoreAttributes )

Только для вывода. Основные характеристики данного продукта.

Планируемое нацеливание

Возможности целевого применения для конкретного продукта.

JSON-представление 
{
  "ageRanges": [
    enum (PlannableAgeRange)
  ],
  "surfaceTargetingCombinations": {
    object (SurfaceTargetingCombinations)
  },
  "genders": [
    enum (Gender)
  ],
  "networks": [
    enum (PlannableNetwork)
  ],
  "devices": [
    enum (DeviceType)
  ],
  "youtubeSelectLineups": [
    {
      object (YouTubeSelectLineUp)
    }
  ],
  "defaultYoutubeSelectLineup": {
    object (YouTubeSelectLineUp)
  }
}
Поля
ageRanges[]

enum ( PlannableAgeRange )

Только для вывода. Допустимые возрастные диапазоны для продукта. Фактический таргетинг рассчитывается путем сопоставления этого возрастного диапазона со стандартным возрастным таргетингом Google.

surfaceTargetingCombinations

object ( SurfaceTargetingCombinations )

Только для вывода. Целевые комбинации поверхностей для рекламного продукта.

genders[]

enum ( Gender )

Только для вывода. Целевая аудитория по полу для рекламного продукта.

networks[]

enum ( PlannableNetwork )

Только для вывода. Целевые сети для рекламного продукта.

devices[]

enum ( DeviceType )

Только для вывода. Целевые устройства для рекламного продукта.

youtubeSelectLineups[]

object ( YouTubeSelectLineUp )

Только вывод. Целевые подборки рекламных объявлений на YouTube.

defaultYoutubeSelectLineup

object ( YouTubeSelectLineUp )

Только для вывода. Стандартный список избранных видео на YouTube для данного продукта, если таковой имеется.

Комбинации наведения на поверхность

Правила наведения на поверхность.

JSON-представление 
{
  "availableSurfaceTypes": [
    enum (PlannableSurface)
  ],
  "validSurfaceCombinations": [
    {
      object (SurfaceTargetingCombination)
    }
  ],
  "defaultSurfaceTypes": [
    enum (PlannableSurface)
  ]
}
Поля
availableSurfaceTypes[]

enum ( PlannableSurface )

Только для вывода. Доступные типы поверхностей.

validSurfaceCombinations[]

object ( SurfaceTargetingCombination )

Только для вывода. Допустимые комбинации поверхностей, которые можно выбрать одновременно.

defaultSurfaceTypes[]

enum ( PlannableSurface )

Только для вывода. Типы поверхностей по умолчанию для этого продукта.

Комбинация наведения на поверхность

Допустимое сочетание поверхностей.

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

enum ( PlannableSurface )

Только вывод. Комбинация поверхностей.

YouTubeSelectLineUp

Планируемая линейка рекламных роликов на YouTube для таргетирования на конкретные товары.

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

string ( int64 format)

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

displayName

string

Только для вывода. Отображаемое название списка избранных видео на YouTube.

PlannableProductCoreAttributes

Основные характеристики планируемого продукта.

JSON-представление 
{
  "productCategory": enum (PlannableProductCategory),
  "buyingMethod": enum (PlannableBuyingMethod),
  "costModel": enum (PlannableCostModel)
}
Поля
productCategory

enum ( PlannableProductCategory )

Только вывод. Категория товара.

buyingMethod

enum ( PlannableBuyingMethod )

Только вывод. Способ покупки.

costModel

enum ( PlannableCostModel )

Только результат. Модель затрат.

Метод планируемых закупок

Способ приобретения планируемого продукта.

Перечисления
PLANNABLE_BUYING_METHOD_UNSPECIFIED Не указан.
PLANNABLE_BUYING_METHOD_AUCTION Аукцион.
PLANNABLE_BUYING_METHOD_RESERVATION Бронирование.

Модель планируемых затрат

Модель себестоимости планируемого продукта.

Перечисления
PLANNABLE_COST_MODEL_UNSPECIFIED Не указан.
PLANNABLE_COST_MODEL_CPM CPM.
PLANNABLE_COST_MODEL_CPV КПВ.
PLANNABLE_COST_MODEL_CPC КПК.
PLANNABLE_COST_MODEL_CPA Сертифицированный бухгалтер (CPA).