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. Abonnez-vous à ce journal des modifications. S'abonner

9 octobre 2023

Pour référence 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 été mises à jour pour refléter ces informations.

15 septembre 2023

L'API propose désormais une nouvelle méthode d'insertion d'annonces dans les diffusions en direct. 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 à intervalles fixes.

Si le propriétaire de la diffusion active les annonces automatisées, 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 planification des repères d'annonce. Les repères peuvent être insérés simultanément pour tous les spectateurs, ou leur synchronisation peut varier d'un spectateur à l'autre. Cette dernière stratégie permet à YouTube de programmer les points de repère à un rythme plus élevé afin que les spectateurs puissent les recevoir lorsqu'ils sont éligibles.
  • Période pendant laquelle les annonces mid-roll ne sont pas diffusées. Pour cette fonctionnalité, le propriétaire de la diffusion spécifie que l'insertion d'annonces mid-roll est suspendue jusqu'à une heure donnée.

La documentation reflète les modifications apportées à l'API 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 planifier des repères.
  • 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 d'annonces mid-roll pendant une certaine période lors d'une diffusion en direct. La documentation identifie désormais plusieurs erreurs pouvant 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 :

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

    • snippet.title
    • status.privacyStatus

    Si vous omettez ces champs de la requête, ils resteront inchangés.

1er novembre 2022

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

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

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

    La méthode liveCuepoints.insert est désormais obsolète. La prise en charge de la méthode liveCuepoints.insert sera supprimée à 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 :

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

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

    Si vous omettez ces champs de la requête, ils resteront inchangés.

  • Suppression de la documentation des 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 un abonnement". De même, la nouvelle propriété snippet.giftMembershipReceivedDetails et ses enfants contiennent des informations sur l'événement "Souscriptions à offrir reçues".

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 "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 "New Sponsor".

1er décembre 2020

La méthode liveBroadcasts.transition de l'API est compatible avec une nouvelle erreur 403 (Forbidden), qui indique que l'utilisateur a envoyé trop de requêtes dans un délai donné. 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 qu'elle est en lecture seule. Cela ne reflète pas un changement au niveau de la fonctionnalité 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 "Forbidden" (403), qui sera ensuite complètement supprimée. Les clients peuvent toujours implémenter leur propre slating en ajoutant une superposition à la vidéo envoyée aux serveurs d'ingestion de YouTube.

    La date d'abandon de l'annonce d'abandon faite le 16 avril 2020, initialement prévue pour le 1er septembre 2020, a été repoussée et prendra effet le 1er octobre 2020 ou à une date ultérieure. Par conséquent, les fonctionnalités incluses dans cette annonce d'abandon et la méthode liveBroadcasts.control seront toutes obsolètes 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 toujours ce champ échoueront à partir de cette date.

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

6 juillet 2020

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

  • La durée recommandée pour un segment multimédia est désormais 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 vous obteniez l'URL d'ingestion HLS à partir de l'API YouTube ou de YouTube 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 sur les cas d'utilisation appropriés pour chaque protocole.

16 avril 2020

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

  • La ressource liveBroadcast est désormais compatible avec la propriété contentDetails.enableAutoStop. Cette 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 arrêté la diffusion de la vidéo dans le flux vidéo associé.

    Le document Vie d'une diffusion a été mis à jour pour expliquer comment le processus de création et de gestion d'un événement YouTube en direct 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 prendront effet est appelée date d'abandon ci-dessous.

    Cette mise à jour explique une modification potentiellement destructive. Elle affecte les applications clientes d'API qui utilisent les ressources liveStream et liveBroadcast par défaut des chaînes pour diffuser du contenu en direct sur YouTube. Plus précisément, l'ID de diffusion et l'ID de flux associés à la diffusion et au flux persistants ne 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 pas 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 renvoie aucun résultat.
      • Si la valeur du paramètre broadcastType est all, la méthode liveBroadcasts.list ne renverra pas les diffusions persistantes qui existaient avant cette date.

    Pour information, depuis quelques années, YouTube crée automatiquement un flux et une diffusion par défaut pour une chaîne lorsqu'elle est activée pour le streaming en direct. Le flux par défaut existait indéfiniment, n'avait pas d'heure de début ni de fin associée 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'a pas été lié à un événement particulier.

    À compter de la date d'abandon:

    • YouTube ne créera plus de diffusions et 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 des ressources liveBroadcast et liveStream, et associer ces ressources.
    • Si la diffusion et le flux par défaut d'une chaîne sont actifs, c'est-à-dire qu'elle les utilise pour une diffusion en direct au moment de l'abandon, la diffusion en cours ne sera pas affectée. Cependant, une fois cette diffusion terminée, la chaîne ne pourra plus utiliser les diffusions et les diffusions 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 en vigueur.

    Si votre application est concernée, veuillez consulter les documents suivants, qui vous aideront à la mettre à jour afin qu'elle fonctionne toujours comme prévu après cette modification:

    • Un nouveau guide de migration tente d'expliquer les étapes que les développeurs peuvent être amenés à suivre dans les clients d'API qui utilisent actuellement des diffusions et des flux par défaut.
    • Le guide 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 d'autres éléments que vous devez effectuer pour effectuer une action spécifique. Votre application devra suivre ce processus lorsque YouTube cessera de prendre en charge les diffusions et les diffusions par défaut.

