API YouTube Live Streaming – Historique des révisions

Cette page liste les modifications apportées à l'API YouTube Live Streaming et les mises à jour de la documentation.

12 octobre 2026

Cette mise à jour inclut les changements suivants :

18 août 2026

Cette mise à jour inclut les changements suivants :

  • La documentation de la méthode liveBroadcasts.update a été mise à jour pour inclure de nouvelles erreurs liées à la monétisation : preconditionFailed (412) (motif : videoNotEligibleForAdsMonetization) et backendError (503) (motif : backendError).

17 août 2026

Cette mise à jour inclut les changements suivants :

  • La nouvelle propriété snippet.categoryId de la ressource liveBroadcast vous permet de définir, de modifier et de récupérer la catégorie de la vidéo associée à une diffusion en direct.

20 juillet 2026

Cette mise à jour inclut les changements suivants :

9 juillet 2026

Cette mise à jour inclut les changements suivants :

1er juin 2026

Cette mise à jour inclut les changements suivants :

  • La propriété contentDetails.availabilityConfig de la ressource liveBroadcast vous permet de spécifier des restrictions géographiques pour une diffusion en direct. Vous pouvez ainsi gérer la disponibilité régionale des événements en direct.

26 mars 2026

Cette mise à jour inclut les changements suivants :

  • La propriété snippet.type accepte désormais la nouvelle valeur giftEvent.

  • La nouvelle propriété snippet.giftEventDetails de la ressource liveChatMessage et ses enfants contiennent des informations sur l'événement de cadeau.

12 janvier 2026

L'API permet désormais d'activer les mid-rolls et l'insertion automatique de mid-rolls pour les diffusions en direct.

Le propriétaire de la diffusion peut choisir d'activer les mid-rolls pour une diffusion, à condition qu'elle soit éligible. Le propriétaire peut également désactiver les mid-rolls pour une diffusion à tout moment.

Si les mid-rolls sont activés pour une diffusion, le propriétaire de la diffusion peut choisir d'activer l'insertion automatique de mid-rolls. Ils peuvent également désactiver les annonces automatiques pour une diffusion à tout moment.

Lorsque le propriétaire de la diffusion active les annonces automatiques, il peut choisir l'une des options suivantes :

  • Laisser YouTube optimiser l'insertion des mid-rolls Cette option accepte trois modes :
    • Faible : revenus potentiels moins élevés, expérience de visionnage avec moins d'interruptions
    • Moyenne : revenus potentiels moyens, expérience de visionnage équilibrée
    • Élevée : revenus potentiels plus élevés, expérience de visionnage avec plus d'interruptions
  • Configurez manuellement la stratégie et l'intervalle pour l'insertion de mid-rolls. Dans ce cas, le propriétaire doit configurer deux paramètres :
    1. Stratégie de programmation pour les points de repère publicitaires. Les points de repère peuvent être insérés simultanément pour tous les spectateurs, ou leur timing peut varier d'un spectateur à l'autre. Cette dernière stratégie permet à YouTube de planifier les cuepoints à une fréquence plus élevée, ce qui permet aux spectateurs de les recevoir lorsqu'ils y sont éligibles.
    2. Durée de l'intervalle entre les coupures publicitaires mid-roll.

La documentation reflète les modifications suivantes apportées à l'API pour prendre en charge cette fonctionnalité :

  • L'objet monetizationDetails de la ressource liveBroadcast contient des champs permettant d'activer les annonces mid-roll et de configurer les annonces automatiques.
  • La méthode update permet d'activer ou de désactiver les annonces mid-roll. Cette méthode peut également être utilisée pour configurer les annonces automatiques pour une diffusion en direct. La documentation identifie plusieurs nouvelles erreurs qui peuvent se produire lors de la mise à jour des paramètres de monétisation et des paramètres des annonces automatiques pour une diffusion en direct.

14 juillet 2025

La description de la méthode liveChatMessages.streamList a été mise à jour pour fournir des conseils sur l'utilisation de l'API streamList.

9 octobre 2023

À titre de référence, vous pouvez trouver les ID d'autocollants associés à chaque Super Sticker dans ce fichier CSV. Les définitions de la propriété snippet.superStickerDetails.superStickerMetadata.stickerId de la ressource liveChatMessage et de la propriété snippet.superStickerMetadata.stickerId de la ressource superChatEvent ont toutes deux été mises à jour pour refléter ces informations.

15 septembre 2023

L'API permet désormais d'insérer des annonces dans les diffusions en direct d'une nouvelle manière. En plus de liveCuepoints, qui vous permet d'insérer manuellement des coupures publicitaires dans une diffusion, YouTube propose désormais une fonctionnalité permettant d'insérer automatiquement des coupures publicitaires mid-roll dans une diffusion à intervalles fixes.

Si le propriétaire de la diffusion active les annonces automatiques, il peut consulter les aspects suivants du comportement des annonces :

  • la durée de l'intervalle entre les coupures publicitaires mid-roll.
  • la stratégie de programmation des repères publicitaires. Les points de repère peuvent être insérés simultanément pour tous les spectateurs, ou leur timing peut varier d'un spectateur à l'autre. Cette dernière stratégie permet à YouTube de programmer des points de repère à un rythme plus élevé, ce qui permet aux spectateurs de recevoir des points de repère lorsqu'ils y sont éligibles.
  • période pendant laquelle les annonces mid-roll ne sont pas diffusées. Pour cette fonctionnalité, le propriétaire de la diffusion spécifie que l'insertion d'annonces mid-roll est suspendue jusqu'à une heure donnée.

La documentation reflète les modifications apportées à l'API suivantes pour prendre en charge cette fonctionnalité :

  • La ressource liveBroadcast contient désormais un objet monetizationDetails. Les champs de l'objet indiquent si l'insertion automatique d'annonces est activée pour la diffusion et spécifient des informations supplémentaires pour la planification des points de repère.
  • Le paramètre part de la méthode liveBroadcast.list accepte la valeur monetizationDetails.
  • La méthode update peut être utilisée pour suspendre l'insertion d'annonces mid-roll pendant une certaine période pour une diffusion en direct. La documentation identifie désormais plusieurs erreurs qui peuvent se produire lors de la mise à jour des informations de monétisation d'une diffusion en direct.

1er août 2023

Cette mise à jour inclut les changements suivants :

  • La méthode liveBroadcasts.update ne nécessite plus de spécifier des valeurs pour les champs suivants :

    • snippet.title
    • status.privacyStatus

    Si vous omettez ces champs dans la requête, ils ne seront pas modifiés.

1er novembre 2022

  • La nouvelle méthode liveBroadcasts.cuepoint permet à tout propriétaire de chaîne qui diffuse une émission en direct sur YouTube d'insérer des points de repère dans cette diffusion, ce qui peut déclencher des coupures publicitaires. Cette méthode remplace la méthode liveCuepoints.insert, qui permettait uniquement aux partenaires de contenu YouTube d'insérer des points de repère dans les diffusions en direct.

    Plusieurs guides ont été mis à jour pour refléter la disponibilité de cette nouvelle méthode.

  • Remarque : Il s'agit d'une annonce d'abandon.

    La méthode liveCuepoints.insert est désormais obsolète. La méthode liveCuepoints.insert ne sera plus disponible à partir du 1er mai 2023. Les utilisateurs de l'API doivent mettre à jour leurs applications pour appeler la méthode liveBroadcasts.cuepoint à la place.

  • La documentation de la méthode liveBroadcasts.control a été supprimée. Un avis d'abandon de cette méthode a été publié en septembre 2020.

