REST Resource: adBreak.networks.customAssets.adBreaks

Источник: AdBreak

Метаданные рекламной паузы используются для принятия решения о показе рекламы в рекламной паузе во время прямой видеотрансляции.

JSON-представление 
{
  "name": string,
  "createTime": string,
  "expectedDuration": string,
  "customParams": string,
  "scte35CueOut": string,
  "podTemplateName": string,
  "breakState": enum (BreakState),
  "expectedStartTime": string,
  "expireDuration": string,
  "breakSequence": string,
  "breakParams": {
    object (BreakParams)
  },
  "matchParams": {
    object (MatchParams)
  },
  "servedBreak": {
    object (ServedBreak)
  }
}
Поля
name

string

Только для вывода. Название ресурса рекламной паузы. Это поле будет иметь формат "сети/ /ресурсы/ /adBreaks/ «.

network_code — это сетевой код в Google Ad Manager, к которому относится данный контент.

asset_key — это ключ события прямой трансляции в Google Ad Manage, под которым был создан рекламный блок.

adBreakId — это ключ рекламной паузы. Только для вывода.

createTime

string ( Timestamp format)

Только вывод. Время создания рекламной паузы.

Используется RFC 3339, согласно которому генерируемый вывод всегда будет Z-нормализован и будет содержать 0, 3, 6 или 9 дробных знаков. Допускаются также смещения, отличные от "Z". Примеры: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" или "2014-10-02T15:01:23+05:30" .

expectedDuration

string ( Duration format)

Обязательно. Предполагаемая продолжительность перерыва.

Длительность в секундах, содержащая до девяти знаков после запятой, заканчивающаяся на « s ». Пример: "3.5s" .

customParams
(deprecated)

string

Необязательно. Пары ключ-значение, которые будут включены в запросы объявлений для этой временной паузы для таргетинга по пользовательским критериям в Ad Manager. Пример: 'key1=value&key2=value2,value22'. Устарело: Пожалуйста, задавайте параметры cust_params в breakParams.ad_tag_params, используя ключ "cust_params".

scte35CueOut

string

Необязательно. Данные, закодированные в Base64, из выходного сигнала scte35. Может включать команду splice_insert() или time_signal(). Примеры: - с time_signal(): “/DA0AAAAAAAA///wBQb+cr0AUAAeAhxDVUVJSAAAjn/PAAGlmbAICAAAAAAsoKGKNAIAmsnRfg==” - с splice_insert(): "/DAvAAAAAAAA///wFAVIAACPf+/+c2nALv4AUsz1AAAAAAAKAAhDVUVJAAABNWLbowo="

podTemplateName
(deprecated)

string

Необязательно. Имя шаблона пода Google Ad Manager. Устарело: пожалуйста, задайте cust_params в breakParams.ad_tag_params, используя ключ "ptpln".

breakState

enum ( BreakState )

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

expectedStartTime

string ( Timestamp format)

Необязательно. Предполагаемое время начала рекламной паузы.

Используется RFC 3339, согласно которому генерируемый вывод всегда будет Z-нормализован и будет содержать 0, 3, 6 или 9 дробных знаков. Допускаются также смещения, отличные от "Z". Примеры: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" или "2014-10-02T15:01:23+05:30" .

expireDuration

string ( Duration format)

Необязательно. Рекламная пауза заканчивается через expectedStartTime + expireDuration. Если expectedStartTime не задано, рекламная пауза закончится через expireDuration после начала принятия решения. По умолчанию: 30 мин. Минимум: 5 мин. Максимум: 6 ч.

Длительность в секундах, содержащая до девяти знаков после запятой, заканчивающаяся на « s ». Пример: "3.5s" .

breakSequence

string ( int64 format)

Только для вывода. Идентификатор последовательности промежуточного ролика рекламной паузы. Несколько рекламных пауз могут иметь одинаковую последовательность breakSequence, если это явно указано в breakParams.ad_tag_params с ключом mridx. Это фактически связывает две рекламные паузы GAM.

breakParams

object ( BreakParams )

Необязательно. Параметры рекламной паузы, которые необходимо указать в запросах на показ рекламы для этой паузы.

matchParams

object ( MatchParams )

Необязательно. Используется для Stitched DAI, чтобы определить, как рекламная пауза, созданная через API, сопоставляется с рекламной паузой в манифесте. При обнаружении новой паузы функция сопоставления будет запущена для всех рекламных пауз события, у которых breakState равно SCHEDULED или DECISIONED чтобы проверить, соответствуют ли все заданные параметры в matchParams рекламной паузы обнаруженной паузе. Совпадение происходит, если выполняется одно из следующих условий: 1. Рекламная пауза имеет поле matchParams, и все заданные в нем параметры соответствуют новой паузе. 2. Рекламная пауза имеет DECISIONED и не имеет поля matchParams.

Чтобы предотвратить случайное срабатывание функции «соответствует всем» (которое произойдет при пустом, но присутствующем значении matchParams), значение matchParams не может быть пустым, если оно задано. Если поле присутствует в запросе, должно быть задано хотя бы одно из его собственных полей.

Проверка рекламных пауз производится в следующем порядке: 1. с параметром matchParams, упорядоченные по возрастанию expectedStartTime и createTime, при этом рекламные паузы без expectedStartTime имеют приоритет при сортировке; 2. без параметра matchParams, упорядоченные по возрастанию expectedStartTime и createTime, при этом рекламные паузы без expectedStartTime имеют приоритет при сортировке.

Если все ожидающие подтверждения EABN не совпадут, DAI вернется к принятию решений точно в срок, используя следующий доступный индекс середины срока.

servedBreak

object ( ServedBreak )

Только для вывода. Отражает фактическую информацию о показанном рекламном блоке. Устанавливается только для рекламных блоков с состоянием breakState, COMPLETE .

Методы

create

 API для создания рекламной паузы в прямом эфире.

delete

 API для удаления рекламной паузы в прямом эфире.

get

 API для создания рекламной паузы в прямом эфире.

list

 API для отображения рекламных пауз в прямом эфире.

patch

 API для обновления рекламной паузы в прямом эфире.