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

9 octobre 2023

Pour référence uniquement, vous pouvez trouver les ID d'autocollant 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 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 est désormais compatible avec un nouveau moyen d'insérer des annonces dans les diffusions en direct. En plus de liveCuepoints, qui vous permet d'insérer manuellement des coupures publicitaires dans une diffusion, YouTube est désormais compatible avec une fonctionnalité permettant d'insérer automatiquement et à intervalles fixes des coupures publicitaires mid-roll dans une diffusion.

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

  • la longueur de l'intervalle entre les coupures publicitaires mid-roll.
  • la stratégie de planification des points de repère des annonces. Vous pouvez insérer des points de repère simultanément pour tous les spectateurs, ou leur durée peut varier d'un spectateur à l'autre. Avec cette stratégie, YouTube peut programmer des points de repère à une fréquence plus élevée, ce qui permet aux spectateurs de les recevoir lorsqu'ils peuvent le faire.
  • 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 des annonces mid-roll est mise en veille jusqu'à un moment précis.

La documentation reflète les modifications suivantes de l'API 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 permet de mettre en veille l'insertion des annonces mid-roll pendant une certaine période pour une diffusion en direct. La documentation identifie désormais plusieurs erreurs qui peuvent se produire lorsque vous mettez à jour les informations de monétisation d'une diffusion en direct.

1er août 2023

Cette mise à jour inclut les changements suivants :

  • Avec la méthode liveBroadcasts.update, il n'est plus nécessaire de spécifier des valeurs pour ces champs:

    • snippet.title
    • status.privacyStatus

    Si vous ne les renseignez pas dans la requête, les champs ne seront pas modifiés.

1er novembre 2022

  • La nouvelle méthode liveBroadcasts.cuepoint permet à tout propriétaire de chaîne qui diffuse une diffusion 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:Ceci est 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 d'API doivent mettre à jour leurs applications pour appeler la méthode liveBroadcasts.cuepoint.

  • La documentation sur la méthode liveBroadcasts.control a été supprimée. Un avis d'abandon pour 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 la spécification de valeurs pour ces champs:

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

    Si vous ne les renseignez pas dans la requête, les champs ne seront pas modifiés.

  • Suppression de la documentation concernant 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 sans frais.

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. Motif de l'erreur : userRequestsExceedRateLimit.

21 septembre 2020

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

    Pour indiquer qu'une diffusion en direct est 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 comprend une annonce d'abandon et la mise à jour d'une annonce précédente d'abandon.

    La méthode liveBroadcasts.control sera abandonnée à compter du 1er octobre 2020. Après cette date, tous les appels à cette méthode renverront une erreur "Interdit" (403), et la méthode sera complètement supprimée par la suite. Les clients peuvent toujours implémenter leur propre isolation en ajoutant une superposition à 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 sera effective à compter du 1er octobre 2020. 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 par rapport à une annonce précédente concernant l'abandon.

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

Si votre code utilise toujours le champ cdn.format, il doit être mis à jour pour spécifier séparément la fréquence d'images et la résolution à 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 passée d'une à quatre secondes.
  • Une nouvelle section explique comment obtenir une URL d'ingestion HLS depuis YouTube Studio.
  • Les instructions de mise en forme de la valeur du paramètre file ont été déplacées vers la nouvelle section Remplir 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.

En outre, la nouvelle page de comparaison des protocoles d'ingestion répertorie les protocoles d'ingestion compatibles avec YouTube, les codecs compatibles avec chacun d'eux et fournit des informations supplémentaires sur les cas d'utilisation appropriés pour chacun d'eux.

16 avril 2020

