API YouTube Live Streaming – Historique des révisions

Cette page répertorie les modifications apportées à l'API YouTube Live Streaming et les mises à jour de la documentation. S'abonner à ce journal des modifications : S'abonner

14 juillet 2025

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

9 octobre 2023

Pour information uniquement, vous trouverez les ID d'autocollants associés aux Super Stickers 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 repères 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 repères à une fréquence plus élevée, ce qui permet aux spectateurs de les recevoir 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 indique que l'insertion d'annonces mid-roll est suspendue jusqu'à une heure précise.

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 cue points.
  • Le paramètre part de la méthode liveBroadcast.list accepte la valeur monetizationDetails.
  • La méthode update permet de suspendre l'insertion d'annonces mid-roll pendant une certaine période pour une diffusion en direct. La documentation identifie également 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 resteront inchangés.

1er novembre 2022

  • La nouvelle méthode liveBroadcasts.cuepoint permet à tout propriétaire de chaîne qui diffuse un événement en direct sur YouTube d'insérer des points de repère dans cette diffusion, ce qui peut déclencher des pauses publicitaires. Cette méthode remplace la méthode liveCuepoints.insert, qui permettait uniquement aux partenaires de contenu YouTube d'insérer des repères 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 prise en charge à 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 resteront inchangé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 de cadeau d'abonnement. De même, la nouvelle propriété snippet.giftMembershipReceivedDetails et ses enfants contiennent des informations sur l'événement "Abonnement reçu 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 au cours d'une période donnée. Le motif 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 préciser que la propriété est en lecture seule. Cela ne reflète pas un changement au niveau des 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 : Cette modification 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'arrêt de la fonctionnalité annoncée le 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. Par conséquent, 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 a été abandonné en 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 des contenus YouTube en direct via HLS a été mis à jour. Voici les modifications apportées :

  • La durée recommandée pour un segment multimédia a été mise à jour et est désormais comprise entre une et quatre secondes.
  • Une nouvelle section explique comment obtenir une URL d'ingestion HLS depuis 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 pour chaque protocole et des informations supplémentaires concernant les cas d'utilisation appropriés pour chaque protocole.

16 avril 2020

Cette mise à jour inclut une nouvelle propriété et une annonce d'obsolescence :

  • 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 la vidéo sur le flux vidéo associé.

    Le document sur le cycle de vie d'une diffusion a été mis à jour pour expliquer comment le processus pas à pas de création et de gestion d'un événement YouTube en direct change 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. La date à laquelle les modifications prennent effet est appelée ci-dessous "date d'arrêt".

    Cette mise à jour explique une modification potentiellement destructive. Cela concerne les applications clientes de l'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 permanents ne fonctionneront plus pour 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.
    • Il 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. À partir de la date d'abandon :
      • Si la valeur du paramètre broadcastType est persistent, la méthode liveBroadcasts.list ne renverra 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 heure.

    Pour rappel, ces dernières années, YouTube a automatiquement créé un flux et une diffusion par défaut pour une chaîne lorsque le streaming en direct était activé. Le flux par défaut existait indéfiniment, n'était associé à aucune heure de début ni 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 diffusions ni de diffusions en direct par défaut. Au lieu de s'appuyer sur les ressources par défaut, les clients de l'API doivent pouvoir créer et gérer les ressources liveBroadcast et liveStream, et les associer.
    • 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 la 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 la suppression effective.

    Si votre application est concernée, veuillez consulter les documents suivants, qui vous aideront à la mettre à jour pour 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 La 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 que vous devez effectuer pour accomplir une action spécifique. Votre application devra suivre ce processus lorsque YouTube cessera de prendre en charge les diffusions et les flux 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 acceptée à partir du 30 septembre 2020. Les clients de l'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 création des URL d'ingestion principales 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 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, veuillez consulter 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 multimédia 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 des contenus YouTube en direct via HLS fournit des consignes pour utiliser HLS afin de diffuser des contenus en direct sur YouTube à partir d'un encodeur. Ce guide vise à aider les fournisseurs d'encodeurs à ajouter la prise en charge de 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 pour fournir des exemples de code dynamiques et de haute qualité grâce au widget APIs Explorer. Pour voir un exemple, consultez la documentation de la méthode liveBroadcasts.list. Deux nouveaux éléments sont désormais disponibles sur les 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 API et d'afficher les réponses correspondantes. Le widget propose également une vue 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 remplir 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 trouver 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 disponibles pour 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 les cas d'utilisation de différentes méthodes, de charger des valeurs dans l'explorateur d'API et d'ouvrir l'explorateur d'API en plein écran pour obtenir des exemples de code en Java, JavaScript, PHP et Python.

    En parallèle, les pages qui listaient 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 Super Chat qui affiche une image. Comme les autres Super Chats, les Super Stickers sont achetés par les fans pendant une diffusion en direct sur YouTube.

  • 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 autocollant 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, le booléen snippet.isSuperStickerEvent indique si le message Super Chat est également un Super Sticker. Si c'est le cas, l'objet snippet.superStickerMetadata contient des informations supplémentaires sur le Super Sticker.

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 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 du 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 qu'en tant 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'un flux en direct YouTube. Dans le flux de chat en direct YouTube, les Super Chats se démarquent des autres messages de deux manières :

      • Les Super Chats sont mis en évidence à l'aide d'une couleur.
      • Les Super Chats restent épinglés dans le bandeau pendant une certaine période.

      La couleur du Super Chat, la durée pendant laquelle il reste épinglé dans le bandeau et la longueur maximale du message sont toutes 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 des 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 est compatible avec 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 d'erreur pour les deux nouvelles erreurs sont respectivement invalidEmbedSetting et invalidProjection.