1er octobre 2022

Cette mise à jour inclut les changements suivants :

  • La méthode liveBroadcasts.update ne nécessite plus de spécifier des valeurs pour les champs suivants :

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

    Si vous omettez ces champs dans la requête, ils ne seront pas modifiés.

  • Suppression de la documentation pour les champs liveBroadcast obsolètes :

    • contentDetails.enableContentEncryption
    • contentDetails.startWithSlate

1 avril 2022

Cette mise à jour inclut les changements suivants :

  • La propriété snippet.type accepte désormais deux nouvelles valeurs :

    • membershipGiftingEvent
    • giftMembershipReceivedEvent

  • La nouvelle propriété snippet.membershipGiftingDetails de la ressource liveChatMessage et ses enfants contiennent des informations sur l'événement Offrir une souscription. De même, la nouvelle propriété snippet.giftMembershipReceivedDetails et ses enfants contiennent des informations sur l'événement "Souscription reçue en cadeau".

15 septembre 2021

Cette mise à jour inclut les changements suivants :

  • La propriété snippet.type accepte désormais deux nouvelles valeurs :

    • newSponsorEvent
    • memberMilestoneChatEvent

  • La nouvelle propriété snippet.memberMilestoneChatDetails de la ressource liveChatMessage et ses enfants contiennent des informations sur l'événement de chat de fidélité pour les membres. De même, la nouvelle propriété snippet.newSponsorDetails et ses enfants contiennent des informations sur l'événement "Nouveau sponsor".

1er décembre 2020

La méthode liveBroadcasts.transition de l'API accepte une nouvelle erreur 403 (Forbidden), qui indique que l'utilisateur a envoyé trop de requêtes dans un délai donné. La raison de l'erreur est userRequestsExceedRateLimit.

21 septembre 2020

  • La définition de la propriété status.madeForKids de la ressource liveBroadcast a été mise à jour pour indiquer clairement qu'il s'agit d'une propriété en lecture seule. Cela ne reflète pas un changement dans les fonctionnalités de l'API.

    Pour désigner une diffusion en direct comme étant destinée aux enfants, définissez la propriété status.selfDeclaredMadeForKids sur true lorsque vous appelez la méthode liveBroadcasts.insert pour créer la diffusion.

  • Remarque : Ce changement inclut une annonce d'abandon et une mise à jour d'une annonce d'abandon précédente.

    La méthode liveBroadcasts.control sera obsolète à partir du 1er octobre 2020. Après cette date, tous les appels à cette méthode renverront une erreur "Interdit" (403), et la méthode sera ensuite complètement supprimée. Les clients peuvent toujours implémenter leur propre clap en ajoutant un overlay à la vidéo envoyée aux serveurs d'ingestion de YouTube.

    La date d'abandon de l'annonce d'abandon du 16 avril 2020, initialement prévue pour le 1er septembre 2020, a été repoussée et aura désormais lieu le 1er octobre 2020 ou après cette date. Ainsi, les fonctionnalités incluses dans cette annonce d'abandon et la méthode liveBroadcasts.control seront toutes abandonnées en même temps.

17 juillet 2020

Remarque : Il s'agit d'une mise à jour d'une annonce d'abandon précédente.

Le champ cdn.format de la ressource liveStream, qui est obsolète depuis avril 2016, ne sera plus accepté à partir du 17 août 2020. Les requêtes qui utilisent encore ce champ échoueront à partir de cette date.

Si votre code utilise toujours le champ cdn.format, il doit être mis à jour pour spécifier la fréquence d'images et la résolution séparément, à l'aide des propriétés cdn.frameRate et cdn.resolution.

6 juillet 2020

Le guide Diffuser du contenu YouTube en direct via HLS a été mis à jour avec quelques modifications :

  • La durée recommandée pour un segment multimédia est désormais de une à quatre secondes.
  • Une nouvelle section explique comment obtenir une URL d'ingestion HLS dans YouTube Creator Studio.
  • Les instructions de mise en forme de la valeur du paramètre file ont été déplacées vers la nouvelle section Compléter l'URL d'ingestion HLS. Ces instructions s'appliquent que l'URL d'ingestion HLS soit obtenue à partir de l'API YouTube ou de YouTube Creator Studio.

De plus, la nouvelle comparaison des protocoles d'ingestion liste les protocoles d'ingestion compatibles avec YouTube, les codecs compatibles avec chaque protocole et des informations supplémentaires sur les cas d'utilisation appropriés pour chaque protocole.

16 avril 2020

Cette mise à jour inclut une nouvelle propriété et une annonce de suppression :

  • La ressource liveBroadcast est désormais compatible avec la propriété contentDetails.enableAutoStop. La propriété indique si une diffusion doit s'arrêter automatiquement environ une minute après que le propriétaire de la chaîne a cessé de diffuser des vidéos sur le flux vidéo associé.

    Le document Cycle de vie d'une diffusion a été mis à jour pour expliquer comment le processus de création et de gestion d'un événement YouTube en direct est modifié si vous définissez les propriétés contentDetails.enableAutoStart ou contentDetails.enableAutoStop sur true.

  • Remarque : Il s'agit d'une annonce d'abandon. Ces modifications entreront en vigueur le 1er septembre 2020 ou après cette date. La date effective à laquelle les modifications prennent effet est appelée ci-dessous "date d'abandon".

    Cette mise à jour explique une modification potentiellement destructive. Elle concerne les applications clientes d'API qui utilisent les ressources liveStream et liveBroadcast par défaut des chaînes pour diffuser du contenu en direct sur YouTube. Plus précisément, l'ID de diffusion et l'ID de flux associés à la diffusion et au flux persistants ne permettront plus de démarrer de nouvelles diffusions.

    Votre application sera affectée si l'une des conditions suivantes est remplie :

    • Il vérifie la valeur de la propriété isDefaultBroadcast de la ressource liveBroadcast. Cette propriété ne sera plus renvoyée après la date d'abandon.
    • Il vérifie la valeur de la propriété isDefaultStream de la ressource liveStream. Cette propriété ne sera plus renvoyée après la date d'abandon.
    • Elle appelle la méthode liveBroadcasts.list et définit la valeur du paramètre broadcastType sur persistent ou all. Ce paramètre sera obsolète dans le cadre de ces modifications. À compter de la date d'abandon :
      • Si la valeur du paramètre broadcastType est persistent, la méthode liveBroadcasts.list ne renvoie aucun résultat.
      • Si la valeur du paramètre broadcastType est all, la méthode liveBroadcasts.list ne renverra pas les diffusions persistantes qui existaient avant cette date.

    Pour rappel, ces dernières années, YouTube créait automatiquement une diffusion et un flux par défaut pour une chaîne lorsque le streaming en direct était activé sur celle-ci. Le flux par défaut existait indéfiniment, n'était pas associé à une heure de début ou de fin, et ne pouvait pas être supprimé. De même, la diffusion par défaut était considérée comme persistante. Il a toujours existé et n'était pas lié à un événement particulier.

    À compter de la date d'abandon :

    • YouTube ne créera plus de flux ni de diffusions par défaut. Au lieu de s'appuyer sur les ressources par défaut, les clients API doivent pouvoir créer et gérer des ressources liveBroadcast et liveStream, et les lier entre elles.
    • Si la diffusion et le flux par défaut d'une chaîne sont actifs au moment où la suppression prend effet, la diffusion en cours ne sera pas affectée. Toutefois, une fois cette diffusion terminée, la chaîne ne pourra plus utiliser la diffusion et le flux par défaut.
    • Si la diffusion et le flux par défaut d'une chaîne ne sont pas actifs, YouTube ignorera les tentatives d'utilisation de ces ressources pour diffuser des vidéos une fois l'abandon effectif.

    Si votre application est concernée, veuillez consulter les documents suivants, qui vous aideront à la mettre à jour afin qu'elle continue de fonctionner comme prévu après ce changement :

    • Un nouveau guide de migration tente d'expliquer les étapes que les développeurs devront peut-être suivre dans les clients API qui utilisent actuellement les diffusions et les flux par défaut.
    • Le guide Cycle de vie d'une diffusion vous explique étape par étape comment créer et gérer un événement en direct sur YouTube. Chaque étape explique les appels d'API ou les autres actions à effectuer pour réaliser une action spécifique. Votre application devra suivre ce processus lorsque YouTube cessera de prendre en charge les flux et diffusions par défaut.

