- Ресурс: ВидеоКонтент
- Статус видеоконтента
- Метаданные
- GracenoteМетаданные
- ВидеоконтентСиндикацияИнформация
- Синдицированные видеоконтентыИмена
- Динамиадинсертионинформо
- ВидеоIngestUrlInfo
- Видеоформат
- ВидеоПредварительное условие
- ClosedCaptionUrlInfo
- ClosedCaptionFormat
- Методы
Ресурс: ВидеоКонтент
Метаданные контента.
JSON-представление |
---|
{ "name": string, "status": enum ( |
Поля | |
---|---|
name | Только вывод. Имя ресурса видеоконтента. Это поле имеет формат: 'networks/{network_code}/sources/{content_source_id}/content/{cms_content_id}'. network_code – это код сети в Google Ad Manager, которому принадлежит этот контент. content_source_id — идентификатор источника контента в Google Ad Manager, которому должен принадлежать этот контент. cms_content_id — это идентификатор контента CMS в Google Ad Manager, формируемый как часть запроса объявления для определения того, какие объявления Менеджер рекламы может показывать в отношении соответствующего видео. Это значение может быть числовым или буквенно-цифровым. |
status | Статус контента. Если это значение опущено, значение по умолчанию будет активным. |
title | Необходимый. Название контента. |
updateTime | Необходимый. Время последнего изменения содержимого. Временная метка в формате RFC3339 UTC «Зулу» с наносекундным разрешением и до девяти дробных цифр. Примеры: |
publishTime | Время публикации контента. Это обязательное поле, если видео предназначено для включения в правила рекламы, в которых указано время начала и окончания. Временная метка в формате RFC3339 UTC «Зулу» с наносекундным разрешением и до девяти дробных цифр. Примеры: |
duration | Продолжительность контента. Длительность поддерживается вплоть до уровня миллисекунд. Длительность в секундах, содержащая до девяти дробных цифр и оканчивающаяся на « |
cuePoints[] | Определяет ключевые точки. Разметочные точки — это места во времени, где в видео можно вставить рекламу. Разметочные точки поддерживаются вплоть до миллисекундного уровня. Это обязательное поле, если в видео есть рекламные паузы в середине ролика. Длительность в секундах, содержащая до девяти дробных цифр и оканчивающаяся на « |
thumbnailUrl | URL-адрес миниатюры контента. |
metadata | Идентифицирует пользовательские метаданные контента. |
gracenoteMetadata | Метаданные контента, связанные с Gracenote. |
syndicationMetadata | Метаданные контента, связанные с синдикацией. |
dynamicAdInsertionMetadata | Метаданные контента, связанные с динамической вставкой рекламы. |
Статус видеоконтента
Варианты статуса: показывать или не показывать целевую рекламу для контента.
Перечисления | |
---|---|
ACTIVE | Будут показываться объявления, ориентированные на контент. |
BLOCKED | Никакая реклама не будет показываться на этом контенте, если у него статус «БЛОКИРОВАНО». |
DELETED | Содержимое будет заархивировано в Менеджере рекламы. Если Менеджер рекламы получает запрос на объявление для контента, помеченного как УДАЛЕНО, то собственные объявления или объявления, ориентированные на единицы инвентаря или другие критерии таргетинга, все равно могут показываться по нему. Чтобы заблокировать рекламу, установите статус ЗАБЛОКИРОВАНО. |
Метаданные
Пользовательские метаданные контента.
JSON-представление |
---|
{ "keyValues": { string: value, ... } } |
Поля | |
---|---|
keyValues | Идентифицирует пользовательские метаданные контента как пару ключ-значение. В качестве значений принимаются только строки или список строк. |
GracenoteМетаданные
Метаданные Gracenote для содержимого.
JSON-представление |
---|
{ "gracenoteId": string, "gracenoteSeriesId": string } |
Поля | |
---|---|
gracenoteId | Необходимый. Относится к идентификатору Gracenote для содержимого. Должен иметь один из следующих допустимых префиксов: 1. «EP» — эпизод сериала 2. «MV» — фильм 3. «SP» — спортивное событие. |
gracenoteSeriesId | Необязательный. Это поле относится к идентификатору серии Gracenote. Должен иметь префикс «SH». |
ВидеоконтентСиндикацияИнформация
Метаданные для определения отношений между каноническим и синдицированным контентом.
JSON-представление |
---|
{ // Union field |
Поля | |
---|---|
syndication полей Союза. VideoContentSyndiationMetadata может содержать только одно из следующих значений. syndication может быть только одной из следующих: | |
canonicalVideoContent | Название канонического контента. Оно должно иметь формат «networks/{network_code}/sources/{content_source_id}/content/{cms_content_id}» и должно принадлежать той же сети, что и контент, содержащий это поле. |
syndicatedVideoContentNames | Коллекция синдицированного контента |
Синдицированные видеоконтентыИмена
Список названий всего синдицированного контента.
JSON-представление |
---|
{ "syndicatedVideoContent": [ string ] } |
Поля | |
---|---|
syndicatedVideoContent[] | Повторяющееся поле названия синдицированного контента. Они должны иметь формат «networks/{network_code}/sources/{content_source_id}/content/{cms_content_id}» и должны принадлежать той же сети, что и контент, содержащий это поле. |
Динамиадинсертионинформо
Информация, касающаяся динамической вставки объявлений.
JSON-представление |
---|
{ "videoIngestUrlInfo": { object ( |
Поля | |
---|---|
videoIngestUrlInfo | Ссылка на главный файл m3u8, который используется для настройки и создания списка воспроизведения. |
mediaUpdateTime | Время последнего изменения видеофайла, указанного в videoIngestUrlInfo. Временная метка в формате RFC3339 UTC «Зулу» с наносекундным разрешением и до девяти дробных цифр. Примеры: |
closedCaptionUrlInfo[] | URL-адрес файла скрытых титров/субтитров. |
fwCaid | Идентификатор пользовательского ресурса Freewheel, используемый для таргетинга рекламы. |
ВидеоIngestUrlInfo
Метаданные, указывающие ссылку на файл m3u8, который используется для настройки и создания списка воспроизведения.
JSON-представление |
---|
{ "videoFormat": enum ( |
Поля | |
---|---|
videoFormat | Формат видео. |
videoPreconditioned | Чтобы указать, подготовлен ли контент для рекламы в середине ролика, что означает, что ваши сегменты уже разделены во время рекламных пауз. |
url | Ссылка на файл m3u8. |
Видеоформат
Форматы, в которых может быть закодирован видеоконтент.
Перечисления | |
---|---|
VIDEO_FORMAT_UNSPECIFIED | Формат видео не указан. |
HLS | приложение/x-mpegURL |
DASH | приложение/тире+xml |
ВидеоПредварительное условие
Условное состояние видеоконтента.
Перечисления | |
---|---|
NO | Еще не кондиционирован. |
YES | Видео было обработано/разделено. |
ClosedCaptionUrlInfo
Метаданные для одного файла субтитров.
JSON-представление |
---|
{
"languageCode": string,
"closedCaptionFormat": enum ( |
Поля | |
---|---|
languageCode | Языковой код IETF BCP-47, представляющий язык, на котором находится файл субтитров. |
closedCaptionFormat | Формат файла субтитров. |
url | URL-адрес файла субтитров. |
ClosedCaptionFormat
Форматы, в которых могут быть файлы субтитров.
Перечисления | |
---|---|
CLOSED_CAPTION_FORMAT_UNSPECIFIED | Формат субтитров не указан. |
TTML | приложение/ttaf+xml |
WEB_VTT | текст/ВТТ |
Методы | |
---|---|
| API для создания нового контента или обновления его метаданных, если контент уже существует в Менеджере рекламы. |