31 mars 2020

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

La ressource sponsor et la méthode sponsors.list sont obsolètes et ont été remplacées par la ressource member et la méthode members.list.

La méthode sponsors.list ne sera plus disponible à partir du 30 septembre 2020 ou à une date ultérieure. 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 cette 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 suivre pour renseigner la valeur du paramètre file= lors de la création des URL d'ingestion principales et de secours.

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 est compatible avec deux nouvelles propriétés permettant aux créateurs de contenu et aux spectateurs d'identifier les contenus conçus pour les enfants :
    • La propriété selfDeclaredMadeForKids permet aux créateurs de contenu de spécifier si une diffusion en direct est un contenu destiné 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 que dans les réponses d'API contenant des ressources liveBroadcast si le propriétaire de la chaîne a autorisé la requête d'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. Consultez le Centre d'aide YouTube pour découvrir 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 est également compatible avec les nouvelles propriétés selfDeclaredMadeForKids et madeForKids.

Nous avons également mis à jour les Conditions d'utilisation des services d'API YouTube et le Règlement pour les développeurs. Pour en savoir plus, consultez les Conditions d'utilisation des services des 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 du contenu YouTube en direct via HLS a été mise à jour avec deux modifications:

  • Elle explique qu'il est recommandé d'inclure à la fois les segments confirmés et les segments en suspens dans chaque playlist multimédia. Cette pratique réduit la probabilité qu'un segment soit ignoré si une playlist multimédia est perdue côté serveur. Par exemple, vous pouvez inclure jusqu'à deux segments confirmés et jusqu'à cinq segments en attente dans chaque playlist multimédia.
  • Vous devez désormais 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 considérée comme une recommandation.

28 juin 2019

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

Le nouveau guide Diffuser du contenu YouTube en direct via HLS fournit des instructions sur l'utilisation de HLS pour diffuser du contenu en direct sur YouTube à partir d'un encodeur. Ce guide vise à aider les fournisseurs d'encodeurs à ajouter 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 décrivent désormais les méthodes API sur les pages:

    • Le widget APIs Explorer vous permet de sélectionner des champs d'autorisation, de saisir des exemples de valeurs de paramètres et de propriétés, puis d'envoyer des requêtes d'API réelles et d'afficher les réponses d'API réelles. Le widget propose également une vue plein écran qui affiche des exemples de code complets, qui sont mis à jour dynamiquement pour utiliser les portées et les valeurs que vous avez saisies.

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

      Vous pouvez utiliser les liens de cette section pour renseigner APIs Explorer avec des exemples de valeurs pour votre cas d'utilisation ou pour ouvrir l'explorateur d'API en plein écran avec ces valeurs déjà renseignées. Ces modifications ont pour but de 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 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 conséquence, les pages qui listaient auparavant les exemples de code disponibles pour Java, PHP et Python ont été supprimées.

25 février 2019

La documentation des ressources liveChatMessage et superChatEvent a été mise à jour pour refléter le fait que les deux ressources peuvent désormais contenir des informations sur les Super Stickers. Les Super Stickers sont un type de message Super Chat qui affiche une image. Comme les autres Super Chats, un message Super Sticker est acheté par un fan pendant une diffusion en direct 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 autocollant. 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 de fanFundingEvents, qui ont été abandonnés début 2017.

3 avril 2017

De nouveaux exemples de code Java ont été ajoutés. Ils montrent 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 obligatoire. De plus, la description de la méthode a été mise à jour pour indiquer que les appels vers 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 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 formatage des chaînes d'affichage est défini par défaut comme s'il était utilisé en anglais. Par exemple, le format par défaut d'une chaîne est $1.00 et non $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 pendant une diffusion en direct YouTube. Dans le 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 période définie.

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

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

  • Mises à jour des ressources et méthodes existantes

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

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

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

  • Nouvelles erreurs et mises à jour d'erreurs

    • 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 raisons des deux nouvelles erreurs sont invalidEmbedSetting et invalidProjection, respectivement.

12 janvier 2017

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