31 mars 2020

Remarque : Il s'agit d'une annonce d'abandon.

La ressource sponsor et la méthode sponsors.list ont été abandonnées et remplacées par la ressource member et la méthode members.list.

La méthode sponsors.list ne sera plus disponible à partir du 30 septembre 2020. Les clients API doivent mettre à jour les appels à la méthode sponsors.list pour utiliser la méthode members.list à la place. Pour en savoir plus sur la nouvelle ressource, consultez l'historique des révisions de l'API YouTube Data.

11 mars 2020

La section Point de terminaison d'ingestion du guide Diffuser du contenu YouTube en direct via HLS a été mise à jour pour clarifier le processus qu'un encodeur doit utiliser pour compléter la valeur du paramètre file= lors de la formation des URL d'ingestion principale et de sauvegarde.

4 février 2020

Le guide Diffuser du contenu YouTube en direct via HLS a été mis à jour pour indiquer que les requêtes DELETE sont facultatives et que le point de terminaison HLS de YouTube les ignore. Pour des raisons de performances, YouTube recommande aux clients de ne pas envoyer de requêtes DELETE.

10 janvier 2020

L'API permet désormais d'identifier les contenus destinés aux enfants, que YouTube appelle "conçus pour les enfants". En savoir plus sur les contenus conçus pour les enfants dans le centre d'aide YouTube

  • La ressource liveBroadcast prend en charge deux nouvelles propriétés pour permettre aux créateurs de contenu et aux spectateurs d'identifier les contenus "conçus pour les enfants" :
    • La propriété selfDeclaredMadeForKids permet aux créateurs de contenu d'indiquer si une diffusion en direct est destinée aux enfants. Cette propriété peut être définie lors de la création d'une diffusion via la méthode liveBroadcasts.insert. Notez que cette propriété n'est incluse dans les réponses de l'API contenant des ressources liveBroadcast que si le propriétaire de la chaîne a autorisé la requête API.
    • La propriété madeForKids permet à tout utilisateur de l'API de récupérer l'état "conçu pour les enfants" d'une diffusion. Par exemple, l'état peut être déterminé en fonction de la valeur de la propriété selfDeclaredMadeForKids. Pour en savoir plus sur la définition de l'audience de votre chaîne, de vos vidéos ou de vos diffusions, consultez le Centre d'aide YouTube.
  • Dans l'API YouTube Data, la ressource channel est également compatible avec les nouvelles propriétés selfDeclaredMadeForKids et madeForKids.

Nous avons également mis à jour les Conditions d'utilisation des services d'API YouTube et le Règlement pour les développeurs. Pour en savoir plus, consultez l'historique des révisions des Conditions d'utilisation des services d'API YouTube. Les modifications apportées aux Conditions d'utilisation des services d'API YouTube et au Règlement pour les développeurs prendront effet le 10 janvier 2020 (heure du Pacifique).

20 août 2019

La section Exigences du guide Diffuser du contenu YouTube en direct via HLS a été mise à jour avec deux modifications :

  • Il explique qu'il est recommandé d'inclure à la fois les segments reconnus et les segments en attente dans chaque playlist multimédia. Cette pratique réduit le risque qu'un segment soit ignoré si une playlist de contenus multimédias est perdue côté serveur. Par exemple, vous pouvez inclure jusqu'à deux segments reconnus et jusqu'à cinq segments en attente dans chaque playlist multimédia.
  • Il est désormais obligatoire d'envoyer une playlist multimédia pour chaque segment multimédia. Cela permet au serveur de récupérer rapidement une playlist multimédia perdue. Cette pratique était auparavant listée comme une recommandation.

28 juin 2019

YouTube est désormais compatible avec l'ingestion HLS. Par conséquent, la propriété ingestionType de la ressource liveStream accepte la nouvelle valeur hls pour identifier les flux ingérés sur YouTube à l'aide de HLS.

Le nouveau guide Diffuser du contenu YouTube en direct via HLS fournit des instructions pour utiliser HLS afin de diffuser du contenu en direct sur YouTube à partir d'un encodeur. Ce guide vise à aider les fournisseurs d'encodeurs à ajouter la compatibilité avec la diffusion HLS à leurs produits.

4 avril 2019

Cette mise à jour inclut les changements suivants :

  • La documentation de référence de l'API a été mise à jour pour mieux expliquer les cas d'utilisation courants de chaque méthode et fournir des exemples de code dynamiques de haute qualité via le widget APIs Explorer. Pour obtenir un exemple, consultez la documentation de la méthode liveBroadcasts.list. Deux nouveaux éléments ont été ajoutés aux pages décrivant les méthodes d'API :

    • Le widget APIs Explorer vous permet de sélectionner des niveaux d'autorisation, de saisir des exemples de valeurs de paramètres et de propriétés, puis d'envoyer de véritables requêtes d'API et d'afficher les réponses d'API correspondantes. Le widget propose également une vue en plein écran qui affiche des exemples de code complets, lesquels sont mis à jour de manière dynamique pour utiliser les niveaux d'accès et les valeurs que vous avez saisis.

    • La section Cas d'utilisation courants décrit un ou plusieurs cas d'utilisation courants de la méthode expliquée sur la page. Par exemple, vous pouvez appeler la méthode liveBroadcasts.list pour récupérer des données sur une diffusion spécifique ou sur les diffusions de l'utilisateur actuel.

      Vous pouvez utiliser les liens de cette section pour renseigner APIs Explorer avec des exemples de valeurs pour votre cas d'utilisation ou pour ouvrir APIs Explorer en plein écran avec ces valeurs déjà renseignées. Ces modifications visent à vous permettre de voir plus facilement des exemples de code directement applicables au cas d'utilisation que vous essayez d'implémenter dans votre propre application.

    Les exemples de code sont actuellement compatibles avec Java, JavaScript, PHP, Python et curl.

  • La page Exemples de code dispose également d'une nouvelle UI qui offre toutes les fonctionnalités décrites ci-dessus. Cet outil vous permet d'explorer des cas d'utilisation pour différentes méthodes, de charger des valeurs dans APIs Explorer et d'ouvrir APIs Explorer en plein écran pour obtenir des exemples de code en Java, JavaScript, PHP et Python.

    Parallèlement à ce changement, les pages qui listaient auparavant les exemples de code disponibles pour Java, PHP et Python ont été supprimées.

