REST Resource: videoContent.networks.sources.content

Ресурс: ВидеоКонтент

Метаданные контента.

JSON-представление
{
  "name": string,
  "status": enum (VideoContentStatus),
  "title": string,
  "updateTime": string,
  "publishTime": string,
  "duration": string,
  "cuePoints": [
    string
  ],
  "thumbnailUrl": string,
  "metadata": {
    object (Metadata)
  },
  "gracenoteMetadata": {
    object (GracenoteMetadata)
  },
  "syndicationMetadata": {
    object (VideoContentSyndicationInfo)
  },
  "dynamicAdInsertionMetadata": {
    object (DynamicAdInsertionInfo)
  }
}
Поля
name

string

Только вывод. Имя ресурса видеоконтента. Это поле имеет формат: '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

enum ( VideoContentStatus )

Статус контента. Если это значение опущено, значение по умолчанию будет активным.

title

string

Необходимый. Название контента.

updateTime

string ( Timestamp format)

Необходимый. Время последнего изменения содержимого.

Временная метка в формате RFC3339 UTC «Зулу» с наносекундным разрешением и до девяти дробных цифр. Примеры: "2014-10-02T15:01:23Z" и "2014-10-02T15:01:23.045123456Z" .

publishTime

string ( Timestamp format)

Время публикации контента. Это обязательное поле, если видео предназначено для включения в правила рекламы, в которых указано время начала и окончания.

Временная метка в формате RFC3339 UTC «Зулу» с наносекундным разрешением и до девяти дробных цифр. Примеры: "2014-10-02T15:01:23Z" и "2014-10-02T15:01:23.045123456Z" .

duration

string ( Duration format)

Продолжительность контента. Длительность поддерживается вплоть до уровня миллисекунд.

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

cuePoints[]

string ( Duration format)

Определяет ключевые точки. Разметочные точки — это места во времени, где в видео можно вставить рекламу. Разметочные точки поддерживаются вплоть до миллисекундного уровня. Это обязательное поле, если в видео есть рекламные паузы в середине ролика.

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

thumbnailUrl

string

URL-адрес миниатюры контента.

metadata

object ( Metadata )

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

gracenoteMetadata

object ( GracenoteMetadata )

Метаданные контента, связанные с Gracenote.

syndicationMetadata

object ( VideoContentSyndicationInfo )

Метаданные контента, связанные с синдикацией.

dynamicAdInsertionMetadata

object ( DynamicAdInsertionInfo )

Метаданные контента, связанные с динамической вставкой рекламы.

Статус видеоконтента

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

Перечисления
ACTIVE Будут показываться объявления, ориентированные на контент.
BLOCKED Никакая реклама не будет показываться на этом контенте, если у него статус «БЛОКИРОВАНО».
DELETED Содержимое будет заархивировано в Менеджере рекламы. Если Менеджер рекламы получает запрос на объявление для контента, помеченного как УДАЛЕНО, то собственные объявления или объявления, ориентированные на единицы инвентаря или другие критерии таргетинга, все равно могут показываться по нему. Чтобы заблокировать рекламу, установите статус ЗАБЛОКИРОВАНО.

Метаданные

Пользовательские метаданные контента.

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

map (key: string, value: value ( Value format))

Идентифицирует пользовательские метаданные контента как пару ключ-значение. В качестве значений принимаются только строки или список строк.

GracenoteМетаданные

Метаданные Gracenote для содержимого.

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

string

Необходимый. Относится к идентификатору Gracenote для содержимого. Должен иметь один из следующих допустимых префиксов: 1. «EP» — эпизод сериала 2. «MV» — фильм 3. «SP» — спортивное событие.

gracenoteSeriesId

string

Необязательный. Это поле относится к идентификатору серии Gracenote. Должен иметь префикс «SH».

ВидеоконтентСиндикацияИнформация

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

