API потокового вещания YouTube – история изменений

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

12 января 2026 г.

Теперь API поддерживает включение рекламных вставок в середине трансляции и автоматическую вставку таких вставок для прямых эфиров.

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

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

Когда владелец трансляции включает автоматическую показ рекламы, он может выбрать один из следующих вариантов:

  • Оптимизация вставки рекламных роликов в середине видео на YouTube. Эта опция поддерживает три режима:
    • Низкий уровень: меньший потенциал заработка, меньше прерываний в просмотре.
    • Средний уровень: средний потенциал заработка, сбалансированный зрительский опыт.
    • Высокий уровень: более высокий потенциал заработка, более частые прерывания просмотра.
  • Стратегию и интервал для вставки ролика в середине видео настраивают вручную. В этом случае владелец должен задать два параметра:
    1. Стратегия планирования рекламных пауз. Рекламные паузы могут появляться одновременно для всех зрителей, или же время их появления может варьироваться для каждого зрителя. Последняя стратегия позволяет YouTube планировать рекламные паузы с большей частотой, что позволяет зрителям получать их тогда, когда у них есть на это право.
    2. Длительность интервала между рекламными паузами в середине ролика.

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

  • Объект monetizationDetails ресурса liveBroadcast содержит поля для включения вставки в середине видео и настройки автоматической рекламы.
  • Метод update можно использовать для включения или отключения рекламных вставок в середине трансляции. Этот метод также можно использовать для настройки автоматической рекламы для прямой трансляции. В документации описаны несколько новых ошибок, которые могут возникнуть при обновлении настроек монетизации и автоматической рекламы для прямой трансляции.

14 июля 2025 года

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

9 октября 2023 г.

Для справки, в этом CSV-файле вы можете найти информацию о том, какие идентификаторы стикеров соответствуют каким суперстикерам. Определения свойств snippet.superStickerDetails.superStickerMetadata.stickerId ресурса liveChatMessage и snippet.superStickerMetadata.stickerId ресурса superChatEvent были обновлены с учетом этой информации.

15 сентября 2023 г.

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

Если владелец трансляции включит автоматическую показ рекламы, он сможет отслеживать следующие аспекты поведения рекламы:

  • Длительность интервала между рекламными паузами в середине ролика.
  • Стратегия планирования рекламных пауз. Паузы могут появляться одновременно для всех зрителей, или же время их появления может варьироваться от зрителя к зрителю. Последняя стратегия позволяет YouTube планировать рекламные паузы с большей частотой, что позволяет зрителям получать их тогда, когда у них есть на это право.
  • Период, в течение которого рекламные вставки в середине ролика не отображаются; для этой функции владелец трансляции указывает, что вставка рекламных вставок в середине ролика приостанавливается до определенного времени.

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

  • Ресурс liveBroadcast теперь содержит объект monetizationDetails . Поля объекта указывают, включена ли автоматическая вставка рекламы для трансляции, а также содержат дополнительную информацию для планирования точек показа.
  • Параметр part метода liveBroadcast.list поддерживает значение monetizationDetails .
  • Метод update позволяет приостанавливать показ рекламных вставок в середине прямой трансляции на определенный период. В документации также указаны несколько ошибок, которые могут возникнуть при обновлении данных монетизации для прямой трансляции.

1 августа 2023 г.

В это обновление внесены следующие изменения:

  • Метод liveBroadcasts.update больше не требует указания значений для этих полей:

    • snippet.title
    • status.privacyStatus

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

1 ноября 2022 г.

  • Новый метод liveBroadcasts.cuepoint позволяет любому владельцу канала, ведущего прямую трансляцию на YouTube, вставлять в неё точки воспроизведения, которые могут запускать рекламные паузы. Этот метод заменяет метод liveCuepoints.insert , который позволял вставлять точки воспроизведения в прямые трансляции только партнёрам YouTube.

    В связи с появлением этого нового метода ряд руководств был обновлен.

  • Примечание: Это объявление об устаревании функции.

    Метод liveCuepoints.insert устарел. Поддержка метода liveCuepoints.insert будет прекращена 1 мая 2023 года или позже. Пользователям API следует обновить свои приложения, чтобы вместо него вызывался метод liveBroadcasts.cuepoint .

  • Документация по методу liveBroadcasts.control была удалена. Уведомление об устаревании этого метода было опубликовано в сентябре 2020 года.

1 октября 2022 г.

В это обновление внесены следующие изменения:

  • Метод liveBroadcasts.update больше не требует указания значений для этих полей:

    • contentDetails.enableContentEncryption
    • contentDetails.enableDvr
    • contentDetails.enableEmbed
    • contentDetails.recordFromStart
    • contentDetails.startWithSlate

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

  • Удалена документация для устаревших полей liveBroadcast :

    • contentDetails.enableContentEncryption
    • contentDetails.startWithSlate

1 апреля 2022 г.