25 février 2019

La documentation des ressources liveChatMessage et superChatEvent a été mise à jour pour refléter le fait que les deux ressources peuvent désormais contenir des informations sur les Super Stickers. Les Super Stickers sont un type de message Super Chat qui affiche une image. Comme les autres Super Chats, un message Super Sticker est acheté par un fan lors d'une diffusion YouTube En direct.

  • Dans une ressource liveChatMessage, la propriété snippet.type est désormais définie sur superStickerEvent pour indiquer que la ressource contient des informations sur un Super Sticker. Dans ce cas, la ressource contient également l'objet snippet.superStickerDetails, qui contient des informations supplémentaires sur le Super Sticker.
  • Dans une ressource superChatEvent, la valeur booléenne snippet.isSuperStickerEvent indique si le message Super Chat est également un Super Sticker. Si tel est le cas, l'objet snippet.superStickerMetadata contient des informations supplémentaires sur les Super Stickers.

5 avril 2018

La description de la méthode superChatEvents.list a été mise à jour pour refléter le fait que la réponse de l'API ne contient plus de fanFundingEvents, qui ont été abandonnés début 2017.

3 avril 2017

De nouveaux exemples de code Java ont été ajoutés pour montrer comment lister, insérer et supprimer des messages de chat en direct. Les exemples appellent les méthodes suivantes :

13 février 2017

Cette mise à jour inclut les changements suivants :

  • Mises à jour des ressources et méthodes existantes

    • La méthode liveCuepoints.insert a été mise à jour pour refléter le fait que le paramètre onBehalfOfContentOwner est actuellement obligatoire. De plus, la description de la méthode a été mise à jour pour indiquer que les appels à cette méthode doivent être autorisés par un compte associé à un propriétaire de contenu YouTube.

9 février 2017

Cette mise à jour inclut les changements suivants :

  • Mises à jour des ressources et méthodes existantes

    • Le nouveau paramètre hl de la méthode superChatEvents.list vous permet de spécifier que la valeur de la propriété snippet.displayString doit être mise en forme selon les conventions d'une langue spécifique. La définition de cette propriété a également été mise à jour en conséquence.

      La valeur de paramètre doit être un code de langue inclus dans la liste renvoyée par la méthode i18nLanguages.list. La valeur par défaut est en, ce qui signifie que le comportement par défaut consiste à mettre en forme les chaînes à afficher comme elles le seraient en anglais. Par exemple, par défaut, une chaîne est formatée en tant que $1.00 plutôt que $1,00.

1er février 2017

Cette mise à jour inclut les changements suivants :

  • Nouvelles ressources et méthodes

    • La nouvelle ressource superChatEvent représente un message Super Chat acheté par un fan lors d'une diffusion en direct sur YouTube. Dans le flux de chat en direct YouTube, les Super Chats se distinguent des autres messages de deux façons :

      • Les Super Chats sont mis en évidence par une couleur.
      • Les Super Chats restent épinglés dans le ticker pendant un certain temps.

      La couleur du Super Chat, la durée pendant laquelle il reste épinglé dans le ticker et la longueur maximale du message sont déterminées par le montant de l'achat. Pour en savoir plus sur les Super Chats, consultez le Centre d'aide YouTube.

      L'API est compatible avec une méthode permettant de lister les événements Super Chat pour les diffusions en direct d'une chaîne au cours des 30 derniers jours. Cette méthode renvoie également des données sur les événements de financement par les fans (fanFundingEvents) de la dernière diffusion en direct de la chaîne.

  • Mises à jour des ressources et méthodes existantes

    • La propriété snippet.type accepte désormais la valeur superChatEvent, qui indique que la ressource décrit un Super Chat.

      De plus, la nouvelle propriété snippet.superChatDetails de la ressource liveChatMessage et ses enfants contiennent des informations sur l'événement Super Chat.

    • La propriété cdn.resolution de la ressource liveStream accepte désormais la valeur 2160p.

  • Erreurs nouvelles et mises à jour

    • L'API accepte les nouvelles erreurs suivantes :

      Informations sur les erreurs
      liveBroadcasts.insert, liveBroadcasts.update Les méthodes liveBroadcasts.insert et liveBroadcasts.update renvoient des erreurs 400 (Bad Request) pour indiquer que la ressource liveBroadcast insérée ou mise à jour contient une valeur non valide pour la propriété contentDetails.enableEmbed ou la propriété contentDetails.projection. Les motifs des deux nouvelles erreurs sont respectivement invalidEmbedSetting et invalidProjection.

12 janvier 2017

Remarque : Il s'agit d'une annonce d'abandon.

En parallèle du lancement de la nouvelle fonctionnalité Super Chat, YouTube a abandonné la fonctionnalité de financement par les fans. L'API de financement par les fans sera désactivée le 28 février 2017. À compter de cette date :

11 août 2016

Cette mise à jour inclut les changements suivants :

  • Les nouvelles Conditions d'utilisation des Services API YouTube (les "Conditions d'utilisation mises à jour"), présentées en détail sur le blog YouTube Engineering and Developers, apportent de nombreuses modifications aux Conditions d'utilisation actuelles. En plus des Conditions d'utilisation modifiées, qui entreront en vigueur le 10 février 2017, cette mise à jour inclut plusieurs documents d'aide pour expliquer les règles que les développeurs doivent respecter.

    L'ensemble des nouveaux documents est décrit dans l'historique des révisions des Conditions modifiées. De plus, les modifications futures apportées aux Conditions mises à jour ou aux documents associés seront également expliquées dans cet historique des révisions. Vous pouvez vous abonner à un flux RSS listant les modifications apportées à l'historique des révisions à partir d'un lien dans le document.

20 mai 2016

YouTube est désormais compatible avec l'ingestion DASH. Par conséquent, la propriété ingestionType de la ressource liveStream accepte la nouvelle valeur dash pour identifier les flux ingérés sur YouTube à l'aide de DASH.

Le nouveau guide Diffuser du contenu YouTube en direct via DASH fournit des instructions pour utiliser le format de diffusion DASH afin de diffuser des données en direct sur YouTube à partir d'un encodeur. Il est destiné à aider les fournisseurs d'encodeurs à ajouter la compatibilité avec la diffusion DASH à leurs produits.

