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

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

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 и его дочерние элементы содержат информацию о событии Gift Membership Получено.

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

Это обновление содержит следующие изменения:

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

    • newSponsorEvent
    • memberMilestoneChatEvent

  • Новое свойство snippet.memberMilestoneChatDetails ресурса liveChatMessage и его дочерние элементы содержат информацию о событии Member Milestone Chat. Аналогично, новое свойство 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 года или после этой даты. После этой даты все вызовы этого метода будут возвращать запрещенную ошибку (403), а позже метод будет полностью удален. Клиенты по-прежнему могут реализовать собственное планирование, добавив наложение к видео, отправленному на серверы приема YouTube.

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

17 июля 2020 г.

Примечание. Это обновление предыдущего объявления об прекращении поддержки.

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

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

6 июля 2020 г.

Руководство по доставке живого контента YouTube через HLS было обновлено с некоторыми изменениями:

  • Рекомендуемая продолжительность медиасегмента была обновлена ​​до одной-четырех секунд.
  • В новом разделе объясняется, как получить URL-адрес приема HLS из YouTube Creator Studio .
  • Инструкции по форматированию значения параметра file были перенесены в новый раздел «Завершение URL-адреса приема HLS» . Эти инструкции применимы независимо от того, получен ли URL-адрес приема HLS из API YouTube или из YouTube Creator Studio.

Кроме того, в новом сравнении протоколов приема перечислены протоколы приема, которые поддерживает 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 . Дополнительную информацию о новом ресурсе можно найти в истории изменений API данных YouTube .

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 .

Мы также обновили Условия использования API-сервисов YouTube и Политику для разработчиков. Дополнительную информацию см. в Условиях использования API-сервисов YouTube — История изменений . Изменения в Условиях использования API-сервисов YouTube и Правилах для разработчиков вступят в силу 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» позволяет выбирать области авторизации, вводить образцы значений параметров и свойств, а затем отправлять фактические запросы API и просматривать фактические ответы API. Виджет также предлагает полноэкранное представление, в котором показаны полные примеры кода, которые динамически обновляются для использования введенных вами областей и значений.

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

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

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

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

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

25 февраля 2019 г.

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

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

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 представляет собой сообщение Суперчата, приобретенное фанатом во время прямой трансляции на YouTube. В прямом эфире чата YouTube суперчаты выделяются среди других сообщений по двум причинам:

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

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

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

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

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

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

    • Свойство 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 г.

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

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

11 августа 2016 г.

Это обновление содержит следующие изменения:

  • Недавно опубликованные Условия использования API-сервисов YouTube («Обновленные условия»), подробно обсуждаемые в блоге разработчиков и разработчиков 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 Этот ресурс представляет собой мероприятие Fan Funding на канале YouTube. Функция «Фан-фандинг» дает зрителям возможность добровольно поддержать авторов YouTube единовременной денежной поддержкой.

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

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

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

      Подробную информацию о спонсорстве можно найти в Справочном центре YouTube .

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

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

      Характеристики
      snippet.liveChatId Идентификатор живого чата YouTube трансляции. С помощью этого идентификатора вы можете использовать методы ресурса liveChatMessage для получения, вставки или удаления сообщений чата. Вы также можете добавлять или удалять модераторов чата, запрещать пользователям участвовать в чатах или снимать существующие запреты.
      contentDetails.closedCaptionsType ПРИМЕЧАНИЕ. Это свойство заменяет свойство contentDetails.enableClosedCaptions .

      Это свойство указывает, включена ли закрытая подпись для вашей трансляции, и, если да, то какой тип закрытых подписей вы предоставляете:
      • closedCaptionsDisabled : Закрытые подписи отключены для живой трансляции.
      • closedCaptionsHttpPost : вы отправите подписи через HTTP Post, в URL -адрес приема, связанный с вашим живым потоком.
      • closedCaptionsEmbedded .
      contentDetails.enableClosedCaptions Это собственность устарела по состоянию на 17 декабря 2015 года. Вместо этого используйте свойство contentDetails.closedCaptionsType . Для клиентов API, которые уже используют это свойство:
      • Установка значения свойства на true эквивалентно установлению свойства contentDetails.closedCaptionsType в closedCaptionsHttpPost .
      • Установка значения свойства на false эквивалентно установлению свойства contentDetails.closedCaptionsType в closedCaptionsDisabled .

    • Новый broadcastType метода liveBroadcasts.list Метод позволяет вам отфильтровать ответ API, чтобы включить трансляции событий, постоянные трансляции или все трансляции.

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

  • Статус Resource liveStream status.healthStatus.configurationIssues[].type Филд сообщает о следующих новых ошибках состояния здоровья:

    Ошибки
    audioTooManyChannels Аудио имеет более двух каналов, но поддерживаются только один (моно) или два (стерео) канала. Пожалуйста, исправьте количество аудиоканалов.
    frameRateHigh Текущая частота кадров слишком высока. Пожалуйста, установите кадрину на %(framerate)s FPS или меньше.

  • Дата публикации предыдущей обновления документации была исправлена.

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

    • В дополнение к ошибкам, определенным для новых ресурсов, перечисленных выше, API поддерживает следующие новые ошибки:

      Детали ошибки
      liveBroadcasts.update
      Код ответа HTTP forbidden (403)
      Причина closedCaptionsTypeModificationNotAllowed
      Описание Значение contentDetails.closedCaptionsType может быть изменено только тогда, когда трансляция находится в статусе created или ready .
      liveBroadcasts.update
      Код ответа HTTP invalidValue (400)
      Причина invalidEnableClosedCaptions
      Описание В ресурсе LiveBroadcast стоимость свойства contentDetails.enableClosedCaptions несовместимо со значением настройки contentDetails.closedCaptionType . Измените ресурс, чтобы включить только одно из двух свойств, а затем повторно подайте запрос.