Avec le lancement de la nouvelle fonctionnalité Super Chat, YouTube a abandonné la fonctionnalité de financement par les fans. L'API de financement par les fans sera désactivée le 28 février 2017. À 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"), présentées en détail sur le blog YouTube Engineering and Developers, fournissent de nombreuses mises à jour des conditions d'utilisation actuelles. En plus des nouveaux conditions d'utilisation, qui entreront en vigueur le 10 février 2017, cette mise à jour inclut plusieurs documents complémentaires pour aider à expliquer les règles que les développeurs doivent suivre.

    L'ensemble complet des nouveaux documents est décrit dans l'historique des révisions des nouvelles conditions d'utilisation. De plus, les futures modifications apportées aux nouvelles conditions ou aux documents justificatifs seront également expliquées dans cet historique des révisions. Vous pouvez vous abonner à un flux RSS listant les modifications de 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 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. L'objectif est 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 des ressources liveStream

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

        En outre, 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 les suivantes: 1440p, 1080p, 720p, 480p, 360p et 240p.

      • Avec 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 flux 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.

    • liveBroadcast mises à jour de ressources

      • 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 cette propriété sont 360 et rectangular.

      • La définition de la propriété statistics.totalChatCount de la ressource liveBroadcast a été modifiée 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 des ressources 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é modifiée 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é interdit de participer au chat. L'objet contient également des informations sur l'interdiction elle-même, à savoir si elle est permanente ou temporaire. Si l'interdiction 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.

  • Nouvelles erreurs et mises à jour d'erreurs

    • 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 prend en charge 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 prend en charge deux nouvelles erreurs 400 (Bad Request), chacune indiquant qu'une valeur requise n'est pas présente dans la ressource liveStream que la requête a tenté d'insérer. La liste suivante identifie les raisons d'erreur et les propriétés auxquelles elles sont associées:
      Plus précisément, lorsque vous insérez une ressource liveStream, vous devez spécifier une valeur pour la propriété cdn.format ou pour les propriétés cdn.frameRate et cdn.resolution.
      • L'API renvoie une erreur formatRequired si vous ne spécifiez 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 de la réponse d'erreur est liveStreamModificationNotAllowed.

18 décembre 2015

Conformément à la législation de l'Union européenne (UE), vous devez publier certaines informations à l'attention des utilisateurs finaux et obtenir leur consentement dans l'UE. Par conséquent, vous devez respecter les Règles relatives au consentement de l'utilisateur dans l'UE pour les utilisateurs finaux situés dans l'Union européenne. Nous avons ajouté une notification de 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 prend en charge plusieurs nouvelles ressources pour la fonctionnalité de chat des 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 du chat, ainsi que les fonctions administratives du chat.

      Ressources
      liveChatMessage Cette ressource représente 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 prend en charge les 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 administratives, comme bannir des utilisateurs de la discussion ou supprimer des messages. L'API prend en charge 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 dans un chat en direct spécifique. Les interdictions peuvent être temporaires ou définitives. L'API propose des méthodes permettant d'insérer et de supprimer des interdictions de 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éatrices et créateurs YouTube en leur faisant un don unique.

      La méthode fanFundingEvents.list de l'API liste les événements de financement par les fans d'une chaîne. Les événements de financement par les fans lancés par le biais d'un chat en direct lors d'une diffusion en direct appartenant à la chaîne déclenchent également l'envoi d'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 aux chats en direct exclusivement pour eux, 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 sponsoriser 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 sponsorings, 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, interdire à des utilisateurs de participer aux chats en direct ou supprimer des interdictions 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: les sous-titres sont envoyés via la méthode HTTP POST à une URL d'ingestion associée à votre diffusion en direct.
      • closedCaptionsEmbedded: les sous-titres seront encodés dans le flux vidéo à l'aide des formats EIA-608 et/ou CEA-708.
      contentDetails.enableClosedCaptions Cette propriété a été abandonnée 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 des diffusions d'événements, des 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 persistante, accessible via le tableau de bord des diffusions en direct de YouTube 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 précédente mise à jour de la documentation a été corrigée.

  • Nouvelles erreurs et mises à jour d'erreurs

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

      Informations sur les erreurs
      liveBroadcasts.update
      Code de réponse HTTPforbidden (403)
      MotifclosedCaptionsTypeModificationNotAllowed
      DescriptionLa valeur contentDetails.closedCaptionsType ne peut être modifiée que lorsque l'état de l'annonce est created ou ready.
      liveBroadcasts.update
      Code de réponse HTTPinvalidValue (400)
      MotifinvalidEnableClosedCaptions
      DescriptionDans la ressource liveBroadcast, la valeur de la propriété contentDetails.enableClosedCaptions est incompatible avec la valeur du paramètre contentDetails.closedCaptionType. Modifiez la ressource pour n'inclure 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 de la ressource liveChat et de ses méthodes est confidentielle et n'est visible que par certains partenaires YouTube.

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

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

      Les messages du chat en direct ne peuvent être récupérés et publiés que pendant 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'un canal existe indéfiniment, n'a pas d'heure de début ni de fin associée 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 pouvant ê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 heures différentes.

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

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

  • Erreurs nouvelles et mises à jour

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

      Informations sur les erreurs
      liveStreams.update
      Code de réponse HTTPforbidden (403)
      MotifliveStreamModificationNotAllowed
      DescriptionL'API ne vous permet pas de modifier un flux réutilisable pour le rendre non réutilisable, ni inversement. Pour en savoir plus, consultez la section 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 (ips), ce qui permet une lecture plus fluide pour les jeux vidéo et autres vidéos d'action. Lorsque vous lancez une diffusion en direct sur YouTube à 60 images par seconde, YouTube la propose également à 30 images par seconde sur les appareils qui ne sont pas encore disponibles pour le visionnage à 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étail de l'erreur Description
    insufficientPermissions liveStreamingNotEnabled Toutes les méthodes des ressources liveBroadcast et liveStream renvoient cette erreur si l'utilisateur qui a autorisé la requête API n'est pas autorisé à diffuser des vidéos en direct sur YouTube. Des informations expliquant pourquoi l'utilisateur ne peut pas diffuser de vidéos 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 dans un délai donné.