18 avril 2016

Cette mise à jour inclut les changements suivants :

  • Mises à jour des ressources et méthodes existantes

    • Mises à jour de la ressource liveStream

      • YouTube accepte désormais les diffusions en résolution 1440p à 30 ou 60 images par seconde.

        De plus, la ressource liveStream contient de nouvelles propriétés permettant de spécifier la fréquence d'images et la résolution des données vidéo entrantes :

        Propriétés
        cdn.frameRate Fréquence d'images des données vidéo entrantes. Les valeurs valides sont 30fps et 60fps.
        cdn.resolution Résolution des données vidéo entrantes. Les valeurs de propriété valides sont 1440p, 1080p, 720p, 480p, 360p et 240p.

      • Conformément à l'introduction des propriétés cdn.frameRate et cdn.resolution de la ressource liveStream, la propriété cdn.format de la ressource est désormais obsolète. La propriété cdn.format spécifie la résolution et la fréquence d'images dans une seule valeur.

        Nous vous encourageons à passer aux nouveaux champs compatibles. En attendant, cdn.format continue de fonctionner. De plus, les requêtes d'insertion de diffusions en direct aboutissent actuellement tant que vous spécifiez des valeurs pour la propriété cdn.format ou les propriétés cdn.frameRate et cdn.resolution. Si vous fournissez des valeurs pour les trois propriétés, l'API peut renvoyer une erreur si les valeurs ne concordent pas.

        Notez que même si la propriété cdn.format est obsolète, elle accepte désormais deux nouvelles valeurs, 1440p et 1440p_hfr, pour refléter la compatibilité de l'API avec les flux 1440p à 30 ou 60 images par seconde.

    • liveBroadcast mise à jour de ressource

      • La ressource liveBroadcast contient les nouvelles propriétés suivantes :

        Propriétés
        contentDetails.boundStreamLastUpdateTimeMs Date et heure de la dernière mise à jour de la diffusion en direct référencée par la propriété contentDetails.boundStreamId de la diffusion.
        contentDetails.projection Format de projection de la diffusion. La valeur par défaut de la propriété est rectangular. Les valeurs valides pour la propriété sont 360 et rectangular.

      • La définition de la propriété statistics.totalChatCount de la ressource liveBroadcast a été mise à jour pour indiquer que la valeur de la propriété ne s'affiche que si la diffusion comporte au moins un message de chat.

    • Mises à jour de la ressource liveChatMessage

      • La propriété snippet.type accepte deux nouvelles valeurs, messageDeletedEvent et userBannedEvent, qui correspondent aux nouvelles propriétés décrites dans le point suivant. La définition de la propriété snippet.authorChannelId a également été mise à jour pour expliquer ce que la valeur de la propriété identifie pour ces nouveaux types de messages.

      • La ressource liveChatMessage contient les nouvelles propriétés suivantes :

        Propriétés
        snippet.messageDeletedDetails Cet objet contient des informations sur un message supprimé par un modérateur du chat. L'objet n'est présent que si la valeur de la propriété snippet.type est messageDeletedEvent.
        snippet.userBannedDetails Cet objet contient des informations sur un utilisateur qui a été banni du chat. L'objet contient également des informations sur l'exclusion elle-même, à savoir si elle est permanente ou temporaire. Si l'exclusion est temporaire, l'une des propriétés de l'objet spécifie sa durée.

        Cet objet n'est présent que si la valeur de la propriété snippet.type est userBannedEvent.

  • Erreurs nouvelles et mises à jour

    • L'API accepte les nouvelles erreurs suivantes :

      Informations sur les erreurs
      liveBroadcasts.bind La méthode liveBroadcasts.bind renvoie une erreur 403 (Forbidden) pour indiquer que l'utilisateur a envoyé trop de requêtes dans un délai donné. Le motif de l'erreur est userRequestsExceedRateLimit.

      Les méthodes liveBroadcasts.insert et liveBroadcasts.update acceptent déjà la même erreur.
      liveStreams.insert La méthode liveStreams.insert accepte quatre nouvelles erreurs 400 (Bad Request) qui identifient une valeur de propriété non valide dans la ressource liveStream que la requête a tenté d'insérer. La liste suivante identifie les raisons de l'erreur et les propriétés auxquelles elles sont associées :
      liveStreams.insert La méthode liveStreams.insert accepte deux nouvelles erreurs 400 (Bad Request), chacune indiquant qu'une valeur requise n'est pas présente dans la ressource liveStream que la requête a tenté d'insérer. La liste suivante identifie les raisons d'erreur et les propriétés auxquelles elles sont associées :
      Plus précisément, lorsque vous insérez une ressource liveStream, vous devez spécifier une valeur pour la propriété cdn.format ou pour les propriétés cdn.frameRate et cdn.resolution.
      • L'API renvoie une erreur formatRequired si vous ne spécifiez pas de valeur pour l'une des trois propriétés.
      • L'API renvoie une erreur frameRateRequired si vous spécifiez une valeur pour cdn.resolution, mais pas pour cdn.frameRate.
      • L'API renvoie une erreur resolutionRequired si vous spécifiez une valeur pour cdn.frameRate, mais pas pour cdn.resolution.
      liveStreams.update La méthode liveStreams.update renvoie une erreur 403 (Forbidden) si la requête tente de modifier la valeur de l'une des propriétés non modifiables suivantes : La valeur reason dans la réponse d'erreur est liveStreamModificationNotAllowed.

18 décembre 2015

Conformément à la législation de l'Union européenne (UE), vous devez fournir certaines informations aux utilisateurs finaux de l'UE et obtenir leur consentement. Par conséquent, pour les utilisateurs finaux situés dans l'Union européenne, vous devez respecter les Règles relatives au consentement de l'utilisateur dans l'UE. Nous avons ajouté un avis concernant cette exigence dans nos Conditions d'utilisation des API YouTube.

17 décembre 2015