19 августа 2015

Это обновление содержит следующие изменения:

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

    • Примечание. Документация для ресурса liveChat и его методов является конфиденциальной и видимой только для выбора партнеров YouTube.

      Новый ресурс liveChat содержит комментарий, опубликованный во время живой трансляции на YouTube. API поддерживает два метода для этого ресурса:

      Методы
      liveChats.list Перечислите живые сообщения чата для трансляции.
      liveChats.insert Создайте новое сообщение чата.

      Сообщения в чате могут быть получены только и опубликованы, пока трансляция в прямом эфире.

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

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

      Характеристики
      snippet.isDefaultStream Указывает, является ли этот поток потоком по умолчанию для канала. Поток по умолчанию канала существует на неопределенный срок, не связан с началом или окончанием, связанным с ним и не может быть удален. Смотрите определение свойства для получения дополнительной информации о том, как работают потоки по умолчанию.
      status.healthStatus Этот объект содержит информацию, которая может быть использована для выявления, диагностики и решения проблем потоковой передачи. Объект содержит ряд дочерних свойств, чтобы помочь вам оценить здоровье живого видеопотока.

      В частности, status.healthStatus.configurationIssues[] Объект перечисляет проблемы, влияющие на видеопоток. В новом документе, вопросах конфигурации для ресурсов в прямые трансляции перечислены все проблемы, о которых сообщает API.
      contentDetails.isReusable Указывает, является ли поток повторно используемым, что означает, что он может быть связан с несколькими трансляциями. Для вещателей часто используется один и тот же поток для многих различных трансляций, если эти трансляции происходят в разное время.

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

      Характеристики
      snippet.isDefaultBroadcast Указывает, является ли эта трансляция трансляцией по умолчанию для канала. Когда канал YouTube включен для трансляции в прямом эфире, YouTube создает поток по умолчанию и трансляцию по умолчанию для канала. Поток определяет, как владелец канала отправляет живое видео на YouTube, и трансляция - это то, как зрители могут увидеть поток по умолчанию. См. Определение свойства для получения дополнительной информации о том, как работают трансляции по умолчанию.
      contentDetails.enableLowLatency Указывает, должна ли эта трансляция быть закодирована для потоковой передачи с низкой задержкой. Поток с низкой задержкой может сократить количество времени, необходимого для видео, чтобы быть видимым пользователям, наблюдающим за трансляцией, хотя он также может повлиять на разрешение для зрителей потока.
      statistics.totalChatCount Общее количество сообщений в чате, связанных с трансляцией. Свойство и его значение присутствуют, если трансляция видна пользователю и включена функция чата в прямом эфире. Обратите внимание, что это свойство не будет указывать значение после окончания трансляции. Таким образом, это свойство не будет определять количество сообщений чата для архивного видео за завершенную прямую трансляцию.

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

    • В дополнение к ошибкам, определенным для нового ресурса liveChat , API поддерживает следующую новую ошибку:

      Детали ошибки
      liveStreams.update
      Код ответа HTTP forbidden (403)
      Причина liveStreamModificationNotAllowed
      Описание API не позволяет вам изменить повторный поток, чтобы быть невозвратным, или наоборот. Для получения дополнительной информации см. Понимание трансляций и потоков

21 мая 2015 года