Cette mise à jour comprend une nouvelle propriété et une annonce d'abandon:

  • La ressource liveBroadcast accepte désormais la propriété contentDetails.enableAutoStop. La propriété indique si la 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 dans le flux vidéo associé.

    Le document Durée d'une diffusion a été mis à jour pour expliquer comment le processus détaillé 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:Ceci est une annonce d'abandon. Ces modifications entreront en vigueur le 1er septembre 2020 ou après cette date. La date réelle à laquelle les modifications prennent effet est désignée ci-dessous comme date d'abandon.

    Cette mise à jour explique une modification potentiellement destructive. Il affecte les applications clientes 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 fonctionneront plus pour lancer de nouvelles diffusions.

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

    • Elle vérifie la valeur de la propriété isDefaultBroadcast de la ressource liveBroadcast. Cette propriété ne sera pas renvoyée après la date d'abandon.
    • Elle vérifie la valeur de la propriété isDefaultStream de la ressource liveStream. Cette propriété ne sera pas 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. En raison de ces modifications, ce paramètre sera obsolète. À 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 renvoie pas les diffusions persistantes qui existaient avant cette date.

    Ces dernières années, YouTube a automatiquement créé un flux et une diffusion par défaut pour les chaînes dont le streaming en direct était activé. Le flux par défaut existait indéfiniment, n'était associé à aucune heure de début ou de fin et ne pouvait pas être supprimé. De même, l'annonce par défaut était considérée comme persistante. Elle existait toujours et n'était associée à aucun événement particulier.

    À compter de la date d'abandon:

    • YouTube ne créera plus de diffusions 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 la diffusion par défaut par défaut d'une chaîne sont activement diffusées en direct, c'est-à-dire que la chaîne les utilise pour une diffusion en direct au moment où l'abandon entre en vigueur, la diffusion en cours ne sera pas affectée. Cependant, une fois la diffusion terminée, la chaîne ne pourra plus utiliser à nouveau la diffusion ni le flux par défaut.
    • Si la diffusion et la diffusion par défaut par défaut d'une chaîne ne sont pas activement en direct, 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 cette modification:

    • Un nouveau guide de migration tente d'expliquer les étapes que les développeurs peuvent avoir besoin de suivre dans les clients API qui utilisent actuellement des diffusions et des flux par défaut.
    • Le guide Cycle de vie d'une diffusion vous guide pas à pas dans la création et la gestion d'un événement en direct sur YouTube. Chaque étape décrit les appels d'API ou les autres opérations que vous devez effectuer pour effectuer une action spécifique. Votre application devra suivre cette procédure lorsque YouTube cessera de prendre en charge les flux et les diffusions par défaut.

31 mars 2020

Remarque:Ceci est une annonce d'abandon.

Abandon de la ressource sponsor et de la méthode sponsors.list, remplacées par la ressource member et la méthode members.list.

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

11 mars 2020

La section Point de terminaison de l'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 renseigner la valeur du paramètre file= lors de la création 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 vous permet désormais d'identifier les contenus destinés aux enfants, que nous appelons "conçus pour les enfants" dans YouTube. Pour en savoir plus sur les contenus conçus pour les enfants, consultez le Centre d'aide YouTube.

  • La ressource liveBroadcast accepte 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 de spécifier 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 du canal a autorisé la requête API.
    • La propriété madeForKids permet à tout utilisateur de l'API de déterminer si une diffusion est définie comme "conçue pour les enfants". Par exemple, l'état peut être déterminé en fonction de la valeur de la propriété selfDeclaredMadeForKids. Consultez le Centre d'aide YouTube pour savoir comment définir l'audience de votre chaîne, de vos vidéos ou de vos diffusions.
  • Dans l'API YouTube Data, la ressource channel accepte également 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 les Conditions d'utilisation des services d'API YouTube – Historique des révisions. 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 Conditions requises du guide Diffuser des contenus 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é en cas de perte d'une playlist multimédia côté serveur. Par exemple, vous pouvez inclure jusqu'à deux segments confirmés et jusqu'à cinq segments en attente dans chaque playlist de contenus multimédias.
  • Vous devez désormais envoyer une playlist multimédia pour chaque segment multimédia. Cela permet au serveur de récupérer rapidement si une playlist multimédia est perdue. Cette pratique était auparavant répertoriée dans les recommandations.

28 juin 2019

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

Le nouveau guide Diffuser du contenu YouTube en direct via HLS fournit des consignes sur l'utilisation du protocole HLS pour diffuser du contenu en direct sur YouTube à partir d'un encodeur. Ce guide a pour but d'aider les fournisseurs d'encodeurs à proposer 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 afin de mieux expliquer les cas d'utilisation courants de chaque méthode, et de fournir des exemples de code dynamiques et de haute qualité via le widget APIs Explorer. Consultez la documentation de la méthode liveBroadcasts.list pour obtenir un exemple. Deux nouveaux éléments sont désormais disponibles sur les pages qui décrivent les méthodes d'API:

    • Le widget APIs Explorer vous permet de sélectionner des champs d'application d'autorisation, de saisir des exemples de valeurs de paramètres et de propriétés, puis d'envoyer des requêtes API réelles et de consulter les réponses réelles de l'API. Le widget propose également un affichage en plein écran avec des exemples de code complets mis à jour de façon dynamique pour utiliser les champs d'application 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 des exemples de valeurs dans APIs Explorer 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 des exemples de code dispose également d'une nouvelle interface utilisateur qui offre les mêmes fonctionnalités que celles décrites ci-dessus. À l'aide de cet outil, vous pouvez explorer des cas d'utilisation de différentes méthodes, charger des valeurs dans APIs Explorer et ouvrir l'explorateur d'API en plein écran pour obtenir des exemples de code en Java, JavaScript, PHP et Python.

    Parallèlement à ce changement, les pages qui recensaient 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 qu'elles 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, les messages Super Sticker 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 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 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 a été abandonné au début de l'année 2017.