Cette mise à jour inclut les changements suivants :

  • Nouvelles ressources et méthodes

    • L'API accepte plusieurs nouvelles ressources pour prendre en charge la fonctionnalité de chat pour les diffusions en direct. YouTube prend en charge la fonctionnalité de chat en direct pendant les diffusions en direct actives. Ces ressources et leurs méthodes permettent de récupérer les messages de chat et d'effectuer des tâches d'administration pour le chat.

      Ressources
      liveChatMessage Cette ressource représente un message dans un chat en direct YouTube. YouTube accepte plusieurs types de messages, y compris les messages texte et les événements de financement par les fans. Certains types de messages identifient une phase particulière du chat, comme le début d'une période réservée aux sponsors ou la fin du chat. L'API accepte les méthodes permettant de lister, d'insérer et de supprimer des messages de chat en direct.
      liveChatModerators Cette ressource identifie un modérateur de chat. Les modérateurs peuvent effectuer certaines tâches administratives, comme bannir des utilisateurs du chat ou supprimer des messages. L'API accepte les méthodes permettant de lister, d'insérer et de supprimer des modérateurs de chat en direct.
      liveChatBans Cette ressource identifie un utilisateur qui n'est pas autorisé à publier des messages dans un chat en direct spécifique. Les exclusions peuvent être temporaires ou permanentes. L'API accepte les méthodes permettant d'insérer et de supprimer des exclusions du chat en direct.
      fanFundingEvents Cette ressource représente un événement de financement par les fans sur une chaîne YouTube. Le financement par les fans permet aux spectateurs de soutenir volontairement les créateurs YouTube en leur versant une somme d'argent ponctuelle.

      La méthode fanFundingEvents.list de l'API liste les événements de financement par les fans d'une chaîne. Les événements de financement par les fans initiés via un chat en direct pendant une diffusion en direct appartenant à la chaîne déclenchent également un message fanFundingEvent dans le chat en direct de la diffusion.

      Pour en savoir plus sur le financement par les fans, consultez le Centre d'aide YouTube.
      sponsors La ressource sponsor identifie un sponsor d'une chaîne YouTube. Un mécène paie des frais mensuels à une chaîne. Un badge s'affiche à côté des messages du sponsor dans les chats en direct de la chaîne. Les sponsors peuvent également participer aux chats en direct réservés aux sponsors de la chaîne, le cas échéant.

      La méthode sponsors.list de l'API liste les sponsors d'une chaîne. Lorsque des utilisateurs s'abonnent à une chaîne pendant une diffusion en direct de cette chaîne, l'API ajoute également un message newSponsorEvent au chat en direct de la diffusion.

      Pour en savoir plus sur les souscriptions, consultez le Centre d'aide YouTube.

  • Modifications apportées aux ressources et méthodes existantes

    • La ressource liveBroadcast contient les nouvelles propriétés suivantes :

      Propriétés
      snippet.liveChatId ID du chat en direct YouTube de la diffusion. Cet ID vous permet d'utiliser les méthodes de la ressource liveChatMessage pour récupérer, insérer ou supprimer des messages de chat. Vous pouvez également ajouter ou supprimer des modérateurs de chat, interdire à des utilisateurs de participer aux chats en direct ou supprimer des exclusions existantes.
      contentDetails.closedCaptionsType Remarque : Cette propriété remplace la propriété contentDetails.enableClosedCaptions.

      Cette propriété indique si les sous-titres sont activés pour votre diffusion et, le cas échéant, le type de sous-titres que vous fournissez :
      • closedCaptionsDisabled : les sous-titres sont désactivés pour la diffusion en direct.
      • closedCaptionsHttpPost : vous enverrez les sous-titres via HTTP POST à une URL d'ingestion associée à votre diffusion en direct.
      • closedCaptionsEmbedded : les sous-titres seront encodés dans le flux vidéo aux formats EIA-608 et/ou CEA-708.
      contentDetails.enableClosedCaptions Cette propriété est obsolète depuis le 17 décembre 2015. Utilisez plutôt la propriété contentDetails.closedCaptionsType. Pour les clients API qui utilisent déjà cette propriété :
      • Définir la valeur de la propriété sur true équivaut à définir la propriété contentDetails.closedCaptionsType sur closedCaptionsHttpPost.
      • Définir la valeur de la propriété sur false équivaut à définir la propriété contentDetails.closedCaptionsType sur closedCaptionsDisabled.

    • Le nouveau paramètre broadcastType de la méthode liveBroadcasts.list vous permet de filtrer une réponse de l'API pour inclure les diffusions d'événements, les diffusions persistantes ou toutes les diffusions.

      Une diffusion persistante est une diffusion qui existe toujours et qui n'est pas liée à un événement particulier. Plus précisément, la diffusion par défaut d'une chaîne est une diffusion permanente, accessible via le tableau de bord En direct dans YouTube Creator Studio. Les autres diffusions de la chaîne sont des diffusions d'événements.

  • Le champ status.healthStatus.configurationIssues[].type de la ressource liveStream signale les nouvelles erreurs d'état suivantes :

    Erreurs
    audioTooManyChannels Le fichier audio comporte plus de deux canaux. Cependant, il ne peut en comporter qu'un (mono) ou deux (stéréo). Veuillez corriger le nombre de canaux audio.
    frameRateHigh La fréquence d'images actuelle est trop élevée. Veuillez définir la fréquence d'images sur %(framerate)s fps ou moins.

  • La date de publication de la mise à jour précédente de la documentation a été corrigée.

  • Erreurs nouvelles et mises à jour

    • En plus des erreurs définies pour les nouvelles ressources listées ci-dessus, l'API accepte les nouvelles erreurs suivantes :

      Informations sur les erreurs
      liveBroadcasts.update
      Code de réponse HTTPforbidden (403)
      MotifclosedCaptionsTypeModificationNotAllowed
      DescriptionLa valeur contentDetails.closedCaptionsType ne peut être modifiée que lorsque l'état de la diffusion est created ou ready.
      liveBroadcasts.update
      Code de réponse HTTPinvalidValue (400)
      MotifinvalidEnableClosedCaptions
      DescriptionDans la ressource liveBroadcast, la valeur de la propriété contentDetails.enableClosedCaptions est incompatible avec la valeur du paramètre contentDetails.closedCaptionType. Modifiez la ressource pour n'inclure qu'une seule des deux propriétés, puis renvoyez la requête.

19 août 2015