JSON-представление
{

  // Union field syndication can be only one of the following:
  "canonicalVideoContent": string,
  "syndicatedVideoContentNames": {
    object (SyndicatedVideoContentNames)
  }
  // End of list of possible types for union field syndication.
}
Поля
syndication полей Союза. VideoContentSyndiationMetadata может содержать только одно из следующих значений. syndication может быть только одной из следующих:
canonicalVideoContent

string

Название канонического контента. Оно должно иметь формат «networks/{network_code}/sources/{content_source_id}/content/{cms_content_id}» и должно принадлежать той же сети, что и контент, содержащий это поле.

syndicatedVideoContentNames

object ( SyndicatedVideoContentNames )

Коллекция синдицированного контента

Синдицированные видеоконтентыИмена

Список названий всего синдицированного контента.

JSON-представление
{
  "syndicatedVideoContent": [
    string
  ]
}
Поля
syndicatedVideoContent[]

string

Повторяющееся поле названия синдицированного контента. Они должны иметь формат «networks/{network_code}/sources/{content_source_id}/content/{cms_content_id}» и должны принадлежать той же сети, что и контент, содержащий это поле.

Динамиадинсертионинформо

Информация, касающаяся динамической вставки объявлений.

JSON-представление
{
  "videoIngestUrlInfo": {
    object (VideoIngestUrlInfo)
  },
  "mediaUpdateTime": string,
  "closedCaptionUrlInfo": [
    {
      object (ClosedCaptionUrlInfo)
    }
  ],
  "fwCaid": string
}
Поля
videoIngestUrlInfo

object ( VideoIngestUrlInfo )

Ссылка на главный файл m3u8, который используется для настройки и создания списка воспроизведения.

mediaUpdateTime

string ( Timestamp format)

Время последнего изменения видеофайла, указанного в videoIngestUrlInfo.

Временная метка в формате RFC3339 UTC «Зулу» с наносекундным разрешением и до девяти дробных цифр. Примеры: "2014-10-02T15:01:23Z" и "2014-10-02T15:01:23.045123456Z" .

closedCaptionUrlInfo[]

object ( ClosedCaptionUrlInfo )

URL-адрес файла скрытых титров/субтитров.

fwCaid

string

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

ВидеоIngestUrlInfo

Метаданные, указывающие ссылку на файл m3u8, который используется для настройки и создания списка воспроизведения.

JSON-представление
{
  "videoFormat": enum (VideoFormat),
  "videoPreconditioned": enum (VideoPreconditioned),
  "url": string
}
Поля
videoFormat

enum ( VideoFormat )

Формат видео.

videoPreconditioned

enum ( VideoPreconditioned )

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

url

string

Ссылка на файл m3u8.

Видеоформат

Форматы, в которых может быть закодирован видеоконтент.

Перечисления
VIDEO_FORMAT_UNSPECIFIED Формат видео не указан.
HLS приложение/x-mpegURL
DASH приложение/тире+xml

ВидеоПредварительное условие

Условное состояние видеоконтента.

Перечисления
NO Еще не кондиционирован.
YES Видео было обработано/разделено.

ClosedCaptionUrlInfo

Метаданные для одного файла субтитров.

JSON-представление
{
  "languageCode": string,
  "closedCaptionFormat": enum (ClosedCaptionFormat),
  "url": string
}
Поля
languageCode

string

Языковой код IETF BCP-47, представляющий язык, на котором находится файл субтитров.

closedCaptionFormat

enum ( ClosedCaptionFormat )

Формат файла субтитров.

url

string

URL-адрес файла субтитров.

ClosedCaptionFormat

Форматы, в которых могут быть файлы субтитров.

Перечисления
CLOSED_CAPTION_FORMAT_UNSPECIFIED Формат субтитров не указан.
TTML приложение/ttaf+xml
WEB_VTT текст/ВТТ

Методы

update

API для создания нового контента или обновления его метаданных, если контент уже существует в Менеджере рекламы.