Это обновление содержит следующие изменения:

  • YouTube теперь поддерживает потоковое видео в прямом эфире со скоростью 60 кадров в секунду (FPS), что означает более плавное воспроизведение для игр и других быстрых видеороликов. Когда вы запускаете живой поток на YouTube со скоростью 60 кадров в секунду, YouTube также предоставляет поток доступным в 30 кадров в секунду на устройствах, где просмотр высокой частоты скорости еще недоступен.

    Свойство cdn.format от liveStream поддерживает два новых значения для этой функции: 720p_hfr и 1080p_hfr .

    Смотрите блог «Создатели YouTube» для получения дополнительной информации об этой функции.

21 августа 2014 года

Это обновление содержит следующие изменения:

  • Определение параметра The liveBroadcasts.control walltime было обновлено, чтобы отметить, что значение свойства указано в формате ISO 8601 ( YYYY-MM-DDThh:mm:ss.sssZ ).

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

    Тип ошибки Деталь ошибки Описание
    insufficientPermissions liveStreamingNotEnabled Все методы для ресурсов liveBroadcast и liveStream возвращают эту ошибку, если пользователь, который разрешил запрос API, не был включен для потокового видео на YouTube. Подробная информация, объясняющая, почему пользователь не может транслировать живое видео, может быть доступно в настройках канала пользователя по адресу https://www.youtube.com/features .
    rateLimitExceeded userRequestsExceedRateLimit liveBroadcasts.insert и liveStreams.insert Methods возвращают эту ошибку, чтобы указать, что пользователь отправил слишком много запросов в течение определенного периода времени.

2 мая 2014 года