Cette mise à jour inclut les changements suivants :

  • Nouvelles ressources et méthodes

    • Remarque : La documentation sur la ressource liveChat et ses méthodes est confidentielle et n'est visible que par certains partenaires YouTube.

      La nouvelle ressource liveChat contient un commentaire publié lors d'une diffusion en direct sur YouTube. L'API accepte deux méthodes pour cette ressource :

      Méthodes
      liveChats.list Répertorie les messages de chat en direct pour une diffusion.
      liveChats.insert Créez un message de chat.

      Les messages du chat en direct ne peuvent être récupérés et publiés que pendant une diffusion en direct.

  • Mises à jour des ressources et méthodes existantes

    • La ressource liveStream contient les nouvelles propriétés suivantes :

      Propriétés
      snippet.isDefaultStream Indique si ce flux est le flux par défaut de la chaîne. Le flux par défaut d'une chaîne existe indéfiniment, n'est associé à aucune heure de début ni de fin, et ne peut pas être supprimé. Pour en savoir plus sur le fonctionnement des flux par défaut, consultez la définition de la propriété.
      status.healthStatus Cet objet contient des informations qui peuvent être utilisées pour identifier, diagnostiquer et résoudre les problèmes de streaming. L'objet contient un certain nombre de propriétés enfants pour vous aider à évaluer l'état d'un flux vidéo en direct.

      En particulier, l'objet status.healthStatus.configurationIssues[] liste les problèmes affectant un flux vidéo. Un nouveau document, Problèmes de configuration des ressources LiveStream, liste tous les problèmes signalés par l'API.
      contentDetails.isReusable Indique si le flux est réutilisable, ce qui signifie qu'il peut être associé à plusieurs diffusions. Il est courant que les diffuseurs réutilisent le même flux pour de nombreuses diffusions différentes si celles-ci ont lieu à des moments différents.

    • La ressource liveBroadcast contient les nouvelles propriétés suivantes :

      Propriétés
      snippet.isDefaultBroadcast Indique si cette diffusion est la diffusion par défaut de la chaîne. Lorsqu'une chaîne YouTube est activée pour le streaming en direct, YouTube crée un flux et une diffusion par défaut pour la chaîne. Le flux définit la manière dont le propriétaire de la chaîne envoie la vidéo en direct à YouTube, et la diffusion est la façon dont les spectateurs peuvent voir le flux par défaut. Pour en savoir plus sur le fonctionnement des diffusions par défaut, consultez la définition de la propriété.
      contentDetails.enableLowLatency Indique si cette diffusion doit être encodée pour le streaming à faible latence. Un flux à faible latence peut réduire le temps nécessaire pour que la vidéo soit visible par les utilisateurs qui regardent une diffusion, mais il peut également avoir un impact sur la résolution pour les spectateurs du flux.
      statistics.totalChatCount Nombre total de messages de chat en direct associés à la diffusion. La propriété et sa valeur sont présentes si la diffusion est visible par l'utilisateur et que la fonctionnalité de chat en direct est activée. Notez que cette propriété ne spécifiera pas de valeur une fois la diffusion terminée. Cette propriété n'identifierait donc pas le nombre de messages de chat pour une vidéo archivée d'une diffusion en direct terminée.

  • Erreurs nouvelles et mises à jour

    • En plus des erreurs définies pour la nouvelle ressource liveChat, l'API accepte la nouvelle erreur suivante :

      Informations sur les erreurs
      liveStreams.update
      Code de réponse HTTPforbidden (403)
      MotifliveStreamModificationNotAllowed
      DescriptionL'API ne vous permet pas de modifier un flux réutilisable pour le rendre non réutilisable, ni inversement. Pour en savoir plus, consultez Comprendre les diffusions et les flux.

21 mai 2015

Cette mise à jour inclut les changements suivants :

  • YouTube prend désormais en charge la diffusion de vidéos en direct à 60 images par seconde (fps), ce qui signifie une lecture plus fluide pour les jeux vidéo et les autres vidéos d'action rapide. Lorsque vous lancez une diffusion en direct sur YouTube à 60 fps, YouTube la propose également à 30 fps sur les appareils qui ne sont pas encore compatibles avec une fréquence d'images élevée.

    La propriété cdn.format de la ressource liveStream accepte deux nouvelles valeurs pour cette fonctionnalité : 720p_hfr et 1080p_hfr.

    Pour en savoir plus sur cette fonctionnalité, consultez le blog des créateurs YouTube.

21 août 2014

Cette mise à jour inclut les changements suivants :

  • La définition du paramètre walltime de la méthode liveBroadcasts.control a été mise à jour pour indiquer que la valeur de la propriété est spécifiée au format ISO 8601 (YYYY-MM-DDThh:mm:ss.sssZ).

  • L'API accepte désormais les erreurs suivantes :

    Type d'erreur Détail de l'erreur Description
    insufficientPermissions liveStreamingNotEnabled Toutes les méthodes pour les ressources liveBroadcast et liveStream renvoient cette erreur si l'utilisateur qui a autorisé la requête API n'a pas été autorisé à diffuser des vidéos en direct sur YouTube. Pour savoir pourquoi l'utilisateur ne peut pas diffuser de vidéo en direct, consultez les paramètres de sa chaîne sur https://www.youtube.com/features.
    rateLimitExceeded userRequestsExceedRateLimit Les méthodes liveBroadcasts.insert et liveStreams.insert renvoient toutes deux cette erreur pour indiquer que l'utilisateur a envoyé trop de requêtes dans un délai donné.

2 mai 2014