12 janvier 2017

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

En même temps que la nouvelle fonctionnalité Super Chat, YouTube a rendu obsolète la fonctionnalité Financement par les fans. L'API 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 d'API YouTube ("les Nouvelles Conditions"), détaillées sur le blog YouTube Engineering and Developers, apportent de nombreuses modifications aux Conditions d'utilisation actuelles. En plus des Conditions d'utilisation mises à jour, 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 complet des nouveaux documents est décrit dans l'historique des révisions des Conditions modifiées. De plus, les futures modifications apportées aux Conditions modifiées 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 à cet historique des révisions à partir d'un lien dans ce 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 consignes 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 prise en charge de 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 est désormais compatible avec les diffusions en direct 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.

      • Suite à 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 sont pas cohérentes.

        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.

    • Mises à jour de la ressource liveBroadcast

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

        Propriétés
        contentDetails.boundStreamLastUpdateTimeMs Date et heure de la dernière mise à jour du flux en direct référencé 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 de 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é exclu 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 est compatible avec 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 au cours d'une période donnée. Le motif de l'erreur est userRequestsExceedRateLimit.

      Les méthodes liveBroadcasts.insert et liveBroadcasts.update prennent déjà en charge la même erreur.
      liveStreams.insert La méthode liveStreams.insert est compatible avec 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 d'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 d'elles indique 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 : Le reason de la réponse d'erreur est liveStreamModificationNotAllowed.

18 décembre 2015

Les lois de l'Union européenne (UE) exigent que certaines informations soient fournies aux utilisateurs finaux dans l'UE et que leur consentement soit obtenu. Par conséquent, pour les utilisateurs finaux dans l'Union européenne, vous devez respecter les Règles relatives au consentement de l'utilisateur dans l'UE. Nous avons ajouté une notification concernant cette exigence dans nos Conditions d'utilisation de l'API YouTube.

17 décembre 2015

Cette mise à jour inclut les changements suivants :

  • Nouvelles ressources et méthodes

    • L'API est compatible avec 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 fonctions administratives 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 des 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 prend en charge 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 fonctions administratives, comme bannir des utilisateurs du chat ou supprimer des messages. L'API est compatible avec 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 est compatible avec les méthodes d'insertion et de suppression 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 des fans d'une chaîne. Les événements de financement participatif lancés via le chat en direct d'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 des fans, consultez le Centre d'aide YouTube.
      sponsors La ressource sponsor identifie un sponsor d'une chaîne YouTube. Un membre verse des frais mensuels à une chaîne. Un badge s'affiche à côté des messages des sponsors 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'inscrivent pour soutenir une chaîne pendant une diffusion en direct appartenant à cette chaîne, l'API ajoute également un message newSponsorEvent au chat en direct de la diffusion.

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

  • Mises à jour des 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 d'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 des diffusions 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 de santé 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 la diffusion est à l'état 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 Lister les messages du chat en direct d'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 la diffusion.

  • 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é. Consultez la définition de la propriété pour en savoir plus sur le fonctionnement des flux par défaut.
      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 pour les 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 des vidéos en direct à YouTube, et la diffusion permet aux spectateurs de 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 qu'une 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 si la fonctionnalité de chat en direct est activée. Notez que cette propriété n'indiquera aucune valeur une fois la diffusion terminée. Par conséquent, cette propriété n'indique 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 qu'il ne le soit plus, ni inversement. Pour en savoir plus, consultez Comprendre les diffusions et les flux.

21 mai 2015

Cette mise à jour inclut les changements suivants :

  • YouTube permet désormais de diffuser des vidéos en direct à 60 images par seconde (ips), ce qui permet une lecture plus fluide pour les vidéos de jeux et autres vidéos d'action. Lorsque vous démarrez une diffusion en direct sur YouTube à 60 ips, YouTube la propose également à 30 ips sur les appareils qui ne peuvent pas encore afficher 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 est désormais compatible avec les erreurs suivantes :

    Type d'erreur Détails 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. Des informations expliquant pourquoi l'utilisateur ne peut pas diffuser de vidéo en direct peuvent être disponibles dans 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 les deux cette erreur pour indiquer que l'utilisateur a envoyé trop de requêtes au cours d'une période donnée.

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 n'a pas de flux de contrôle.

  • Toutes les méthodes pour les 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érents canaux associés 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étails 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 peuvent ê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 préciser 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 des 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 est désormais compatible avec les diffusions programmées pour durer 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 continuer indéfiniment.

  • La propriété contentDetails.recordFromStart de la ressource liveBroadcast, qui avait déjà une valeur par défaut de true, ne peut désormais être définie sur false que si la chaîne de diffusion 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 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 est compatible avec les nouvelles erreurs suivantes :

    Type d'erreur Détails 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 ou 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 l'erreur cdnRequired, contrairement à la méthode liveStreams.insert.

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 été modifiées 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 slates 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 Premiers pas 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, dans la mesure du possible, fournir des conseils sur la façon de les corriger.

  • L'API peut désormais renvoyer plusieurs nouvelles erreurs. La liste ci-dessous identifie l'erreur et la méthode d'API qui peut 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 ou ne définit pas de valeur pour la propriété contentDetails.enableArchive.
    • liveBroadcasts.update : la ressource ne contient pas ou ne définit pas de valeur pour la propriété contentDetails.enableContentEncryption.
    • 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 ou ne définit pas de valeur pour la propriété snippet.title.

  • La documentation sur la ressource liveStream a été mise à jour pour indiquer que le multicast et WebM ne sont pas des méthodes d'ingestion acceptées, 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 ainsi que 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.