LiveCuepoints

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

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

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

Методы

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

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

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

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

{
  "id": string,
  "kind": "youtubePartner#liveCuepoint",
  "broadcastId": string,
  "settings": {
    "offsetTimeMs": long,
    "walltime": datetime,
    "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 , и игнорируется в противном случае.