2 mai 2014

Cette mise à jour inclut les changements suivants :

  • Les descriptions de la ressource liveStream et de la méthode liveBroadcasts.bind ont été mises à jour pour indiquer qu'une diffusion ne peut être liée qu'à un seul flux vidéo, mais qu'un flux vidéo peut être lié à 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 indiquer que si la valeur de la propriété est true, vous devez passer votre diffusion à l'état testing avant de pouvoir la 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 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 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 indique désormais le code de réponse HTTP pour chaque type d'erreur.

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

    Type d'erreur Détail de l'erreur Description
    insufficientPermissions livePermissionBlocked Les méthodes liveBroadcasts.insert, liveBroadcasts.transition et liveStreams.insert renvoient cette erreur si l'utilisateur qui a autorisé la requête ne peut pas diffuser de vidéo en direct sur YouTube. Des informations expliquant pourquoi l'utilisateur ne peut pas diffuser de vidéos 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 les sous-titres peuvent être ingérés pour la diffusion. La valeur de la propriété peut être définie lorsque vous insérez ou mettez à jour une diffusion, mais elle ne peut pas être mise à jour une fois la diffusion dans 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 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 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 planifiée pour se poursuivre indéfiniment. De même, si vous appelez la méthode liveBroadcasts.insert ou liveBroadcasts.update sans spécifier de valeur pour cette propriété, la diffusion se poursuivra indéfiniment.

  • La propriété contentDetails.recordFromStart de la ressource liveBroadcast, dont la valeur par défaut était déjà 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 essayez 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, qui était mentionnée dans les descriptions des propriétés contentDetails.enableDvr et contentDetails.enableEmbed.

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

  • La nouvelle propriété settings.walltime de la ressource liveCuepoint spécifie la date et l'heure auxquelles le repère doit être inséré. L'API renvoie une erreur si une requête tente d'insérer un point de repère spécifiant une valeur pour cette propriété et 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 du changement d'écran. L'API renvoie une erreur si une requête spécifie une valeur pour ce paramètre et 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étail de l'erreur Description
    invalidValue conflictingTimeFields La méthode liveBroadcasts.control renvoie cette erreur si votre requête spécifie des valeurs pour les paramètres offsetTimeMs et walltime. Une requête peut omettre les deux paramètres ou spécifier une valeur pour l'un des deux.
    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 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 soit omettre les deux propriétés, soit spécifier une valeur pour l'une des deux propriétés.

    En outre, la méthode liveStreams.update n'accepte plus une erreur cdnRequired semblable à celle acceptée 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 sur la 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 pour les corriger.

  • L'API peut désormais renvoyer plusieurs nouvelles erreurs. La liste ci-dessous identifie l'erreur et la méthode d'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 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 les ressources liveStream a été mise à jour pour indiquer que les méthodes d'ingestion multicast et WebM ne sont pas compatibles, comme indiqué précédemment. La liste des formats de la propriété cdn.format a été mise à jour en conséquence, et l'objet cdn.multicastIngestionInfo et ses propriétés enfants ont été supprimés de la documentation de la ressource. De plus, http a été supprimé de la liste des valeurs cdn.ingestionType acceptées.