В это обновление внесены следующие изменения:

  • Свойство snippet.type теперь поддерживает два новых значения:

    • membershipGiftingEvent
    • giftMembershipReceivedEvent

  • Свойство snippet.membershipGiftingDetails ресурса ` liveChatMessage и его дочерние элементы содержат информацию о событии «Подарок за членство». Аналогично, свойство snippet.giftMembershipReceivedDetails и его дочерние элементы содержат информацию о событии «Получено подаренное членство».

15 сентября 2021 г.

В это обновление внесены следующие изменения:

  • Свойство snippet.type теперь поддерживает два новых значения:

    • newSponsorEvent
    • memberMilestoneChatEvent

  • Свойство `new snippet.memberMilestoneChatDetails ресурса ` liveChatMessage и его дочерние элементы содержат информацию о событии «Чат в рамках этапа развития участника». Аналогично, свойство snippet.newSponsorDetails и его дочерние элементы содержат информацию о событии «Новый спонсор».

1 декабря 2020 г.

Метод liveBroadcasts.transition API поддерживает новую ошибку 403 ( Forbidden ), которая указывает на то, что пользователь отправил слишком много запросов в течение заданного временного интервала. Причина ошибки — userRequestsExceedRateLimit .

21 сентября 2020 г.

  • В определение свойства status.madeForKids ресурса liveBroadcast внесены изменения, уточняющие, что это свойство доступно только для чтения. Это не отражает изменений в функциональности API.

    Чтобы обозначить прямую трансляцию как предназначенную для детей, установите свойство status.selfDeclaredMadeForKids в значение true при вызове метода liveBroadcasts.insert для создания трансляции.

  • Примечание: Данное изменение включает в себя объявление об устаревании и обновление предыдущего объявления об устаревании.

    Метод liveBroadcasts.control будет объявлен устаревшим 1 октября 2020 года или позже. После этой даты все вызовы этого метода будут возвращать ошибку Forbidden (403), и метод будет полностью удален. Клиенты по-прежнему смогут реализовать собственную заставку, добавив наложение к видео, отправляемому на серверы приема YouTube.

    Дата прекращения поддержки, указанная в объявлении от 16 апреля 2020 года и первоначально запланированная на 1 сентября 2020 года, была перенесена и теперь наступит 1 октября 2020 года или позже. Таким образом, функции, указанные в этом объявлении о прекращении поддержки, и метод liveBroadcasts.control будут прекращены одновременно.

17 июля 2020 г.

Примечание: Это обновление к предыдущему объявлению об устаревании функции.

Поле cdn.format ресурса liveStream , поддержка которого была прекращена в апреле 2016 года, будет отключена с 17 августа 2020 года. Запросы, использующие это поле, будут завершаться с ошибкой начиная с этой даты.

Если в вашем коде по-прежнему используется поле cdn.format , его необходимо обновить, чтобы указывать частоту кадров и разрешение отдельно, используя свойства cdn.frameRate и cdn.resolution .

6 июля 2020 г.

В руководство по доставке контента YouTube в прямом эфире через HLS внесены некоторые изменения:

Кроме того, в новом разделе сравнения протоколов загрузки указаны поддерживаемые YouTube протоколы загрузки, поддерживаемые кодеки для каждого протокола, а также дополнительная информация о подходящих сценариях использования каждого протокола.

16 апреля 2020 г.

В это обновление включено новое свойство и объявление об устаревании:

  • Ресурс liveBroadcast теперь поддерживает свойство contentDetails.enableAutoStop . Это свойство указывает, следует ли автоматически останавливать трансляцию примерно через минуту после того, как владелец канала прекратит потоковую передачу видео в привязанном видеопотоке.

    Внесены изменения в описание жизненного цикла транслируемого документа, чтобы объяснить, как изменяется пошаговый процесс создания и управления прямой трансляцией на YouTube, если установить свойства contentDetails.enableAutoStart или contentDetails.enableAutoStop в true .

  • Примечание: Это объявление об отмене изменений. Данные изменения вступят в силу 1 сентября 2020 года или позднее. Фактическая дата вступления изменений в силу далее будет называться датой отмены изменений.

    В этом обновлении описывается потенциально критическое изменение. Оно затрагивает клиентские приложения API, использующие ресурсы liveStream и liveBroadcast по умолчанию для потоковой передачи контента в прямом эфире на YouTube. В частности, идентификатор трансляции и идентификатор потока , связанные с постоянной трансляцией и потоком, больше не будут работать для запуска новых трансляций.

    На вашу заявку повлияет любое из следующих условий:

    • Эта функция проверяет значение свойства isDefaultBroadcast ресурса liveBroadcast . После истечения срока устаревания это свойство больше не будет возвращаться.
    • Эта функция проверяет значение свойства isDefaultStream ресурса liveStream . После истечения срока устаревания это свойство больше не будет возвращаться.
    • Вызывается метод liveBroadcasts.list и устанавливается значение параметра broadcastType равным persistent или all . Этот параметр будет объявлен устаревшим в рамках этих изменений. На дату объявления об устаревании:
      • Если значение параметра broadcastType равно persistent , то метод liveBroadcasts.list не вернет никаких результатов.
      • Если значение параметра broadcastType равно all , то метод liveBroadcasts.list не вернет постоянные трансляции, существовавшие до этого момента.

    Для справки, в течение последних нескольких лет YouTube автоматически создавал для канала поток по умолчанию и трансляцию по умолчанию, когда этот канал был активирован для прямых трансляций. Поток по умолчанию существовал неограниченно долго, не имел связанного с ним времени начала или окончания и не мог быть удален. Аналогично, трансляция по умолчанию считалась постоянной . Она всегда существовала и не была привязана к какому-либо конкретному событию.

    По состоянию на дату прекращения поддержки:

    • YouTube больше не будет создавать потоки и трансляции по умолчанию. Вместо использования ресурсов по умолчанию, API-клиенты должны иметь возможность создавать и управлять ресурсами liveBroadcast и liveStream , а также связывать эти ресурсы между собой.
    • Если основная трансляция и основной поток канала активно используются в прямом эфире, то есть канал использует их для прямой трансляции в момент вступления в силу решения об устаревании, то текущая трансляция не будет затронута. Однако после завершения этой трансляции канал не сможет снова использовать основную трансляцию и основной поток.
    • Если основная трансляция и основной поток канала не находятся в режиме реального времени, то после вступления в силу этого изменения YouTube будет игнорировать попытки использовать эти ресурсы для трансляции видео.

    Если ваше приложение затронуто этими изменениями, пожалуйста, ознакомьтесь со следующими документами, которые помогут вам обновить приложение, чтобы оно продолжало корректно работать после внесения этих изменений:

    • В новом руководстве по миграции предпринята попытка объяснить шаги, которые разработчикам, возможно, потребуется предпринять в API-клиентах, использующих в настоящее время широковещательные и потоковые запросы по умолчанию.
    • Руководство «Жизнь вещания» шаг за шагом объясняет, как создавать и управлять прямыми трансляциями на YouTube. На каждом шаге описываются вызовы API или другие действия, необходимые для выполнения определенного действия, и вашему приложению потребуется следовать этому процессу, когда YouTube прекратит поддержку стандартных потоков и трансляций.

31 марта 2020 г.

Примечание: Это объявление об устаревании функции.

Ресурс sponsor и метод sponsors.list устарели и заменены ресурсом member и методом members.list .

Метод sponsors.list больше не будет поддерживаться с 30 сентября 2020 года. Клиентам API следует обновить вызовы метода sponsors.list , используя вместо него метод members.list . Дополнительную информацию о новом ресурсе см. в истории изменений YouTube Data API .

11 марта 2020 г.

В раздел руководства «Доставка контента YouTube в прямом эфире через HLS» внесены изменения, касающиеся конечной точки приема , чтобы уточнить процесс, который должен использовать кодировщик для заполнения значения параметра file= при формировании основного и резервного URL-адресов приема.

4 февраля 2020 г.

В руководство по доставке контента YouTube в прямом эфире через HLS внесены изменения, указывающие на то, что запросы DELETE являются необязательными и что конечная точка HLS YouTube их игнорирует. В целях повышения производительности YouTube рекомендует клиентам не отправлять запросы DELETE .

10 января 2020 г.

Теперь API поддерживает возможность идентификации контента, предназначенного для детей, который YouTube называет «контентом, созданным для детей». Подробнее о контенте «для детей» можно узнать в Справочном центре YouTube.

  • Ресурс liveBroadcast поддерживает два новых свойства, позволяющих создателям контента и зрителям определять контент, предназначенный для детей:
    • Свойство selfDeclaredMadeForKids позволяет создателям контента указывать, является ли прямая трансляция контентом, предназначенным для детей. Это свойство можно установить при создании трансляции с помощью метода liveBroadcasts.insert . Обратите внимание, что это свойство включается в ответы API, содержащие ресурсы liveBroadcast только если владелец канала авторизовал запрос API.
    • Свойство madeForKids позволяет любому пользователю API получить статус трансляции «создано для детей». Например, статус может определяться на основе значения свойства selfDeclaredMadeForKids . Дополнительную информацию о настройке аудитории для вашего канала, видео или трансляций можно найти в Справочном центре YouTube .
  • В API данных YouTube ресурс channel также поддерживает новые свойства selfDeclaredMadeForKids и madeForKids .

Мы также обновили Условия использования сервисов YouTube API и Политику для разработчиков. Более подробную информацию можно найти в разделе «История изменений Условий использования сервисов YouTube API ». Изменения в Условиях использования сервисов YouTube API и Политике для разработчиков вступят в силу 10 января 2020 года по тихоокеанскому времени.

20 августа 2019 г.

В раздел «Требования» руководства «Доставка контента YouTube в прямом эфире через HLS» внесены два изменения:

  • В тексте поясняется, что рекомендуется включать в каждый плейлист как подтвержденные, так и неподтвержденные сегменты. Это снижает вероятность пропуска сегмента в случае потери плейлиста на стороне сервера. Например, в каждый плейлист можно включить до двух подтвержденных сегментов и до пяти неподтвержденных сегментов.
  • Теперь требуется отправлять список воспроизведения медиафайлов для каждого медиасегмента. Это позволяет серверу быстро восстановиться в случае потери списка воспроизведения. Ранее эта практика была указана как рекомендация.

28 июня 2019 г.

Теперь YouTube поддерживает прием HLS-потоков. Соответственно, свойство ingestionType ресурса liveStream теперь поддерживает новое значение hls для идентификации потоков, принимаемых на YouTube с использованием HLS.

Новое руководство «Доставка контента YouTube в прямом эфире через HLS» содержит рекомендации по использованию HLS для потоковой передачи контента в прямом эфире на YouTube с помощью кодировщика. Цель руководства — помочь производителям кодировщиков добавить поддержку доставки HLS в свои продукты.

4 апреля 2019 г.

В это обновление внесены следующие изменения:

  • Документация по API была обновлена, чтобы лучше объяснить распространенные сценарии использования каждого метода и предоставить динамичные, высококачественные примеры кода через виджет API Explorer. Пример можно увидеть в документации метода liveBroadcasts.list . На страницах, описывающих методы API, теперь появились два новых элемента:

    • Виджет API Explorer позволяет выбирать области авторизации, вводить примеры значений параметров и свойств, а затем отправлять реальные API-запросы и просматривать реальные ответы API. Виджет также предлагает полноэкранный режим, отображающий полные примеры кода, которые динамически обновляются с учетом введенных вами областей авторизации и значений.

    • В разделе « Распространенные сценарии использования» описан один или несколько распространенных сценариев применения метода, описанного на странице. Например, вы можете вызвать метод liveBroadcasts.list , чтобы получить данные о конкретной трансляции или данные о трансляциях текущего пользователя.

      В этом разделе вы можете использовать ссылки, чтобы заполнить API-обозреватель примерами значений для вашего варианта использования или открыть полноэкранный API-обозреватель с уже заполненными значениями. Эти изменения призваны упростить просмотр примеров кода, непосредственно применимых к варианту использования, который вы пытаетесь реализовать в своем приложении.

    В настоящее время поддерживаются примеры кода для Java, JavaScript, PHP, Python и curl.

  • На странице с примерами кода также появился новый пользовательский интерфейс, предлагающий все описанные выше функции. С помощью этого инструмента вы можете изучать варианты использования различных методов, загружать значения в обозреватель API и открывать полноэкранный обозреватель API для просмотра примеров кода на Java, JavaScript, PHP и Python.

    В связи с этим изменением были удалены страницы, на которых ранее были перечислены доступные примеры кода для Java, PHP и Python.

25 февраля 2019 г.

Документация к ресурсам liveChatMessage и superChatEvent была обновлена, чтобы отразить тот факт, что оба ресурса теперь могут содержать информацию о суперстикерах. Суперстикеры — это тип сообщений Super Chat, отображающих изображение. Как и другие сообщения Super Chat, сообщение Super Sticker приобретается фанатом во время прямой трансляции на YouTube.

  • В ресурсе liveChatMessage свойство snippet.type теперь устанавливается в superStickerEvent , чтобы указать, что ресурс содержит информацию о суперстикере. В этом случае ресурс также содержит объект snippet.superStickerDetails , который содержит дополнительную информацию о суперстикере.
  • В ресурсе superChatEvent логическое значение snippet.isSuperStickerEvent указывает, является ли сообщение Super Chat также Super Sticker. Если да, то объект snippet.superStickerMetadata содержит дополнительные сведения о Super Sticker.

5 апреля 2018 г.

В описание метода superChatEvents.list внесены изменения, отражающие тот факт, что ответ API больше не содержит fanFundingEvents , которые были объявлены устаревшими в начале 2017 года.

3 апреля 2017 г.

Добавлены новые примеры кода на Java , демонстрирующие вывод , вставку и удаление сообщений в чате. В примерах вызываются следующие методы:

13 февраля 2017 г.

В это обновление внесены следующие изменения:

  • Обновление существующих ресурсов и методов.

    • Метод liveCuepoints.insert был обновлен с учетом того, что параметр onBehalfOfContentOwner в настоящее время является обязательным. Кроме того, в описание метода было внесено изменение, указывающее на то, что вызовы этого метода должны быть авторизованы учетной записью, связанной с владельцем контента YouTube.

9 февраля 2017 г.

В это обновление внесены следующие изменения:

  • Обновление существующих ресурсов и методов.

    • Новый параметр hl метода superChatEvents.list позволяет указать, что значение свойства snippet.displayString должно быть отформатировано в соответствии с правилами конкретного языка. Определение этого свойства также было соответствующим образом обновлено.

      Значение параметра должно быть кодом языка, включенным в список, возвращаемый методом i18nLanguages.list . Значение по умолчанию — en , что означает, что по умолчанию строки отображения форматируются так, как они использовались бы на английском языке. Например, по умолчанию строка форматируется как $1.00 , а не $1,00 .

1 февраля 2017 г.

В это обновление внесены следующие изменения:

  • Новые ресурсы и методы

    • Новый ресурс superChatEvent представляет собой сообщение Super Chat, приобретенное фанатом во время прямой трансляции на YouTube. В чате прямой трансляции на YouTube сообщения Super Chat выделяются среди других сообщений двумя способами:

      • Сообщения Super Chat выделены цветом.
      • Сообщения Super Chat остаются закрепленными в бегущей строке в течение определенного периода времени.

      Цвет сообщения Super Chat, время его закрепления в бегущей строке и максимальная длина сообщения определяются суммой покупки. Дополнительную информацию о Super Chat можно найти в Справочном центре YouTube .

      API поддерживает метод для вывода списка событий Super Chat для прямых трансляций канала за предыдущие 30 дней. Этот метод также возвращает данные о событиях Fan Funding ( fanFundingEvents ) из последней прямой трансляции канала.

  • Обновление существующих ресурсов и методов.

    • Свойство snippet.type теперь поддерживает значение superChatEvent , указывающее на то, что ресурс описывает Super Chat.

      Кроме того, новое свойство snippet.superChatDetails ресурса liveChatMessage и его дочерние элементы содержат информацию о событии Super Chat.

    • Свойство cdn.resolution ресурса liveStream теперь поддерживает значение 2160p .

  • Новые и обновленные ошибки

    • API поддерживает следующие новые типы ошибок:

      Подробности ошибки
      liveBroadcasts.insert , liveBroadcasts.update Методы liveBroadcasts.insert и liveBroadcasts.update возвращают ошибки 400 ( Bad Request ), указывающие на то, что вставляемый или обновляемый ресурс liveBroadcast содержит недопустимое значение для свойства contentDetails.enableEmbed или свойства contentDetails.projection . Причинами этих двух новых ошибок являются invalidEmbedSetting и invalidProjection соответственно.

12 января 2017 г.

Примечание: Это объявление об устаревании функции.

В связи с выпуском новой функции Super Chat , YouTube прекратил поддержку функции Fan Funding, и API Fan Funding будет отключен 28 февраля 2017 года. С этой даты:

11 августа 2016 г.

В это обновление внесены следующие изменения:

  • В недавно опубликованных Условиях использования сервисов YouTube API («Обновленные Условия»), подробно описанных в блоге YouTube для разработчиков , содержится множество обновлений к действующим Условиям использования. Помимо Обновленных Условий , которые вступят в силу с 10 февраля 2017 года, это обновление включает в себя несколько вспомогательных документов, помогающих разъяснить правила, которым должны следовать разработчики.

    Полный список новых документов описан в истории изменений обновленных условий . Кроме того, будущие изменения обновленных условий или соответствующих документов также будут объяснены в этой истории изменений. Вы можете подписаться на RSS-ленту с информацией об изменениях в истории изменений, перейдя по ссылке в этом документе.

20 мая 2016 г.

Теперь YouTube поддерживает прием данных по протоколу DASH. Соответственно, свойство ingestionType ресурса liveStream теперь поддерживает новое значение dash для идентификации потоков, принимаемых на YouTube с использованием протокола DASH.

Новое руководство «Доставка контента YouTube в прямом эфире через DASH» содержит рекомендации по использованию формата доставки DASH для потоковой передачи данных в прямом эфире на YouTube с помощью кодировщика. Оно призвано помочь производителям кодировщиков добавить поддержку доставки DASH в свои продукты.

18 апреля 2016 г.

В это обновление внесены следующие изменения:

  • Обновление существующих ресурсов и методов.

    • Обновления ресурсов liveStream

      • Теперь YouTube поддерживает потоковое вещание с разрешением 1440p при частоте кадров 30 или 60 кадров в секунду.

        Кроме того, ресурс liveStream содержит новые свойства для указания частоты кадров и разрешения входящих видеоданных:

        Характеристики
        cdn.frameRate Частота кадров входящих видеоданных. Допустимые значения: 30fps и 60fps .
        cdn.resolution Разрешение входящих видеоданных. Допустимые значения свойства: 1440p , 1080p , 720p , 480p , 360p и 240p .

      • В связи с введением свойств cdn.frameRate и cdn.resolution ресурса liveStream , свойство cdn.format теперь считается устаревшим. Свойство cdn.format задает разрешение и частоту кадров в одном значении.

        Мы рекомендуем вам перейти на использование новых поддерживаемых полей. Тем временем, cdn.format продолжает работать. Кроме того, запросы на вставку прямых трансляций в настоящее время выполняются успешно, если вы указываете значения либо для свойства cdn.format , либо для свойств cdn.frameRate и cdn.resolution . Если вы укажете значения для всех трех свойств, API может вернуть ошибку, если значения не совпадают.

        Обратите внимание, что, хотя свойство cdn.format устарело, оно теперь поддерживает два новых значения: 1440p и 1440p_hfr , что отражает поддержку API потоков 1440p со скоростью 30 или 60 кадров в секунду.

    • Обновления ресурсов liveBroadcast

      • Ресурс liveBroadcast содержит следующие новые свойства:

        Характеристики
        contentDetails.boundStreamLastUpdateTimeMs Дата и время последнего обновления прямой трансляции, на которую ссылается свойство contentDetails.boundStreamId .
        contentDetails.projection Формат проекции трансляции. Значение по умолчанию для этого параметра — rectangular . Допустимые значения для этого параметра: 360 и rectangular .

      • В определение свойства statistics.totalChatCount ресурса liveBroadcast внесены изменения, указывающие на то, что значение этого свойства отображается только в том случае, если трансляция содержит хотя бы одно сообщение в чате.

    • Обновления ресурсов liveChatMessage

      • Свойство snippet.type поддерживает два новых значения — messageDeletedEvent и userBannedEvent — которые соответствуют новым свойствам, описанным в следующем пункте. Определение свойства snippet.authorChannelId также было обновлено, чтобы объяснить, что обозначает значение этого свойства для этих новых типов сообщений.

      • Ресурс liveChatMessage содержит следующие новые свойства:

        Характеристики
        snippet.messageDeletedDetails Этот объект содержит информацию о сообщении, удалённом модератором чата. Объект присутствует только в том случае, если значение свойства snippet.type равно messageDeletedEvent .
        snippet.userBannedDetails Этот объект содержит информацию о пользователе, которому запрещено участвовать в чате. Объект также содержит информацию о самом запрете, а именно, является ли он постоянным или временным. Если запрет временный, одно из свойств объекта указывает продолжительность запрета.

        Этот объект присутствует только в том случае, если значение свойства snippet.type равно userBannedEvent .

  • Новые и обновленные ошибки

    • API поддерживает следующие новые типы ошибок:

      Подробности ошибки
      liveBroadcasts.bind Метод liveBroadcasts.bind возвращает ошибку 403 ( Forbidden ), указывающую на то, что пользователь отправил слишком много запросов за заданный промежуток времени. Причина ошибки — userRequestsExceedRateLimit .

      Методы liveBroadcasts.insert и liveBroadcasts.update уже поддерживают обработку этой ошибки.
      liveStreams.insert Метод liveStreams.insert поддерживает четыре новые ошибки 400 ( Bad Request ), указывающие на недопустимое значение свойства в ресурсе liveStream , которое было пыталось вставить в запрос. Ниже приведен список причин ошибок и свойств, с которыми они связаны:
      liveStreams.insert Метод liveStreams.insert поддерживает две новые ошибки 400 ( Bad Request ), каждая из которых указывает на отсутствие необходимого значения в ресурсе liveStream , который запрашивался для вставки. Ниже приведен список причин ошибок и свойств, с которыми они связаны:
      В частности, при добавлении ресурса liveStream необходимо указать значение либо для свойства cdn.format , либо для свойств cdn.frameRate и cdn.resolution .
      • API возвращает ошибку formatRequired , если вы не указываете значение ни для одного из трех свойств.
      • API возвращает ошибку frameRateRequired если вы указываете значение для cdn.resolution , но не для cdn.frameRate .
      • API возвращает ошибку resolutionRequired если вы указываете значение для cdn.frameRate , но не для cdn.resolution .
      liveStreams.update Метод liveStreams.update возвращает ошибку 403 ( Forbidden ), если запрос пытается изменить значение любого из следующих неизменяемых свойств: В сообщении об ошибке указана reason : liveStreamModificationNotAllowed .

18 декабря 2015 г.

Законодательство Европейского союза (ЕС) требует предоставления определенной информации конечным пользователям в ЕС и получения их согласия. Поэтому конечным пользователям в Европейском союзе необходимо соблюдать Политику ЕС о согласии пользователей . Мы добавили уведомление об этом требовании в наши Условия использования API YouTube .

17 декабря 2015 г.

В это обновление внесены следующие изменения:

  • Новые ресурсы и методы

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

      Ресурсы
      liveChatMessage Этот ресурс представляет собой сообщение в чате прямой трансляции YouTube. YouTube поддерживает несколько типов сообщений, включая текстовые сообщения и сообщения о мероприятиях по сбору средств от фанатов. Некоторые типы сообщений идентифицируют определенный этап чата, например, начало периода только для спонсоров или конец чата. API поддерживает методы для отображения, добавления и удаления сообщений в чате прямой трансляции.
      liveChatModerators Этот ресурс идентифицирует модератора чата. Модераторы могут выполнять некоторые административные функции, такие как блокировка пользователей в чате или удаление сообщений. API поддерживает методы для отображения списка, добавления и удаления модераторов чата.
      liveChatBans Этот ресурс идентифицирует пользователя, которому запрещено публиковать сообщения в определенном онлайн-чате. Блокировка может быть временной или постоянной. API поддерживает методы для добавления и удаления блокировок в онлайн-чате.
      fanFundingEvents Этот ресурс представляет собой пример кампании по сбору средств от поклонников на YouTube-канале. Такая кампания позволяет зрителям добровольно поддержать авторов контента на YouTube единовременной денежной помощью.

      Метод fanFundingEvents.list в API отображает список событий, связанных с привлечением средств от поклонников канала. События, инициированные через чат во время прямой трансляции, принадлежащей каналу, также отправляют сообщение fanFundingEvent в чат прямой трансляции.

      Подробнее о финансировании от фанатов можно узнать в Справочном центре YouTube .
      sponsors Ресурс sponsor идентифицирует спонсора YouTube-канала. Спонсор платит каналу ежемесячную абонентскую плату. Рядом с сообщениями спонсора в прямых чатах канала отображается значок, а спонсоры также могут участвовать в прямых чатах, предназначенных исключительно для спонсоров канала, если таковые проводятся.

      Метод ` sponsors.list API выводит список спонсоров канала. Когда пользователи регистрируются в качестве спонсоров канала во время прямой трансляции, принадлежащей этому каналу, API также добавляет сообщение newSponsorEvent в чат прямой трансляции.

      Подробнее о спонсорстве можно узнать в Справочном центре YouTube .

  • Updates to existing resources and methods

    • The liveBroadcast resource contains the following new properties:

      Характеристики
      snippet.liveChatId The ID for the broadcast's YouTube live chat. With this ID, you can use the liveChatMessage resource's methods to retrieve, insert, or delete chat messages. You can also add or remove chat moderators, ban users from participating in live chats, or remove existing bans.
      contentDetails.closedCaptionsType Note: This property replaces the contentDetails.enableClosedCaptions property.

      This property indicates whether closed captioning is enabled for your broadcast and, if so, what type of closed captions you are providing:
      • closedCaptionsDisabled : Closed captions are disabled for the live broadcast.
      • closedCaptionsHttpPost : You will send captions, via HTTP POST, to an ingestion URL associated with your live stream.
      • closedCaptionsEmbedded : Captions will be encoded in the video stream using EIA-608 and/or CEA-708 formats.
      contentDetails.enableClosedCaptions This property has been deprecated as of December 17, 2015. Use the contentDetails.closedCaptionsType property instead. For API clients that are already using this property:
      • Setting the property value to true is equivalent to setting the contentDetails.closedCaptionsType property to closedCaptionsHttpPost .
      • Setting the property value to false is equivalent to setting the contentDetails.closedCaptionsType property to closedCaptionsDisabled .

    • The liveBroadcasts.list method's new broadcastType parameter lets you filter an API response to include event broadcasts, persistent broadcasts, or all broadcasts.

      A persistent broadcast is one that always exists and is not tied to a particular event. Specifically, a channel's default broadcast is a persistent broadcast, and it is accessible via the Live Dashboard in the YouTube Creator Studio. The channel's other broadcasts are event broadcasts.

  • The liveStream resource's status.healthStatus.configurationIssues[].type field reports the following new health status errors:

    Ошибки
    audioTooManyChannels The audio has more than two channels, but only one (mono) or two (stereo) channels are supported. Please correct the number of audio channels.
    frameRateHigh The current framerate is too high. Please set the framerate to %(framerate)s fps or less.

  • The publication date of the previous documentation update was corrected.

  • New and updated errors

    • In addition to errors defined for the new resources listed above, the API supports the following new errors:

      Подробности ошибки
      liveBroadcasts.update
      HTTP Response Code forbidden (403)
      Причина closedCaptionsTypeModificationNotAllowed
      Описание The contentDetails.closedCaptionsType value can only be modified when the broadcast is in the created or ready status.
      liveBroadcasts.update
      HTTP Response Code invalidValue (400)
      Причина invalidEnableClosedCaptions
      Описание In the liveBroadcast resource , the value of the contentDetails.enableClosedCaptions property is incompatible with the value of the contentDetails.closedCaptionType setting. Modify the resource to only include one of the two properties, and then resubmit the request.

