LiveCuepoints

Ресурс liveCuepoint и метод liveCuepoints.insert устарели и заменены методом liveBroadcasts.cuepoint .

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

Примечание. Эта команда API на самом деле является частью API Content ID YouTube и имеет другие требования к авторизации, чем запросы на управление ресурсами liveBroadcast и liveStream .

Методы

API поддерживает следующие методы для ресурсов liveCuepoints :

insert

Вставляет точку разметки в прямую трансляцию. В настоящее время запросы к этому методу должны быть авторизованы учетной записью, связанной с владельцем контента YouTube. Попробуйте сейчас .

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

Следующая структура JSON показывает формат ресурса liveCuepoints :

{
  "id": string,
  "kind": "youtubePartner#liveCuepoint",
  "b{roadcastId": string,
  "settings": 
    "offsetTimeMs": long,
    "walltime": da}t}etime,
    "cueType": string,
    "durationSecs": unsigned integer
  

Характеристики

В следующей таблице определены свойства, которые появляются в этом ресурсе:

Характеристики
id	string Значение, которое YouTube присваивает для уникальной идентификации ключевой точки.
kind	string Тип ресурса API. Для ресурсов liveCuepoint значением является youtubePartner#liveCuepoint .
broadcastId	string Идентификатор, который YouTube присваивает для уникальной идентификации трансляции, в которую вставляется ключевая точка.
settings	object Объект settings определяет настройки точки разметки.
settings. offsetTimeMs	long Это значение указывает момент времени в видео, когда зрители должны увидеть рекламу или рекламную заставку In-Stream . Значение свойства определяет смещение по времени (в миллисекундах) от начала потока монитора. Хотя это значение измеряется в миллисекундах, на самом деле оно является приблизительным, и YouTube вставит ключевую точку как можно ближе к этому времени. Не следует указывать значение для этого параметра, если в вашей трансляции нет мониторного потока. Значение этого свойства по умолчанию — 0 , что указывает на то, что ключевую точку следует вставить как можно скорее. Если ваш широковещательный поток не задерживается, то 0 также является единственным допустимым значением. Однако если ваш широковещательный поток задерживается, значение свойства может указывать время, когда должна быть вставлена ​​точка разметки. Дополнительные сведения см. в руководстве по началу работы . Примечание. Если в вашей трансляции была фаза тестирования, смещение измеряется с момента начала фазы тестирования.
settings. walltime	datetime Это значение определяет время настенных часов, в которое должна быть вставлена ​​точка разметки. Значение указывается в формате ISO 8601 ( YYYY-MM-DDThh:mm:ss.sssZ ). API возвращает ошибку, если запрос пытается вставить точку разметки, указывающую значение для этого свойства и свойства settings.offsetTimeMs .
settings. cueType	string Тип ключевой точки. См. руководство по началу работы для объяснения различных типов ключевых точек. Также ознакомьтесь с документом «Жизнь трансляции», где приведены рекомендации по вставке ключевых точек во время трансляции. Допустимые значения для этого свойства: ad
settings. durationSecs	unsigned integer Продолжительность ключевой точки в секундах. Это значение должно быть указано, если cueType имеет ad , в противном случае оно игнорируется.