3 avril 2017

De nouveaux exemples de code Java ont été ajoutés pour montrer comment répertorier, insérer et supprimer les messages du 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 requis. De plus, la description de la méthode a été modifiée 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 formatée conformément aux conventions d'une langue particulière. 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 d'affichage telles qu'elles seraient utilisées en anglais. Par exemple, le format par défaut d'une chaîne est $1.00 au lieu de $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 chat en direct YouTube, les messages Super Chat se démarquent des autres de deux façons:

      • Les Super Chats sont signalés par une couleur.
      • Les Super Chats restent épinglés dans le flux pendant une période donnée.

      La couleur du Super Chat, la durée pendant laquelle il reste épinglé dans le flux et sa longueur maximale sont déterminés par le montant de l'achat. Vous trouverez plus d'informations sur les Super Chats dans le Centre d'aide YouTube.

      L'API propose une méthode permettant de répertorier les événements Super Chat des diffusions en direct d'une chaîne ayant eu lieu au cours des 30 derniers jours. Cette méthode renvoie également des données sur les événements de financement par les fans (fanFundingEvents) issus 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.

  • Nouvelles erreurs et erreurs mises à jour

    • L'API accepte les nouvelles erreurs suivantes:

      Infos sur l'erreur
      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:Ceci est une annonce d'abandon.

Parallèlement au lancement de la nouvelle fonctionnalité Super Chat, YouTube a abandonné la fonctionnalité de financement par les fans, et l'API de financement par les fans a été 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 Conditions mises à jour"), discutées en détail sur le blog des ingénieurs et des développeurs YouTube, incluent un ensemble complet de mises à jour des conditions d'utilisation actuelles. En plus des Conditions mises à jour, qui entreront en vigueur le 10 février 2017, cette mise à jour inclut plusieurs documents justificatifs expliquant les règles que les développeurs doivent respecter.

    L'ensemble complet des nouveaux documents est décrit dans l'historique des révisions pour les nouvelles Conditions d'utilisation. En outre, les modifications futures apportées aux Conditions mises à jour ou à ces documents justificatifs seront également expliquées dans cet historique des révisions. Vous pouvez vous abonner à un flux RSS contenant les modifications de cet historique à partir d'un lien figurant 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 est compatible avec la nouvelle valeur dash pour identifier les flux ingérés dans YouTube à l'aide de DASH.

Le nouveau guide Diffuser du contenu YouTube en direct via DASH fournit des consignes sur l'utilisation du format de diffusion DASH pour diffuser des données en direct sur YouTube à partir d'un encodeur. Elle a pour but d'aider les fournisseurs d'encodeurs à ajouter une 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 ressources liveStream

      • YouTube prend désormais en charge 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 en 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 flux en direct aboutissent actuellement tant que vous spécifiez des valeurs pour la propriété cdn.format ou pour 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 en accord.

        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 ressources 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 l'annonce. 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 contient au moins un message de chat.

    • Mises à jour de ressources liveChatMessage

      • La propriété snippet.type accepte deux nouvelles valeurs (messageDeletedEvent et userBannedEvent) qui correspondent aux nouvelles propriétés décrites dans la liste à puces ci-dessous. 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 qui a été 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 l'exclusion est permanente ou temporaire. Si l'exclusion est temporaire, l'une des propriétés de l'objet spécifie la durée de l'exclusion.

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

  • Nouvelles erreurs et erreurs mises à jour

    • L'API accepte les nouvelles erreurs suivantes:

      Infos sur l'erreur
      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 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 motifs d'erreur et les propriétés auxquelles ils sont associés:
      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 motifs d'erreur et les propriétés auxquelles ils sont associés:
      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 aucune 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 dans la réponse d'erreur est liveStreamModificationNotAllowed.

18 décembre 2015