August 19, 2015

This update contains the following changes:

  • New resources and methods

    • Note: Documentation for the liveChat resource and its methods is confidential and only visible to select YouTube partners.

      The new liveChat resource contains a comment posted during a live broadcast on YouTube. The API supports two methods for this resource:

      Методы
      liveChats.list List live chat messages for a broadcast.
      liveChats.insert Create a new chat message.

      Live chat messages can only be retrieved and posted while a broadcast is live.

  • Updates to existing resources and methods

    • The liveStream resource contains the following new properties:

      Характеристики
      snippet.isDefaultStream Indicates whether this stream is the default stream for the channel. A channel's default stream exists indefinitely, does not have a start or end time associated with it, and cannot be deleted. See the property's definition for more information about how default streams work.
      status.healthStatus This object contains information that could be used to identify, diagnose and resolve streaming problems. The object contains a number of child properties to help you evaluate the health of a live video stream.

      In particular, the status.healthStatus.configurationIssues[] object lists issues affecting a video stream. A new document, Configuration Issues for LiveStream Resources , lists all of the issues that the API reports.
      contentDetails.isReusable Indicates whether the stream is reusable, which means that it can be bound to multiple broadcasts. It is common for broadcasters to reuse the same stream for many different broadcasts if those broadcasts occur at different times.

    • The liveBroadcast resource contains the following new properties:

      Характеристики
      snippet.isDefaultBroadcast Indicates whether this broadcast is the default broadcast for the channel. When a YouTube channel is enabled for live streaming, YouTube creates a default stream and a default broadcast for the channel. The stream defines how the channel owner sends live video to YouTube, and the broadcast is how viewers can see the default stream. See the property's definition for more information about how default broadcasts work.
      contentDetails.enableLowLatency Indicates whether this broadcast should be encoded for low-latency streaming. A low-latency stream can reduce the amount of time it takes for video to be visible to users watching a broadcast, though it can also impact the resolution for viewers of the stream.
      statistics.totalChatCount The total number of live chat messages associated with the broadcast. The property and its value are present if the broadcast is visible to the user and has the live chat feature enabled. Note that this property will not specify a value after the broadcast ends. So, this property would not identify the number of chat messages for an archived video of a completed live broadcast.

  • New and updated errors

    • In addition to errors defined for the new liveChat resource, the API supports the following new error:

      Подробности ошибки
      liveStreams.update
      HTTP Response Code forbidden (403)
      Причина liveStreamModificationNotAllowed
      Описание The API does not allow you to change a reusable stream to be non-reusable, or vice versa. For more information, see Understanding Broadcasts and Streams

