REST Resource: videoAdvertisingOptions

Ресурс: VideoAdvertisingOption

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

JSON-представление 
{
  "kind": string,
  "adFormats": [
    string
  ],
  "breakPosition": [
    string
  ],
  "adBreaks": [
    {
      object (AdBreak)
    }
  ],
  "autoGeneratedBreaks": boolean,
  "id": string,
  "tpAdServerVideoId": string,
  "tpTargetingUrl": string,
  "tpUrlParameters": string
}
Поля
kind

string

Тип ресурса API. Для этого ресурса значением является youtubePartner#videoAdvertisingOption .

adFormats[]

string

Список форматов рекламы, которые разрешено показывать в видео. Примечание. По состоянию на ноябрь 2023 г. в этом столбце можно включать/отключать только Third_party_ads. Дополнительную информацию см. в статье поддержки . Следующие элементы управления форматом объявлений больше недоступны, и их не следует включать в запрос API: instream_standard , display , preroll , postroll .

breakPosition[]

string

Точка, в которой происходит разрыв во время воспроизведения видео.

adBreaks[]

object ( AdBreak )

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

autoGeneratedBreaks

boolean

Включает для этого видео автоматически создаваемые перерывы в середине ролика.

id

string

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

tpAdServerVideoId

string

Значение, которое однозначно идентифицирует видео для стороннего сервера объявлений.

tpTargetingUrl

string

Базовый URL-адрес стороннего рекламного сервера, с которого YouTube может получать рекламу In-Stream для видео.

tpUrlParameters

string

Строка параметра, добавляемая в конец запроса к стороннему серверу объявлений.

Рекламная пауза

Ресурс adBreak содержит информацию о том, когда YouTube может показывать рекламу in-stream во время воспроизведения видео.

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

string

Точка, в которой происходит разрыв во время воспроизведения видео.

midrollSeconds

integer

Время рекламной паузы указывается как количество секунд после начала видео, когда происходит пауза.

Методы

get

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

getEnabledAds

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

patch

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

update

 Обновляет настройки рекламы для указанного видео.