La législation de l'Union européenne (UE) exige que les utilisateurs finaux de l'UE puissent divulguer certaines informations et obtenir leur consentement. Par conséquent, pour les utilisateurs finaux de 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 les 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 compatibles avec la fonctionnalité de chat des diffusions en direct. YouTube est compatible avec 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 du chat, ainsi que les fonctions d'administration du chat.

      Ressources
      liveChatMessage Cette ressource correspond à un message dans un chat en direct YouTube. YouTube accepte plusieurs types de messages, y compris les SMS 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 soutiens ou la fin du chat. L'API est compatible avec des méthodes permettant de répertorier, 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 d'administration, comme exclure des utilisateurs du chat ou supprimer des messages. L'API accepte les méthodes permettant de répertorier, 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 sur un chat en direct. Les exclusions peuvent être temporaires ou permanentes. L'API accepte les méthodes permettant d'insérer et de supprimer des blocages du chat en direct.
      fanFundingEvents Cette ressource représente un événement de financement par les fans diffusé sur une chaîne YouTube. Le financement par les fans permet aux spectateurs de soutenir volontairement les créateurs YouTube en leur accordant une aide financière ponctuelle.

      La méthode fanFundingEvents.list de l'API répertorie les événements de financement par les fans d'une chaîne. Les événements de financement par les fans qui sont initié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 par les fans, consultez le Centre d'aide YouTube.
      sponsors La ressource sponsor identifie le sponsor d'une chaîne YouTube. Un sponsor verse un montant mensuel à 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 à des chats en direct réservés aux sponsors de la chaîne, le cas échéant.

      La méthode sponsors.list de l'API répertorie les sponsors d'une chaîne. Lorsque des utilisateurs s'inscrivent pour sponsoriser une chaîne au cours d'une diffusion en direct qui lui appartient, l'API ajoute également un message newSponsorEvent dans le chat en direct de la diffusion.

      Pour en savoir plus sur la fonctionnalité de soutien, 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. Avec cet ID, vous pouvez 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 au chat en direct ou annuler des exclusions existantes.
      contentDetails.closedCaptionsType Remarque: Cette propriété remplace la propriété contentDetails.enableClosedCaptions.

      Cette propriété indique si le sous-titrage est activé 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 envoyez 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 annonce 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. Vous pouvez y accéder via le tableau de bord des diffusions en direct de 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 fonctionnement suivantes:

    Erreurs
    audioTooManyChannels L'audio comporte plus de deux canaux, mais seuls un canal (mono) ou deux (stéréo) sont acceptés. Veuillez corriger le nombre de chaînes audio.
    frameRateHigh La fréquence d'images actuelle est trop élevée. Veuillez la définir sur %(framerate)s FPS ou moins.

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

  • Nouvelles erreurs et erreurs mises à jour

    • Outre les erreurs définies pour les nouvelles ressources répertoriées ci-dessus, l'API accepte les nouvelles erreurs suivantes:

      Infos sur l'erreur
      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 n'est pas compatible avec la valeur du paramètre contentDetails.closedCaptionType. Modifiez la ressource pour qu'elle n'inclue que l'une des deux propriétés, puis renvoyez la demande.

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 uniquement visible 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épertorier 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 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é. 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 flux. L'objet contient un certain nombre de propriétés enfants qui vous permettent d'évaluer l'état d'un flux vidéo en direct.

      Plus spécifiquement, l'objet status.healthStatus.configurationIssues[] répertorie les problèmes affectant un flux vidéo. Un nouveau document, Problèmes de configuration pour les ressources LiveStream, répertorie tous les problèmes signalés par l'API.
      contentDetails.isReusable Indique si le flux est réutilisable, c'est-à-dire qu'il peut être associé à plusieurs diffusions. Les diffuseurs réutilisent souvent le même flux pour plusieurs diffusions différentes si celles-ci se produisent à 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. Lorsque le streaming en direct est activé sur une chaîne YouTube, 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 la diffusion par défaut. Consultez la définition de la propriété pour en savoir plus sur le fonctionnement des annonces par défaut.
      contentDetails.enableLowLatency Indique si cette diffusion doit être encodée pour la diffusion en continu à faible latence. Un flux à faible latence permet de réduire la durée nécessaire pour que la vidéo soit visible par les utilisateurs qui regardent une diffusion, mais cela peut également avoir un impact sur la résolution pour les spectateurs.
      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é ne spécifie aucune valeur après la fin de la diffusion. Ainsi, cette propriété n'identifie pas le nombre de messages de chat d'une vidéo archivée d'une diffusion en direct terminée.

  • Nouvelles erreurs et erreurs mises à jour

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

      Infos sur l'erreur
      liveStreams.update
      Code de réponse HTTPforbidden (403)
      MotifliveStreamModificationNotAllowed
      DescriptionL'API ne vous permet pas de rendre un flux réutilisable non réutilisable, ou inversement. Pour en savoir plus, consultez la page Comprendre les diffusions et les flux.