Cette mise à jour inclut les changements suivants :

  • Les descriptions de la ressource liveStream et de la méthode liveBroadcasts.bind ont été mises à jour pour indiquer qu'une diffusion ne peut être associée qu'à un seul flux vidéo, mais qu'un flux vidéo peut être associé à plusieurs diffusions. Cette modification ne concerne que la documentation. La fonctionnalité de l'API sous-jacente n'a pas changé.

  • La propriété contentDetails.monitorStream.enableMonitorStream de la ressource liveBroadcast a été mise à jour pour expliquer que si la valeur de la propriété est true, vous devez faire passer votre diffusion à l'état testing avant de pouvoir la faire passer à l'état live. (Si la valeur de la propriété est false, votre diffusion ne peut pas avoir d'état testing. Vous pouvez donc la faire passer directement à l'état live.

  • La propriété settings.offsetTimeMs de la ressource liveCuepoint a été mise à jour pour indiquer que vous ne devez pas spécifier de valeur pour la propriété si votre diffusion ne comporte pas de flux de contrôle.

  • Toutes les méthodes des ressources liveBroadcast et liveStream sont désormais compatibles avec les paramètres onBehalfOfContentOwner et onBehalfOfContentOwnerChannel. Ces paramètres vous permettent d'utiliser les mêmes identifiants d'autorisation pour effectuer des requêtes API pour différentes chaînes associées au même propriétaire de contenu.

  • La documentation de la méthode liveCuepoints.insert a été mise à jour pour indiquer que vous pouvez définir une valeur pour la propriété settings.walltime lorsque vous appelez cette méthode.

  • La documentation sur les erreurs spécifie désormais le code de réponse HTTP pour chaque type d'erreur.

  • L'API est désormais compatible avec l'erreur suivante :

    Type d'erreur Détail de l'erreur Description
    insufficientPermissions livePermissionBlocked Les méthodes liveBroadcasts.insert, liveBroadcasts.transition et liveStreams.insert renvoient cette erreur si l'utilisateur qui a autorisé la requête ne peut pas diffuser de vidéo en direct sur YouTube. Des informations expliquant pourquoi l'utilisateur ne peut pas diffuser de vidéo en direct sont peut-être disponibles dans les paramètres de sa chaîne sur https://www.youtube.com/features.

  • L'erreur invalidScheduledStartTime de la méthode liveBroadcasts.insert a été mise à jour pour indiquer que l'heure de début planifiée doit être suffisamment proche de la date actuelle pour qu'une diffusion puisse être planifiée de manière fiable à cette heure.

13 décembre 2013

Cette mise à jour inclut les changements suivants :

  • La nouvelle propriété status.recordingStatus de la ressource liveBroadcast identifie l'état actuel de la diffusion.

  • La nouvelle propriété contentDetails.enableClosedCaptions de la ressource liveBroadcast indique si les sous-titres peuvent être ingérés pour la diffusion. La valeur de la propriété peut être définie lorsque vous insérez ou mettez à jour une diffusion, mais elle ne peut pas être modifiée une fois que la diffusion est à l'état testing ou live. Si vous définissez cette propriété sur true, la ressource liveStream liée à la diffusion spécifie l'URL d'ingestion à utiliser pour les sous-titres de la diffusion.

  • La propriété snippet.scheduledEndTime de la ressource liveBroadcast accepte désormais les diffusions programmées pour se poursuivre indéfiniment. Avec ce changement, la propriété n'est plus requise dans les requêtes liveBroadcasts.insert et liveBroadcasts.update.

    Si vous récupérez une ressource liveBroadcast qui ne spécifie pas de valeur pour cette propriété, la diffusion est programmée pour continuer indéfiniment. De même, si vous appelez la méthode liveBroadcasts.insert ou liveBroadcasts.update et que vous ne spécifiez pas de valeur pour cette propriété, la diffusion sera programmée pour se poursuivre indéfiniment.

  • La propriété contentDetails.recordFromStart de la ressource liveBroadcast, qui avait déjà la valeur par défaut true, ne peut désormais être définie sur false que si la chaîne hertzienne est autorisée à désactiver les enregistrements pour les diffusions en direct.

    Si votre chaîne n'est pas autorisée à désactiver les enregistrements et que vous tentez d'insérer une diffusion avec la propriété recordFromStart définie sur false, l'API renvoie une erreur Forbidden. De plus, si votre chaîne ne dispose pas de cette autorisation et que vous tentez de modifier une diffusion pour définir la propriété recordFromStart sur false, l'API renverra une erreur modificationNotAllowed.

  • La ressource liveBroadcast ne contient plus de propriété enableArchive, qui avait été mentionnée dans les descriptions des propriétés contentDetails.enableDvr et contentDetails.enableEmbed.

  • La liste des valeurs valides pour la propriété status.lifeCycleStatus de la ressource liveBroadcast a été mise à jour pour inclure une description de chaque état.

  • La nouvelle propriété settings.walltime de la ressource liveCuepoint spécifie la date et l'heure auxquelles le repère doit être inséré. L'API renvoie une erreur si une requête tente d'insérer un point de repère qui spécifie une valeur pour cette propriété et pour la propriété settings.offsetTimeMs.

  • Le nouvel objet contentDetails d'une ressource liveStream contient des informations sur le flux. Actuellement, la seule propriété de l'objet est contentDetails.closedCaptionsIngestionUrl, qui spécifie l'URL d'ingestion des sous-titres associés au flux vidéo.

  • La liste des valeurs valides pour la propriété status.streamStatus de la ressource liveStream a été mise à jour pour inclure une description de chaque état.

  • Le nouveau paramètre walltime de la méthode liveBroadcasts.control vous permet de spécifier la date et l'heure auxquelles un changement de slate se produira. L'API renvoie une erreur si une requête spécifie une valeur pour ce paramètre et pour le paramètre offsetTimeMs.

  • Dans la réponse de l'API à une requête liveBroadcasts.list, la valeur de la propriété kind est passée de youtube#liveBroadcastList à youtube#liveBroadcastListResponse.

  • Dans la réponse de l'API à une requête liveStreams.list, la valeur de la propriété kind est passée de youtube#liveStreamList à youtube#liveStreamListResponse.

  • La propriété eventId a été abandonnée dans liveBroadcastListResponse et liveStreamListResponse.

  • L'API accepte les nouvelles erreurs suivantes :

    Type d'erreur Détail de l'erreur Description
    invalidValue conflictingTimeFields La méthode liveBroadcasts.control renvoie cette erreur si votre requête spécifie des valeurs pour les paramètres offsetTimeMs et walltime. Une requête peut omettre les deux paramètres ou spécifier une valeur pour l'un d'eux.
    invalidValue invalidWalltime La méthode liveBroadcasts.control renvoie cette erreur si la valeur du paramètre walltime n'est pas valide.
    forbidden enableClosedCaptionsModificationNotAllowed La méthode liveBroadcasts.update renvoie cette erreur si vous tentez de modifier la valeur contentDetails.enableClosedCaptions et que l'état de la diffusion n'est pas created ni ready.
    invalidValue conflictingTimeFields La méthode liveCuepoints.insert renvoie cette erreur si votre requête spécifie des valeurs pour les propriétés settings.offsetTimeMs et settings.walltime. Une requête peut omettre les deux propriétés ou spécifier une valeur pour l'une d'elles.

    De plus, la méthode liveStreams.update n'est plus compatible avec une erreur cdnRequired semblable à celle que la méthode liveStreams.insert prend en charge.

10 mai 2013

Cette mise à jour inclut les changements suivants :

2 mai 2013

Cette mise à jour inclut les changements suivants :

27 mars 2013

Cette mise à jour inclut les changements suivants :

  • Les propriétés suivantes ont changé dans la ressource liveBroadcast :

    • La propriété startWithSlateCuepoint a été renommée startWithSlate.
    • La propriété enableArchive a été renommée recordFromStart.
    • L'objet slateSettings est obsolète et a été supprimé de la documentation. Les messages d'erreur liés à l'objet slateSettings ou à ses propriétés ont également été supprimés. Enfin, la section "Afficher les ardoises" du guide Premiers pas a été supprimée.

  • L'API ne permet plus d'insérer des images fixes InStream à l'aide de la méthode liveCuepoints.insert. Les documents suivants ont été mis à jour afin de prendre en compte cette modification :

    • La page d'index, le guide de démarrage et le tutoriel Cycle de vie d'une diffusion ne mentionnent plus cette fonctionnalité.

    • La propriété settings.cueType de la ressource liveCuepoint n'accepte plus slate comme valeur de propriété. (La seule valeur acceptée est ad.

    • La propriété settings.eventState de la ressource liveCuepoint est obsolète et a été supprimée de la documentation.

18 mars 2013

Cette mise à jour inclut les changements suivants :

  • Tous les messages d'erreur de l'API ont été mis à jour pour expliquer plus clairement les erreurs possibles et, si possible, proposer des conseils pour les corriger.

  • L'API peut désormais renvoyer plusieurs nouvelles erreurs. La liste ci-dessous identifie l'erreur et la méthode API susceptible de la renvoyer :

    • liveBroadcasts.insert : l'heure de fin prévue d'une diffusion doit être postérieure à son heure de début prévue.
    • liveBroadcasts.insert : la diffusion spécifie un état de confidentialité non valide.
    • liveBroadcasts.update : la ressource ne contient pas de valeur pour la propriété contentDetails.enableArchive ou n'en définit pas.
    • liveBroadcasts.update : la ressource ne contient pas de valeur pour la propriété contentDetails.enableContentEncryption ou n'en définit pas.
    • liveBroadcasts.update : la ressource ne contient pas ou ne définit pas de valeur pour la propriété contentDetails.enableDvr.
    • liveStreams.insert : le titre de l'extrait doit comporter entre 1 et 128 caractères.
    • liveStreams.update : la ressource ne contient pas de valeur pour la propriété snippet.title ou n'en définit pas.

  • La documentation sur la ressource liveStream a été mise à jour pour indiquer que la multidiffusion et WebM ne sont pas des méthodes d'ingestion compatibles, contrairement à ce qui était indiqué précédemment. La liste des formats de la propriété cdn.format a été mise à jour en conséquence, et l'objet cdn.multicastIngestionInfo et ses propriétés enfants ont été supprimés de la documentation de la ressource. De plus, http a été supprimé de la liste des valeurs cdn.ingestionType acceptées.