May 21, 2015

This update contains the following changes:

  • YouTube now supports live video streaming at 60 frames per second (fps), which means smoother playback for gaming and other fast-action videos. When you start a live stream on YouTube at 60fps, YouTube also makes the stream available in 30fps on devices where high-frame-rate viewing is not yet available.

    The liveStream resource's cdn.format property supports two new values for this feature: 720p_hfr and 1080p_hfr .

    See the YouTube Creators Blog for more information about this feature.

21 августа 2014 г.

This update contains the following changes:

  • The definition of the liveBroadcasts.control method's walltime parameter has been updated to note that the property value is specified in ISO 8601 format ( YYYY-MM-DDThh:mm:ss.sssZ ).

  • The API now supports the following errors:

    Error type Error detail Описание
    insufficientPermissions liveStreamingNotEnabled All methods for the liveBroadcast and liveStream resources return this error if the user that authorized the API request has not been enabled to stream live video on YouTube. Details explaining why the user cannot stream live video may be available in the user's channel settings at https://www.youtube.com/features .
    rateLimitExceeded userRequestsExceedRateLimit The liveBroadcasts.insert and liveStreams.insert methods both return this error to indicate that the user has sent too many requests within a given timeframe.

May 2, 2014

This update contains the following changes:

  • The descriptions of the liveStream resource and of the liveBroadcasts.bind method have been updated to note that a broadcast can only be bound to one video stream, but a video stream can be bound to more than one broadcast. This change is solely a correction to the documentation; the underlying API functionality has not changed.

  • The liveBroadcast resource's contentDetails.monitorStream.enableMonitorStream property has been updated to explain that if the property's value is true , then you must transition your broadcast to the testing state before you can transition it to the live state. (If the property's value is false , your broadcast cannot have a testing stage, so you can transition the broadcast directly to the live state.

  • The liveCuepoint resource's settings.offsetTimeMs property has been updated to note that you should not specify a value for the property if your broadcast does not have a monitor stream.

  • All of the methods for the liveBroadcast and liveStream resources now support the onBehalfOfContentOwner and onBehalfOfContentOwnerChannel parameters. These parameters allow you to use the same authorization credentials to complete API requests for different channels associated with the same content owner.

  • The liveCuepoints.insert method's documentation has been updated to note that you can set a value for the settings.walltime property when calling that method.

  • The error documentation now specifies the HTTP response code for each error type.

  • The API now supports the following error:

    Error type Error detail Описание
    insufficientPermissions livePermissionBlocked The liveBroadcasts.insert , liveBroadcasts.transition , and liveStreams.insert methods return this error if the user that authorized the request is unable to stream live video on YouTube. Details explaining why the user cannot stream live video may be available in the user's channel settings at https://www.youtube.com/features .

  • The liveBroadcasts.insert method's invalidScheduledStartTime error has been updated to clarify that the scheduled start time must be close enough to the current date that a broadcast could be reliably scheduled at that time.

13 декабря 2013 г.

This update contains the following changes:

  • The liveBroadcast resource's new status.recordingStatus property identifies the broadcast's current status.

  • The liveBroadcast resource's new contentDetails.enableClosedCaptions property indicates whether closed captions can be ingested for the broadcast. The property value can be set when you insert or update a broadcast, but it cannot be updated once the broadcast is in the testing or live state. If you set this property to true , then the liveStream resource that is bound to the broadcast will specify the ingestion URL to use for the broadcast's closed captions.

  • The liveBroadcast resource's snippet.scheduledEndTime property now supports broadcasts that are scheduled to continue indefinitely. With this change, the property is no longer required in liveBroadcasts.insert and liveBroadcasts.update requests.

    If you retrieve a liveBroadcast resource that does not specify a value for this property, then the broadcast is scheduled to continue indefinitely. Similarly, if you call the liveBroadcasts.insert or liveBroadcasts.update method and do not specify a value for this property, the broadcast will be scheduled to continue indefinitely.

  • The liveBroadcast resource's contentDetails.recordFromStart property, which already had a default value of true , can now only be set to false if the broadcasting channel is allowed to disable recordings for live broadcasts.

    If your channel does not have permission to disable recordings, and you attempt to insert a broadcast with the recordFromStart property set to false , the API will return a Forbidden error. In addition, if your channel does not have that permission and you attempt to update a broadcast to set the recordFromStart property to false , the API will return a modificationNotAllowed error.

  • The liveBroadcast resource no longer contains an enableArchive property, which had been mentioned in the descriptions of the contentDetails.enableDvr and contentDetails.enableEmbed properties.

  • The list of valid values for the liveBroadcast resource's status.lifeCycleStatus property has been updated to include a description of each status.

  • The liveCuepoint resource's new settings.walltime property specifies the date and time at which the cuepoint should be inserted. The API returns an error if a request tries to insert a cuepoint that specifies a value for this property and for the settings.offsetTimeMs property.

  • The new contentDetails object in a liveStream resource contains information about the stream. Currently, the object's only property is contentDetails.closedCaptionsIngestionUrl , which specifies the ingestion URL for closed captions associated with the video stream.

  • The list of valid values for the liveStream resource's status.streamStatus property has been updated to include a description of each status.

  • The liveBroadcasts.control method's new walltime parameter lets you specify the date and time when a slate change will occur. The API returns an error if a request specifies a value for this parameter and for the offsetTimeMs parameter.

  • In the API response to a liveBroadcasts.list request, the value of the kind property has changed from youtube#liveBroadcastList to youtube#liveBroadcastListResponse .

  • In the API response to a liveStreams.list request, the value of the kind property has changed from youtube#liveStreamList to youtube#liveStreamListResponse .

  • The eventId property has been deprecated from both the liveBroadcastListResponse and the liveStreamListResponse .

  • The API supports the following new errors:

    Error type Error detail Описание
    invalidValue conflictingTimeFields The liveBroadcasts.control method returns this error if your request specifies values for the offsetTimeMs and walltime parameters. A request can either omit both parameters or specify a value for one of the two parameters.
    invalidValue invalidWalltime The liveBroadcasts.control method returns this error if the walltime parameter's value is invalid.
    forbidden enableClosedCaptionsModificationNotAllowed The liveBroadcasts.update method returns this error if you attempt to update the contentDetails.enableClosedCaptions value and the broadcast's status is not created or ready .
    invalidValue conflictingTimeFields The liveCuepoints.insert method returns this error if your request specifies values for the settings.offsetTimeMs and settings.walltime properties. A request can either omit both properties or specify a value for one of the two properties.

    In addition, the liveStreams.update method no longer supports a cdnRequired error similar to the one that the liveStreams.insert method supports.

May 10, 2013

This update contains the following changes:

May 2, 2013

This update contains the following changes:

March 27, 2013

This update contains the following changes:

  • The following properties have changed in the liveBroadcast resource:

    • The startWithSlateCuepoint property has been renamed to startWithSlate .
    • The enableArchive property has been renamed to recordFromStart .
    • The slateSettings object has been deprecated and removed from the documentation. Error messages related to the slateSettings object or its properties have also been removed. Finally, the "Displaying Slates" section of the Getting started guide has been removed.

  • The API no longer supports the ability to insert in-stream slates using the liveCuepoints.insert method. The following documents have been updated to reflect this change:

    • The index page , Getting started guide, and Life of a broadcast tutorial no longer mention this functionality.

    • The liveCuepoint resource's settings.cueType property no longer supports slate as a property value. (The only supported value is ad .

    • The liveCuepoint resource's settings.eventState property has been deprecated and removed from the documentation.

March 18, 2013

This update contains the following changes:

  • All of the API's error messages have been updated to more clearly explain possible errors and, when possible, offer guidance about how to fix them.

  • The API may now return several new errors. The list below identifies the error and the API method that might return that error:

    • liveBroadcasts.insert – A broadcast's scheduled end time must be after its scheduled start time.
    • liveBroadcasts.insert – The broadcast specifies an invalid privacy status.
    • liveBroadcasts.update – The resource does not contain or does not set a value for the contentDetails.enableArchive property.
    • liveBroadcasts.update – The resource does not contain or does not set a value for the contentDetails.enableContentEncryption property.
    • liveBroadcasts.update – The resource does not contain or does not set a value for the contentDetails.enableDvr property.
    • liveStreams.insert – The snippet title must be between 1 and 128 characters long.
    • liveStreams.update – The resource does not contain or does not set a value for the snippet.title property.

  • The liveStream resource documentation has been updated to reflect that multicast and WebM are not supported ingestion methods as previously indicated. The list of formats for the cdn.format property has been updated accordingly, and the cdn.multicastIngestionInfo object and its child properties have been removed from the resource's documentation. In addition, http has been removed from the list of supported cdn.ingestionType values.