21 mai 2015

Cette mise à jour inclut les changements suivants :

  • YouTube est désormais compatible avec le streaming vidéo en direct à 60 images par seconde (FPS), ce qui offre une lecture plus fluide pour les jeux vidéo et les vidéos d'action rapide. Lorsque vous lancez une diffusion en direct sur YouTube à 60 FPS, YouTube la rend également disponible à 30 FPS sur les appareils où le visionnage de la fréquence d'images élevée n'est pas encore disponible.

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

    Consultez le blog YouTube Creators pour en savoir plus sur cette fonctionnalité.

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é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 du contenu vidéo en direct sur YouTube. Vous trouverez des informations expliquant pourquoi l'utilisateur ne peut pas diffuser de vidéo en direct dans les paramètres de sa chaîne à l'adresse 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 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'un flux vidéo ne peut être lié qu'à un seul flux vidéo, mais qu'un flux vidéo peut être lié à plusieurs diffusions. Cette modification constitue uniquement une correction de la documentation. Les fonctionnalités sous-jacentes de l'API n'ont 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 annonce à 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'étape 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 cette propriété si votre diffusion ne comporte pas de flux de surveillance.

  • Toutes les méthodes des ressources liveBroadcast et liveStream prennent désormais en charge les paramètres onBehalfOfContentOwner et onBehalfOfContentOwnerChannel. Ces paramètres vous permettent d'utiliser les mêmes identifiants d'autorisation pour exécuter 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 lors de l'appel de 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 prend désormais en charge 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éos en direct sur YouTube. Vous trouverez des informations expliquant pourquoi l'utilisateur ne peut pas diffuser de vidéo en direct dans les paramètres de sa chaîne à l'adresse 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 prévue doit être suffisamment proche de la date actuelle pour qu'une diffusion puisse être planifiée de manière fiable à ce moment-là.

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 annonce, mais elle ne peut pas être mise à jour une fois que l'annonce est à l'état testing ou live. Si vous définissez cette propriété sur true, la ressource liveStream associée à la diffusion spécifie l'URL d'ingestion à utiliser pour les sous-titres de l'annonce.

  • La propriété snippet.scheduledEndTime de la ressource liveBroadcast est désormais compatible avec les diffusions programmées pour une durée indéterminée. Avec cette modification, la propriété n'est plus obligatoire 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 se poursuivre 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 est 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 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 essayez de mettre à jour une diffusion pour définir la propriété recordFromStart sur false, l'API renvoie une erreur modificationNotAllowed.

  • La ressource liveBroadcast ne contient plus de propriété enableArchive, 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 à laquelle le point de 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. Elle 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 d'écran se produit. 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 à la fois dans liveBroadcastListResponse et dans liveStreamListResponse.

  • L'API accepte 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 soit omettre les deux paramètres, soit spécifier une valeur pour l'un des deux paramètres.
    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 mettre à jour 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 soit omettre les deux propriétés, soit spécifier une valeur pour l'une d'elles.

    De plus, la méthode liveStreams.update n'accepte plus une erreur cdnRequired semblable à celle prise en charge par 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 "Affichage des écrans" du Guide de démarrage a été supprimée.

  • L'API ne permet plus d'insérer des écrans 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 Déroulement d'une diffusion ne mentionnent plus cette fonctionnalité.

    • La propriété settings.cueType de la ressource liveCuepoint n'accepte plus slate en tant que 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 afin d'expliquer plus clairement les erreurs possibles et de fournir, dans la mesure du possible, des conseils sur la façon de les corriger.

  • L'API peut maintenant 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 ne définit pas de valeur pour celle-ci.
    • liveBroadcasts.update : la ressource ne contient pas de valeur pour la propriété contentDetails.enableContentEncryption ou ne définit pas de valeur pour celle-ci.
    • liveBroadcasts.update : la ressource ne contient pas de valeur pour la propriété contentDetails.enableDvr ou ne définit pas de valeur pour celle-ci.
    • 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 ne définit pas de valeur pour celle-ci.

  • La documentation de la ressource liveStream a été mise à jour pour indiquer que la multidiffusion et WebM ne sont pas des méthodes d'ingestion compatibles, comme indiqué précédemment. La liste des formats de la propriété cdn.format a été mise à jour en conséquence. 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.