Это обновление содержит следующие изменения:

  • Описания ресурса liveStream и метода liveBroadcasts.bind были обновлены, чтобы отметить, что трансляция может быть связана только с одним видеопотоком, но видеопоток может быть связан с более чем одной трансляцией. Это изменение является исключительно коррекцией к документации; Основная функция API не изменилась.

  • contentDetails.monitorStream.enableMonitorStream live liveBroadcast true testing (Если стоимость свойства false , ваша трансляция не может иметь этапа testing , поэтому вы можете перевести трансляцию непосредственно в live состояние.

  • settings.offsetTimeMs ресурса liveCuepoint .

  • Все методы для ресурсов liveBroadcast и liveStream теперь поддерживают параметры onBehalfOfContentOwner и onBehalfOfContentOwnerChannel . Эти параметры позволяют вам использовать те же учетные данные авторизации для выполнения запросов API для различных каналов, связанных с одним и тем же владельцем контента.

  • Документация метода liveCuepoints.insert была обновлена, чтобы отметить, что вы можете установить значение для свойства settings.walltime . Walltime при вызове этого метода.

  • В документации ошибок теперь указывается код ответа HTTP для каждого типа ошибки.

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

    Тип ошибки Деталь ошибки Описание
    insufficientPermissions livePermissionBlocked liveBroadcasts.insert , liveBroadcasts.transition и liveStreams.insert Методы возвращают эту ошибку, если пользователь, который авторизовал запрос, не может транслировать видео на YouTube. Подробная информация, объясняющая, почему пользователь не может транслировать живое видео, может быть доступно в настройках канала пользователя по адресу https://www.youtube.com/features .

  • Ошибка liveBroadcasts.insert Method invalidScheduledStartTime была обновлена, чтобы уточнить, что запланированное время начала должно быть достаточно близко к текущей дате, что трансляция может быть надежно запланирована в то время.

13 декабря 2013 года

Это обновление содержит следующие изменения:

  • Новый status.recordingStatus ресурса liveBroadcast .

  • Новый contentDetails.enableClosedCaptions 's Property stocteD.DableClosedCaptions от liveBroadcast указывает, можно ли проглотить закрытые подписи для трансляции. Значение свойства может быть установлено при внедрении или обновлении трансляции, но его нельзя обновить, как только трансляция будет в testing или в live эфире. Если вы установите это свойство в true , то ресурс liveStream , который связан с трансляцией, будет указывать URL -адрес приема для использования для закрытых подписей трансляции.

  • snippet.scheduledEndTime от liveBroadcast Resource.schedudEndtime теперь поддерживает трансляции, которые должны продолжаться бесконечно. С этим изменением собственность больше не требуется в liveBroadcasts.insert и liveBroadcasts.update запросы.

    Если вы получаете ресурс liveBroadcast , который не указывает значение для этого свойства, то трансляция планирует продолжаться бесконечно. Аналогичным образом, если вы позвоните в liveBroadcasts.insert или liveBroadcasts.update и не указываете значение для этого имущества, трансляция будет запланирован на неопределенный срок.

  • false 's contentDetails.recordFromStart true liveBroadcast Resource Resourcast.

    Если ваш канал не имеет разрешения на отключение записей, и вы пытаетесь вставить трансляцию со свойством recordFromStart установленного в false , API вернет Forbidden ошибку. Кроме того, если ваш канал не имеет такого разрешения, и вы пытаетесь обновить трансляцию, чтобы установить свойство recordFromStart в false , API вернет modificationNotAllowed .

  • Ресурс liveBroadcast больше не содержит enableArchive свойство, которое было упомянуто в описаниях contentDetails.enableDvr и contentDetails.enableEmbed Properties.

  • Список действительных значений для status.lifeCycleStatus liveBroadcast Resource.

  • Новые settings.walltime ресурса liveCuepoint . API возвращает ошибку, если запрос пытается вставить Cuepoint, которая указывает значение для этого свойства, и для settings.offsetTimeMs .

  • Новый объект contentDetails в ресурсе liveStream содержит информацию о потоке. В настоящее время единственным свойством объекта является contentDetails.closedCaptionsIngestionUrl , который определяет URL -адрес приема для закрытых подписей, связанных с видеопотоком.

  • Список действительных значений для status.streamStatus liveStream Resource.

  • Новый параметр walltime метода liveBroadcasts.control позволяет указать дату и время, когда произойдет изменение сланца. API возвращает ошибку, если запрос определяет значение для этого параметра и для параметра offsetTimeMs .

  • В ответе API на запрос liveBroadcasts.list стоимость имущества kind собственности изменилась с youtube#liveBroadcastList на youtube#liveBroadcastListResponse .

  • youtube#liveStreamList ответе API kind запрос liveStreams.list youtube#liveStreamListResponse

  • Собственность eventId была устарел как от liveBroadcastListResponse так и из liveStreamListResponse .

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

    Тип ошибки Деталь ошибки Описание
    invalidValue conflictingTimeFields Метод liveBroadcasts.control возвращает эту ошибку, если ваш запрос определяет значения для offsetTimeMs и параметров walltime . Запрос может либо опустить оба параметра, либо указать значение для одного из двух параметров.
    invalidValue invalidWalltime Метод liveBroadcasts.control возвращает эту ошибку, если значение параметра walltime неверно.
    forbidden enableClosedCaptionsModificationNotAllowed Метод liveBroadcasts.update возвращает эту ошибку, если вы попытаетесь обновить значение contentDetails.enableClosedCaptions , а статус трансляции не created или ready .
    invalidValue conflictingTimeFields Метод liveCuepoints.insert возвращает эту ошибку, если ваш запрос определяет значения для settings.offsetTimeMs и settings.walltime . Запрос может либо опустить как свойства, либо указать значение для одного из двух свойств.

    Кроме того, метод liveStreams.update больше не поддерживает ошибку cdnRequired , аналогичную той, которую поддерживает метод liveStreams.insert .

10 мая 2013 года

Это обновление содержит следующие изменения:

2 мая 2013 года

Это обновление содержит следующие изменения:

27 марта 2013 года

Это обновление содержит следующие изменения:

  • Следующие свойства изменились в ресурсе liveBroadcast :

    • Свойство startWithSlateCuepoint была переименована в startWithSlate .
    • Собственность enableArchive была переименована в recordFromStart .
    • Объект slateSettings был устарел и удален из документации. Сообщения об ошибках, связанные с объектом slateSettings или его свойствами, также были удалены. Наконец, раздел «отображения сланцев» в руководстве по началу работы была удалена.

  • API больше не поддерживает способность вставлять встроенные сланцы с использованием метода liveCuepoints.insert . Следующие документы были обновлены, чтобы отразить это изменение:

18 марта 2013 года

Это обновление содержит следующие изменения:

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

  • API теперь может вернуть несколько новых ошибок. Список ниже идентифицирует ошибку и метод API, который может вернуть эту ошибку:

    • liveBroadcasts.insert - запланированное время завершения трансляции должно быть после запланированного времени начала.
    • liveBroadcasts.insert - The Redcast определяет неверный статус конфиденциальности.
    • liveBroadcasts.update - ресурс не содержит или не устанавливает значение для свойства contentDetails.enableArchive .
    • liveBroadcasts.update - ресурс не содержит или не устанавливает значение для свойства contentDetails.enableContentEncryption .
    • liveBroadcasts.update - ресурс не содержит или не устанавливает значение для свойства contentDetails.enableDvr .
    • liveStreams.insert - заголовок фрагмента должен составлять от 1 до 128 символов.
    • liveStreams.update - ресурс не содержит или не устанавливает значение для свойства snippet.title .

  • Документация по ресурсам liveStream была обновлена, чтобы отразить, что многоадресная рассылка и WebM не поддерживаются методами приема питания, как указано ранее. Список форматов для свойства cdn.format был обновлен соответственно, и объект cdn.multicastIngestionInfo и его свойства дочерних свойств были удалены из документации ресурса. Кроме того, http был удален из списка поддерживаемых значений cdn.ingestionType .