Historique des révisions

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

10 juillet 2025

À partir du 21 juillet 2025, YouTube ajustera le contenu renvoyé par le graphique mostPopular de la méthode video.list. Auparavant, le graphique mostPopular reflétait les vidéos présentées dans la liste "Tendances du moment". Désormais, le classement mostPopular inclura des vidéos des classements "Tendances" pour la musique, les films et les jeux vidéo. Cette modification de l'API est liée à l'arrêt de la page des tendances de YouTube.

26 mars 2025

À partir du 31 mars 2025, YouTube va modifier la façon dont les vues de Shorts sont comptabilisées. Jusqu'à présent, pour les Shorts, une vue était comptabilisée lorsqu'un Short était regardé pendant un certain nombre de secondes. Désormais, les vues comptabiliseront le nombre de fois qu'un Short commence à être regardé ou est regardé à nouveau, sans durée de visionnage minimale requise. En savoir plus

À partir du 31 mars 2025, les champs suivants de l'API Data renverront le nombre de vues des Shorts conformément à cette modification :

• channels.statistics.viewCount
• videos.statistics.viewCount

30 octobre 2024

L'API permet désormais d'identifier les vidéos contenant du contenu modifié ou synthétique (M/S) d'apparence réaliste. En savoir plus sur les Règles YouTube concernant les contenus A/S

Voici quelques exemples de contenus A/S :

• Faire dire ou faire à une personne réelle quelque chose qu'elle n'a pas dit ni fait
• Modifier les images d'un événement ou d'un lieu réel
• Proposer une scène d'apparence réaliste alors qu'elle n'a jamais eu lieu

Pour indiquer si une vidéo contient du contenu A/S, définissez la propriété status.containsSyntheticMedia. Cette propriété peut être définie lors de l'appel des méthodes videos.insert ou videos.update. Si elle est définie, la propriété est renvoyée dans la ressource video.

30 avril 2024

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

Cette mise à jour inclut les changements suivants :

L'API ne permet plus d'insérer ni de récupérer les discussions sur les chaînes. Cette modification est conforme à la fonctionnalité disponible sur le site Web YouTube, qui ne permet pas de publier des commentaires sur les chaînes.

13 mars 2024

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

Cette mise à jour inclut les changements suivants :

Le paramètre sync des méthodes captions.insert et captions.update a été abandonné. YouTube ne prendra plus en charge le paramètre à partir du 12 avril 2024.

Suite à ce changement, les développeurs doivent inclure des informations de timing lorsqu'ils insèrent ou mettent à jour des pistes de sous-titres. Sinon, l'importation échouera.

12 mars 2024

Cette mise à jour inclut les changements suivants :

La documentation de la ressource captions a été mise à jour pour indiquer que la longueur maximale autorisée pour le champ snippet.name est de 150 caractères. L'API renvoie une erreur nameTooLong si le nom de la piste est plus long.

7 mars 2024

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

La propriété de ressource channel brandingSettings.channel.moderateComments est obsolète. YouTube ne prendra plus en charge le paramètre à partir du 7 mars 2024.

31 janvier 2024

Cette mise à jour inclut les changements suivants :

Le nouveau paramètre forHandle de la méthode channels.list vous permet de récupérer des informations sur une chaîne en spécifiant son identifiant YouTube.

9 novembre 2023

Toutes les références à la ressource videoId sous Comments ont été supprimées, car la ressource videoId n'est pas renvoyée à l'aide d'un appel d'API.

12 septembre 2023

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

La méthode comments.markAsSpam est obsolète depuis plusieurs années. Cette méthode n'est déjà plus disponible sur YouTube et ne l'est plus non plus via l'API.

Un avis d'abandon a été ajouté à tous les documents faisant référence à la méthode comments.markAsSpam.

22 août 2023

La méthode search.list est désormais compatible avec le paramètre videoPaidProductPlacement. Ce paramètre vous permet de filtrer les résultats de recherche pour n'inclure que les vidéos pour lesquelles le créateur a indiqué qu'elles contenaient une promotion payante.

18 août 2023

La définition de la ressource video liveStreamingDetails.concurrentViewers a été mise à jour pour indiquer que le nombre de spectateurs simultanés renvoyé par l'API YouTube Data peut différer du nombre de spectateurs simultanés traité et débarrassé du spam disponible dans YouTube Analytics. Le Centre d'aide YouTube fournit plus d'informations sur les métriques des diffusions en direct.

7 août 2023

Comme annoncé le 12 juin 2023, le paramètre relatedToVideoId de la méthode search.list a été abandonné. Ce paramètre n'est plus compatible et les références à ce paramètre ont été supprimées de la documentation de l'API.

28 juin 2023

La méthode thumbnails.set est désormais compatible avec l'erreur uploadRateLimitExceeded, qui indique que la chaîne a importé trop de miniatures au cours des dernières 24 heures et qu'elle doit réessayer plus tard.

12 juin 2023

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

Le paramètre relatedToVideoId de la méthode search.list a été abandonné. YouTube ne prendra plus en charge le paramètre à partir du 7 août 2023.

Pour le moment, un avis d'abandon a été ajouté à la documentation de la méthode search.list. Ce paramètre sera entièrement supprimé de la documentation search.list le 7 août 2023 ou après.

De plus, un exemple montrant comment récupérer des vidéos associées a été supprimé du guide d'implémentation de l'API.

22 août 2022

Correction des annotations de type pour les champs video.statistics de "unsigned long" à "string".

5 août 2022

YouTube a modifié la façon dont les ID de sous-titres sont générés et, dans le cadre de ce changement, attribue de nouveaux ID de sous-titres à toutes les pistes de sous-titres. Cette modification peut être incompatible avec les versions antérieures pour les applications qui stockent des valeurs caption_id, mais elle n'affectera pas les applications qui ne stockent pas de valeurs caption_id.

D'ici le 1er décembre 2022, les méthodes captions.list, captions.update, captions.download et captions.delete seront compatibles avec les anciens et les nouveaux ID de pistes de sous-titres. Toutefois, à compter du 1er décembre 2022, YouTube ne prendra plus en charge les anciens ID de pistes de sous-titres. À ce moment-là, l'appel de l'une de ces méthodes d'API avec un ancien ID de piste de sous-titres générera une erreur captionNotFound.

Pour vous préparer à ce changement, vous devez prévoir de remplacer complètement toutes les données de pistes de sous-titres stockées d'ici le 1er décembre 2022. Cela signifie que pour toute vidéo pour laquelle vous stockez des données de piste de sous-titres, vous devez supprimer les données actuellement stockées, puis appeler la méthode captions.list pour récupérer l'ensemble actuel de pistes de sous-titres de la vidéo et stocker les données dans la réponse de l'API comme vous le feriez normalement.

12 juillet 2022

Les conditions d'utilisation des services d'API YouTube ont été mises à jour. Pour en savoir plus, veuillez consulter l'historique des révisions des conditions d'utilisation des services d'API YouTube.

27 avril 2022

La description de la méthode videos.insert a été mise à jour pour indiquer que la taille maximale des fichiers vidéo importés est passée de 128 Go à 256 Go.

8 avril 2022

Les définitions des paramètres myRecentSubscribers et mySubscribers de la méthode subscriptions.list ont été mises à jour pour indiquer que le nombre maximal d'abonnés renvoyé par l'API peut être limité. Cette modification représente une correction de la documentation et non un changement de comportement de l'API.

15 décembre 2021

Comme annoncé le 18 novembre 2021, en même temps que les modifications apportées pour rendre privés les nombres de "Je n'aime pas" sur l'ensemble de la plate-forme YouTube, la propriété statistics.dislikeCount de la ressource video est désormais privée.

Pour en savoir plus sur ce changement, consultez le blog officiel de YouTube.

18 novembre 2021

En parallèle des modifications visant à rendre privé le nombre de "Je n'aime pas" des vidéos sur l'ensemble de la plate-forme YouTube, la propriété statistics.dislikeCount de la ressource video sera rendue privée à compter du 13 décembre 2021. Cela signifie que la propriété ne sera incluse dans une réponse d'API du point de terminaison videos.list que si la requête d'API a été authentifiée par le propriétaire de la vidéo.

Le point de terminaison videos.rate n'est pas concerné par ce changement.

Les développeurs qui n'affichent pas publiquement le nombre de "Je n'aime pas" et qui ont toujours besoin de ce nombre pour leur client API peuvent demander à être ajoutés à une liste d'autorisation pour bénéficier d'une exemption. Pour demander une exemption, vous devez remplir ce formulaire de demande.

Pour en savoir plus sur ce changement, consultez le blog officiel de YouTube.

2 juillet 2021

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

Le point de terminaison commentThreads.update a été abandonné et n'est plus accepté. Ce point de terminaison dupliquait les fonctionnalités disponibles via d'autres points de terminaison d'API. Vous pouvez plutôt appeler comments.update.

et, si votre code nécessite une ressource commentThreads, effectuez un appel secondaire à la méthode commentThreads.list.

1er juillet 2021

Tous les développeurs qui utilisent les services d'API YouTube doivent passer un audit de conformité des API pour obtenir un quota supérieur à celui par défaut de 10 000 unités. Jusqu'à présent, les développeurs devaient remplir et envoyer le formulaire d'audit et d'augmentation de quota des services d'API YouTube pour effectuer un audit de conformité et demander des unités de quota supplémentaires.

Pour clarifier ces processus et mieux répondre aux besoins des développeurs qui utilisent nos services d'API, nous ajoutons trois nouveaux formulaires et un guide pour les remplir :

• Formulaire de demande pour les développeurs ayant fait l'objet d'un audit : les développeurs qui ont déjà réussi un audit de conformité de l'API peuvent remplir et envoyer ce formulaire plus court pour demander une extension du quota alloué.
• Formulaire d'appel : les développeurs dont les projets d'API n'ont pas réussi l'audit de conformité (ou dont la demande d'augmentation des unités de quota a été refusée) peuvent remplir et envoyer ce formulaire.
• Formulaire de changement de contrôle : les développeurs ou toute partie exploitant un client API pour le compte d'un développeur qui font l'objet d'un changement de contrôle (par exemple, en raison d'une acquisition ou d'une vente d'actions, d'une fusion ou d'une autre forme de transaction d'entreprise) associé à un projet d'API doivent remplir et envoyer ce formulaire. Cela permet à l'équipe de l'API YouTube de mettre à jour nos enregistrements, d'auditer la conformité du cas d'utilisation du nouveau projet d'API et de valider l'attribution actuelle du quota du développeur.

Chaque nouveau formulaire nous informera de l'utilisation que vous prévoyez de faire de l'API YouTube et nous permettra de mieux vous aider.

Pour en savoir plus, consultez notre nouveau guide sur les audits de conformité des API.

12 mai 2021

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

Cette mise à jour couvre les modifications suivantes apportées à l'API :

• La propriété contentDetails.relatedPlaylists.favorites de la ressource channel est obsolète. La fonctionnalité de vidéos favorites a déjà été abandonnée il y a plusieurs années, comme indiqué dans l'entrée de l'historique des révisions du 28 avril 2016.

  Avant cette mise à jour, l'API créait toujours une playlist si un client API tentait d'ajouter une vidéo à une playlist de favoris inexistante. À l'avenir, la playlist ne sera pas créée dans ce cas et l'API renverra une erreur. Les tentatives de modification des playlists de favoris (ajout, modification ou suppression d'éléments) sont également toutes obsolètes, comme annoncé précédemment, et peuvent commencer à renvoyer des erreurs à tout moment.

• Les propriétés de ressource channel suivantes sont obsolètes. Ces propriétés ne sont déjà plus compatibles dans l'interface utilisateur de YouTube Studio ni sur YouTube. Par conséquent, elles ne sont plus non plus prises en charge par l'API.

  • brandingSettings.channel.defaultTab
  • brandingSettings.channel.featuredChannelsTitle
  • brandingSettings.channel.featuredChannelsUrls[]
  • brandingSettings.channel.profileColor
  • brandingSettings.channel.showBrowseView
  • brandingSettings.channel.showRelatedChannels

  Toutes les propriétés ont été supprimées de la représentation de la ressource channel, et leurs définitions ont été supprimées de la liste des propriétés de la ressource. De plus, les erreurs associées à ces propriétés ont été supprimées de la documentation spécifique à la méthode.

• Les propriétés de ressource channelSection suivantes sont obsolètes. Ces propriétés ne sont déjà plus compatibles dans l'interface utilisateur de YouTube Studio ni sur YouTube. Par conséquent, elles ne sont plus non plus prises en charge par l'API.

  • snippet.style
  • snippet.defaultLanguage
  • snippet.localized.title
  • localizations
  • localizations.(key)
  • localizations.(key).title
  • targeting
  • targeting.languages[]
  • targeting.regions[]
  • targeting.countries[]

  En parallèle, le paramètre hl de la méthode channelSection.list a également été abandonné, car les fonctionnalités qu'il prend en charge ne sont plus disponibles.

  Toutes les propriétés ont été supprimées de la représentation de la ressource channelSection, et leurs définitions ont été supprimées de la liste des propriétés de la ressource. De plus, les erreurs associées à ces propriétés ont été supprimées de la documentation spécifique à la méthode.

• Pour la propriété snippet.type de la ressource channelSection, les valeurs suivantes sont obsolètes. Ces valeurs ne sont déjà plus acceptées sur les pages de chaîne YouTube. Par conséquent, elles ne le sont plus non plus via l'API.

  • likedPlaylists
  • likes
  • postedPlaylists
  • postedVideos
  • recentActivity
  • recentPosts

• La propriété snippet.tags[] de la ressource playlist est obsolète. Cette propriété n'est déjà plus prise en charge sur YouTube. Par conséquent, elle ne l'est plus non plus via l'API.

9 février 2021

La ressource playlistItem accepte deux nouvelles propriétés :

• La propriété snippet.videoOwnerChannelId identifie l'ID de la chaîne qui a mis en ligne la vidéo de la playlist.
• La propriété snippet.videoOwnerChannelTitle identifie le nom de la chaîne qui a mis en ligne la vidéo de la playlist.

28 janvier 2021

Cette mise à jour inclut les changements suivants :

• Les méthodes playlistItems.delete, playlistItems.insert, playlistItems.list, playlistItems.update, playlists.delete, playlists.list et playlists.update acceptent toutes une nouvelle erreur playlistOperationUnsupported. Cette erreur se produit lorsqu'une requête tente d'effectuer une opération qui n'est pas autorisée pour une playlist spécifique. Par exemple, un utilisateur ne peut pas supprimer une vidéo de sa playlist de vidéos importées ni supprimer la playlist elle-même.

  Dans tous les cas, cette erreur renvoie un code de réponse HTTP 400 (Requête incorrecte).

• Les erreurs watchHistoryNotAccessible et watchLaterNotAccessible de la méthode playlistItems.list ont été supprimées de la documentation. Bien que l'historique des vidéos regardées et la liste "À regarder plus tard" des utilisateurs ne soient pas accessibles via l'API, ces erreurs spécifiques ne sont pas renvoyées par l'API.

15 octobre 2020

Deux nouvelles sections ont été ajoutées aux Règles relatives aux développeurs :

• La nouvelle Section III.E.4.i fournit des informations supplémentaires sur les données collectées et envoyées via le lecteur YouTube intégré. Vous êtes responsable des données utilisateur que vous nous envoyez via un lecteur YouTube intégré avant que l'utilisateur n'ait interagi avec le lecteur pour indiquer son intention de lecture. Vous pouvez limiter les données partagées avec YouTube avant qu'un utilisateur n'interagisse avec le lecteur en définissant la lecture automatique sur "false".
• La nouvelle section III.E.4.j concerne la vérification de l'état "Conçu pour les enfants" des contenus avant de les intégrer à vos sites et applications. Il vous incombe de savoir quand les vidéos que vous intégrez à votre client API sont conçues pour les enfants et de traiter les données collectées à partir du lecteur intégré en conséquence. Par conséquent, vous devez vérifier l'état du contenu à l'aide du service YouTube Data API avant de l'intégrer à votre client API via un lecteur YouTube intégré.

Le nouveau guide Trouver l'état "Conçue pour les enfants" d'une vidéo explique comment rechercher l'état "Conçue pour les enfants" d'une vidéo à l'aide du service de l'API YouTube Data.

En parallèle de ces modifications, un rappel a été ajouté à la documentation sur les paramètres du lecteur intégré pour expliquer que si vous activez la lecture automatique, la lecture se fera sans aucune interaction de l'utilisateur avec le lecteur. La collecte et le partage des données de lecture se feront donc au chargement de la page.

8 octobre 2020

Cette mise à jour couvre trois petites modifications liées à la ressource channel :

• L'objet snippet.thumbnails, qui identifie les miniatures d'une chaîne, peut être vide pour les chaînes nouvellement créées et peut prendre jusqu'à un jour pour se remplir.
• La propriété statistics.videoCount reflète le nombre de vidéos publiques de la chaîne uniquement, même pour les propriétaires. Ce comportement est cohérent avec les nombres affichés sur le site Web YouTube.
• Les mots clés de chaîne, identifiés dans la propriété brandingSettings.channel.keywords, peuvent être tronqués s'ils dépassent la longueur maximale autorisée de 500 caractères ou s'ils contiennent des guillemets non échappés ("). Notez que la limite de 500 caractères ne s'applique pas à chaque mot clé, mais à la longueur totale de tous les mots clés. Ce comportement est identique à celui du site Web YouTube.

9 septembre 2020

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

Cette mise à jour couvre les modifications suivantes apportées à l'API. Toutes les modifications entreront en vigueur le 9 septembre 2020 ou après, date de cette annonce. Dans cette optique, les développeurs ne doivent plus s'appuyer sur les fonctionnalités d'API listées ci-dessous.

• Les ressources, méthodes, paramètres et propriétés de ressources d'API suivants sont immédiatement obsolètes et cesseront de fonctionner à la date de cette annonce ou après :
  • Propriétés de la ressource channel suivantes :
    • Propriété statistics.commentCount
    • L'objet brandingSettings.image et toutes ses propriétés enfants
    • La liste brandingSettings.hints et toutes ses propriétés enfants
  • Paramètre de filtre categoryId de la méthode channels.list
  • Ressource guideCategories et méthode guideCategories.list
• Les réponses de l'API pour la méthode channels.list ne contiennent plus la propriété prevPageToken si la requête API définit le paramètre managedByMe sur true. Cette modification n'affecte pas la propriété prevPageToken pour les autres requêtes channels.list, ni la propriété nextPageToken pour aucune requête.
• Les propriétés contentDetails.relatedPlaylists.watchLater et contentDetails.relatedPlaylists.watchHistory de la ressource channel ont été annoncées comme obsolètes le 11 août 2016. La compatibilité des méthodes playlistItems.insert et playlistItems.delete avec ces playlists est également entièrement obsolète. Les deux propriétés ont été supprimées de la documentation.
• Le paramètre mySubscribers de la méthode channels.list, dont l'abandon avait été annoncé le 30 juillet 2013, a été supprimé de la documentation. Utilisez la méthode subscriptions.list et son paramètre mySubscribers pour récupérer la liste des abonnés à la chaîne de l'utilisateur authentifié.
• L'objet invideoPromotion de la ressource channel et toutes ses propriétés enfants, qui ont été annoncées comme obsolètes le 27 novembre 2017, ont été supprimés de la documentation.

29 juillet 2020

Nous avons simplifié le processus de facturation du quota pour les requêtes API en supprimant les coûts supplémentaires associés au paramètre part. À compter de maintenant, nous ne facturerons que le coût de base de la méthode appelée. Pour en savoir plus sur le quota simplifié, cliquez ici.

L'effet de ce changement est que la plupart des appels d'API auront un coût de quota légèrement inférieur, tandis que certains appels d'API conserveront le même coût. Cette modification n'augmente pas le coût des appels d'API. De manière générale, l'impact probable est que votre quota alloué, visible dans la console Google Cloud, sera un peu plus important.

Nous recommandons vivement à tous les développeurs de réaliser un audit de conformité pour leurs projets afin de garantir un accès continu aux services d'API YouTube.

Cette entrée de l'historique des révisions a été publiée le 20 juillet 2020.

28 juillet 2020

Toutes les vidéos mises en ligne via le point de terminaison videos.insert à partir de projets d'API non validés créés après le 28 juillet 2020 seront limitées au mode de visionnage privé. Pour lever cette restriction, chaque projet doit faire l'objet d'un audit afin de vérifier sa conformité avec les Conditions d'utilisation.

Les créateurs qui utilisent un client API non validé pour mettre en ligne des vidéos recevront un e-mail les informant que leur vidéo est verrouillée en mode privé et qu'ils peuvent éviter cette restriction en utilisant un client officiel ou audité.

Les projets d'API créés avant le 28 juillet 2020 ne sont pas concernés par ce changement pour le moment. Toutefois, nous recommandons vivement à tous les développeurs de procéder à un audit de conformité pour leurs projets afin de continuer à accéder aux services d'API YouTube.

21 juillet 2020

[Mise à jour du 28 juillet 2020] La mise à jour de la documentation mentionnée dans cette entrée de l'historique des révisions a été republiée le 28 juillet 2020.

Hier, nous avons publié une mise à jour de la documentation concernant notre processus de facturation des quotas. Toutefois, en raison de circonstances imprévues, le changement de quota n'est pas encore effectif. Par conséquent, la documentation a été rétablie pour plus d'exactitude. Pour éviter toute confusion, l'entrée de l'historique des révisions expliquant la modification a été supprimée et sera republiée prochainement.

7 juillet 2020

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

Les paramètres autoLevels et stabilize de la méthode videos.insert sont désormais obsolètes. Ils ont été supprimés de la documentation. Leurs valeurs sont ignorées et n'ont aucune incidence sur la façon dont les vidéos récemment mises en ligne sont traitées.

15 juin 2020

Le nouveau guide Respecter le règlement pour les développeurs YouTube fournit des conseils et des exemples pour vous aider à vous assurer que vos clients API respectent certaines sections des Conditions d'utilisation et du Règlement des services d'API YouTube.

Ces conseils vous aident à comprendre comment YouTube applique certains aspects des conditions d'utilisation de l'API, mais ne remplacent aucun document existant. Ce guide aborde certaines des questions les plus courantes que posent les développeurs lors des audits de conformité des API. Nous espérons que cela simplifiera le processus de développement de vos fonctionnalités en vous aidant à comprendre comment nous interprétons et appliquons nos règles.

4 juin 2020

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

La fonctionnalité de bulletin de chaîne a été entièrement abandonnée. Ce changement a été initialement annoncé le 17 avril 2020 et est désormais en vigueur. Par conséquent, la méthode activities.insert n'est plus compatible et la méthode activities.list ne renvoie plus de bulletins de chaîne. Pour en savoir plus, consultez le Centre d'aide YouTube.

17 avril 2020

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

YouTube abandonne la fonctionnalité de bulletin de chaîne. Par conséquent, la méthode activities.insert sera obsolète et la méthode activities.list cessera de renvoyer les annonces de la chaîne. Ces modifications entreront en vigueur dans l'API le 18 mai 2020 ou après. Pour en savoir plus, consultez le Centre d'aide YouTube.

31 mars 2020

Cette mise à jour inclut les changements suivants :

• Nouvelles ressources et méthodes

  • La nouvelle ressource member représente un membre d'une chaîne YouTube. Un membre apporte un soutien financier récurrent à un créateur et bénéficie d'avantages spéciaux. Par exemple, les membres peuvent discuter lorsque le créateur active le mode réservé aux membres pour un chat.

    Cette ressource remplace la ressource sponsor, qui est documentée dans l'API YouTube Live Streaming. La ressource sponsor est désormais obsolète. Les clients API doivent mettre à jour les appels à la méthode sponsors.list pour utiliser la méthode members.list à la place.

  • La nouvelle ressource membershipsLevel identifie un niveau de prix géré par le créateur qui a autorisé la requête API. La méthode membershipsLevels.list récupère la liste de tous les niveaux de souscription du créateur.

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

Les ressources channel et video sont compatibles avec deux nouvelles propriétés qui permettent aux créateurs et aux spectateurs d'identifier les contenus conçus pour les enfants :

• La propriété selfDeclaredMadeForKids permet aux créateurs de contenu d'indiquer si une chaîne ou une vidéo est conçue pour les enfants.
  
  Pour les canaux, cette propriété peut être définie lors de l'appel de la méthode channels.update. Pour les vidéos, cette propriété peut être définie lors de l'appel des méthodes videos.insert ou videos.update.
  
  Notez que cette propriété n'est incluse dans les réponses de l'API contenant des ressources channel ou video que si le propriétaire de la chaîne a autorisé la requête API.
• La propriété madeForKids permet à tout utilisateur de récupérer l'état "conçu pour les enfants" d'une chaîne ou d'une vidéo. Par exemple, l'état peut être déterminé en fonction de la valeur de la propriété selfDeclaredMadeForKids. Pour en savoir plus sur la définition de l'audience de votre chaîne, de vos vidéos ou de vos diffusions, consultez le Centre d'aide YouTube.

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

10 septembre 2019

La documentation de référence de l'API a été mise à jour pour refléter une modification de la façon dont le nombre d'abonnés est indiqué sur YouTube et, par conséquent, dans les réponses de l'API. Suite à ce changement, les nombres d'abonnés renvoyés par le service d'API YouTube Data sont arrondis à trois chiffres significatifs pour les nombres d'abonnés supérieurs à 1 000. Cette modification affecte la propriété statistics.subscriberCount de la ressource channel.

Remarque : Ce changement affecte la valeur de cette propriété, même dans les cas où un utilisateur envoie une demande autorisée de données sur sa propre chaîne. Les propriétaires de chaînes peuvent toujours consulter le nombre exact d'abonnés dans YouTube Studio.

Par exemple, si une chaîne compte 123 456 abonnés, la propriété statistics.subscriberCount contiendra la valeur 123000. Le tableau ci-dessous montre des exemples d'arrondi du nombre d'abonnés dans les réponses de l'API et d'abréviations dans les autres interfaces utilisateur YouTube visibles publiquement :

Exemple de nombre d'abonnés	API YouTube Data	Interfaces utilisateur YouTube visibles publiquement
1 234	1230	1,23 K
12 345	12300	12,3 k
123 456	123000	123 K
1 234 567	1230000	1,23 M
12 345 678	12300000	12,3 M
123,456,789	123000000	123 M

4 avril 2019

Cette mise à jour inclut les changements suivants :

• La documentation de référence de l'API a été mise à jour pour mieux expliquer les cas d'utilisation courants de chaque méthode et pour fournir des exemples de code dynamiques et de haute qualité grâce au widget APIs Explorer. Pour voir un exemple, consultez la documentation de la méthode channels.list. Deux nouveaux éléments sont désormais disponibles sur les pages décrivant les méthodes d'API :

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

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

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

  Les exemples de code sont actuellement disponibles pour Java, JavaScript, PHP, Python et curl.

• L'outil Exemples de code a également été mis à jour avec une nouvelle UI qui offre toutes les fonctionnalités décrites ci-dessus. Cet outil vous permet d'explorer les cas d'utilisation de différentes méthodes, de charger des valeurs dans l'explorateur d'API et d'ouvrir l'explorateur d'API en plein écran pour obtenir des exemples de code en Java, JavaScript, PHP et Python.

  En parallèle, les pages qui listaient les exemples de code disponibles pour Java, JavaScript, PHP et Python ont été supprimées.

• Les guides de démarrage rapide pour Java, JavaScript, PHP et Python ont été mis à jour. Les guides révisés expliquent comment exécuter un exemple avec une clé API et un autre exemple avec un ID client OAuth 2.0 à l'aide d'exemples de code d'APIs Explorer.

Notez que les modifications décrites ci-dessus remplacent un outil interactif qui avait été ajouté à la documentation de l'API en 2017.

9 juillet 2018

Cette mise à jour inclut les changements suivants :

• La définition de la propriété snippet.thumbnails de la ressource channel a été mise à jour pour indiquer que, lors de l'affichage de miniatures dans votre application, votre code doit utiliser les URL des images exactement telles qu'elles sont renvoyées dans les réponses de l'API. Par exemple, votre application ne doit pas utiliser le domaine http au lieu du domaine https dans une URL renvoyée dans une réponse d'API.

  À partir de juillet 2018, les URL des miniatures de chaînes ne seront disponibles que dans le domaine https, qui est celui dans lequel elles apparaissent dans les réponses de l'API. Après cette période, il est possible que des images cassées s'affichent dans votre application si elle tente de charger des images YouTube à partir du domaine http.

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

  La propriété recordingDetails.location.altitude de la ressource video est obsolète. Rien ne garantit que les vidéos renverront des valeurs pour cette propriété. De même, même si les requêtes API tentent de définir une valeur pour cette propriété, il est possible que les données entrantes ne soient pas stockées.

22 juin 2018

Le guide d'implémentation, anciennement appelé guide d'implémentation et de migration, a été mis à jour pour supprimer les instructions de migration de l'API v2 vers l'API v3. De plus, les instructions ont également été supprimées pour les fonctionnalités qui ont été abandonnées dans l'API v3, comme les vidéos favorites.

27 novembre 2017

Cette mise à jour inclut les changements suivants :

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

  YouTube ne prend plus en charge les fonctionnalités Vidéo sélectionnée et Site Web sélectionné, qui sont compatibles avec l'API via l'objet invideoPromotion de la ressource channel. Par conséquent, cet objet, y compris toutes ses propriétés enfants, est obsolète.

  Vous pourrez toujours récupérer et définir les données invideoPromotion jusqu'au 14 décembre 2017. Après cette date :

  • Les tentatives de récupération de la partie invideoPromotion lors de l'appel de channels.list renverront un invideoPromotion vide ou ne renverront aucune donnée invideoPromotion.
  • Les tentatives de mise à jour des données invideoPromotion lors de l'appel de channels.update renverront une réponse positive au moins jusqu'au 27 mai 2018, mais elles seront traitées comme des no-ops, ce qui signifie qu'elles n'effectueront pas réellement de mise à jour.

  Après le 27 mai 2018, il est possible que ces requêtes renvoient des messages d'erreur indiquant, par exemple, que invalidPromotion est une partie non valide.

16 novembre 2017

Cette mise à jour inclut les changements suivants :

• L'outil d'extrait de code interactif est désormais compatible avec les exemples de code Node.js. Les exemples sont également visibles dans la documentation de presque toutes les méthodes d'API, comme la méthode channels.list.

  Les exemples personnalisables sont conçus pour vous fournir un point de départ spécifique à un cas d'utilisation pour une application Node.js. Cette fonctionnalité est semblable au code du guide de démarrage rapide Node.js. Toutefois, les exemples contiennent des fonctions utilitaires qui n'apparaissent pas dans le guide de démarrage rapide :

  • La fonction removeEmptyParameters prend une liste de paires clé/valeur correspondant aux paramètres de requête API et supprime les paramètres qui n'ont pas de valeur.
  • La fonction createResource accepte une liste de paires clé-valeur correspondant aux propriétés d'une ressource d'API. Il convertit ensuite les propriétés en objet JSON pouvant être utilisé dans les opérations insert et update. L'exemple ci-dessous montre un ensemble de noms et de valeurs de propriétés, ainsi que l'objet JSON que le code créerait pour eux :

    # Key-value pairs:
    {'id': 'ABC123',
     'snippet.title': 'Resource title',
     'snippet.description': 'Resource description',
     'status.privacyStatus': 'private'}
    
    # JSON object:
    {
     'id': 'ABC123',
     'snippet': {
       'title': 'Resource title',
       'description': 'Resource description',
     },
     'status': {
       'privacyStatus': 'private'
     }
    }

  Tous ces exemples sont conçus pour être téléchargés et exécutés en local. Pour en savoir plus, consultez les prérequis pour exécuter des exemples de code complets en local dans les instructions de l'outil d'extraits de code.

25 octobre 2017

Cette mise à jour inclut les changements suivants :

• Les exemples de code Python de l'outil d'extraits de code interactifs ont été mis à jour pour utiliser les bibliothèques google-auth et google-auth-oauthlib au lieu de la bibliothèque oauth2client, qui est désormais obsolète.

  En plus de ce changement, l'outil fournit désormais des exemples de code complets pour les applications Python installées et les applications de serveur Web Python, qui utilisent des flux d'autorisation légèrement différents. Pour voir tous les exemples (et cette modification) :

  1. Accédez à l'outil d'extrait de code interactif ou à la documentation de n'importe quelle méthode d'API, comme la méthode channels.list.
  2. Cliquez sur l'onglet Python au-dessus des exemples de code.
  3. Cliquez sur le bouton d'activation au-dessus des onglets pour passer d'un extrait à un exemple complet.
     
  4. L'onglet doit maintenant afficher un exemple de code complet qui utilise le flux d'autorisation InstalledAppFlow. La description au-dessus de l'exemple explique cela et fournit également un lien vers un exemple d'application de serveur Web.
  5. Cliquez sur le lien pour passer à l'exemple de serveur Web. Cet exemple utilise le framework d'application Web Flask et un flux d'autorisation différent.

  Tous ces exemples sont conçus pour être téléchargés et exécutés en local. Si vous souhaitez exécuter les exemples, consultez les instructions pour exécuter des exemples de code complets en local dans les instructions de l'outil d'extraits de code.

29 août 2017

Cette mise à jour inclut les changements suivants :

• La définition du paramètre forContentOwner de la méthode search.list a été mise à jour pour indiquer que si ce paramètre est défini sur true, le paramètre type doit être défini sur video.
• La définition du paramètre regionCode de la méthode search.list a été mise à jour pour préciser que le paramètre limite les résultats de recherche aux vidéos qui peuvent être visionnées dans la région spécifiée.
• YouTube a modifié ses logos et icônes. Vous pouvez télécharger les nouveaux logos "developed with YouTube" sur la page des consignes relatives à la marque. D'autres nouveaux logos et icônes YouTube sont également présentés sur cette page et peuvent être téléchargés sur le site de la marque YouTube.

24 juillet 2017

Cette mise à jour inclut les changements suivants :

• Un nouveau guide de démarrage rapide de l'API YouTube Data est disponible pour iOS. Ce guide explique comment utiliser l'API YouTube Data dans une application iOS simple écrite en Objective-C ou en Swift.
• L'outil d'extrait de code interactif pour l'API YouTube Data inclut désormais une documentation expliquant certaines de ses fonctionnalités :
  • Exécuter des requêtes d'API
  • Basculer entre les extraits de code et les exemples de code complets
  • Utiliser des fonctions de code récurrent
  • Chargement des ressources existantes (pour les méthodes de mise à jour)

  Remarque : L'outil est également intégré à la documentation de référence sur les méthodes d'API (exemple).

1er juin 2017

Cette mise à jour inclut les changements suivants :

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

  Les propriétés de ressource video suivantes sont obsolètes. Bien que les propriétés soient acceptées jusqu'au 1er décembre 2017, il n'est pas garanti que les vidéos continueront de renvoyer des valeurs pour ces propriétés jusqu'à cette date. De même, les requêtes videos.insert et videos.update qui définissent ces valeurs de propriété ne généreront pas d'erreurs avant cette date, mais il est possible que les données entrantes ne soient pas stockées.

  • recordingDetails.locationDescription
  • recordingDetails.location.latitude
  • recordingDetails.location.longitude

17 mai 2017

Cette mise à jour inclut les changements suivants :

• La documentation de référence de l'API a été mise à jour pour rendre les extraits de code plus omniprésents et interactifs. Les pages qui expliquent les méthodes d'API, comme channels.list ou videos.rate, disposent désormais d'un outil interactif qui vous permet d'afficher et de personnaliser des extraits de code en Java, JavaScript, PHP, Python, Ruby, Apps Script et Go.

  Pour chaque méthode, l'outil affiche des extraits de code pour un ou plusieurs cas d'utilisation. Chaque cas d'utilisation décrit une manière courante d'appeler cette méthode. Par exemple, vous pouvez appeler la méthode channels.list pour récupérer des données sur une chaîne spécifique ou sur la chaîne de l'utilisateur actuel.

  Vous pouvez également interagir avec les exemples de code :

  • Modifiez les valeurs des paramètres et des propriétés. Les extraits de code sont mis à jour de manière dynamique pour refléter les valeurs que vous fournissez.

  • Basculez entre les extraits de code et les exemples complets. Un extrait de code montre la partie du code qui appelle la méthode de l'API. Un exemple complet contient cet extrait ainsi que le code passe-partout pour autoriser et envoyer des requêtes. Les exemples complets peuvent être copiés et exécutés à partir de la ligne de commande ou d'un serveur Web local.

  • Exécutez les requêtes en cliquant sur un bouton. (Pour exécuter des requêtes, vous devez autoriser l'outil à appeler l'API en votre nom.)

  Notez que cet outil a remplacé APIs Explorer sur les pages où il est disponible. (Chaque page affiche un lien qui vous permet également de charger la requête sur laquelle vous travaillez dans APIs Explorer.)

• L'outil Extraits de code de l'API Data a également été mis à jour avec une nouvelle interface utilisateur qui offre toutes les fonctionnalités décrites ci-dessus. Voici les principales nouveautés disponibles sur cette page :

  • Compatibilité avec les requêtes API qui écrivent des données.
  • Compatibilité avec les exemples Java.
  • Un code boilerplate plus flexible et complet pour autoriser les utilisateurs et créer des requêtes API.

27 avril 2017

Cette mise à jour inclut les changements suivants :

• De nouveaux guides de démarrage rapide expliquent comment configurer une application simple qui envoie des requêtes à l'API YouTube Data. Des guides sont actuellement disponibles pour Android, Apps Script, Go, Java, JavaScript, Node.js, PHP, Python et Ruby.

30 mars 2017

Cette mise à jour inclut les changements suivants :

• La nouvelle propriété topicDetails.topicCategories[] de la ressource channel contient une liste d'URL Wikipédia décrivant le contenu de la chaîne. Les URL correspondent aux ID de thèmes renvoyés dans la propriété topicDetails.topicIds[] de la ressource.
• La nouvelle propriété contentDetails.videoPublishedAt de la ressource playlistItem identifie l'heure à laquelle la vidéo a été publiée sur YouTube. La ressource contient déjà la propriété snippet.publishedAt, qui identifie l'heure à laquelle l'élément a été ajouté à la playlist.
• Comme la ressource channel, la ressource video renvoie désormais la propriété topicDetails.topicCategories[], qui contient une liste d'URL Wikipédia décrivant le contenu de la vidéo. Pour les ressources video, les URL correspondent aux ID de thèmes renvoyés dans la propriété topicDetails.relevantTopicIds[] de la ressource.
• La nouvelle propriété contentDetails.contentRating.mpaatRating de la ressource video identifie la classification attribuée par la Motion Picture Association of America à une bande-annonce ou à un aperçu de film.

27 février 2017

Comme annoncé le 11 août 2016, YouTube a remplacé la liste des ID de thèmes acceptés par une liste sélectionnée. La liste complète des ID de thèmes compatibles est incluse dans les propriétés topicDetails des ressources channel et video, ainsi que dans le paramètre topicId de la méthode search.list.

Notez que plusieurs modifications ont été apportées à la liste sélectionnée :

• Les sujets suivants ont été ajoutés en tant que sous-sujets de Society :

  Nom	ID du sujet
  Entreprise	/m/09s1f
  Santé	/m/0kt51
  Armée	/m/01h6rj
  Politique	/m/05qt0
  Religion	/m/06bvp

• La rubrique Animated cartoon, qui était auparavant une sous-rubrique de Entertainment, a été supprimée.
• La rubrique Children's music, qui était auparavant une sous-rubrique de Music, a été supprimée.

Suite à ce changement, les thèmes associés à une vidéo sont désormais toujours renvoyés dans la valeur de la propriété topicDetails.relevantTopicIds[] de la ressource video.

29 novembre 2016

Cette mise à jour inclut les changements suivants :

• Trois petites modifications ont été apportées à la liste des ID de thèmes qui seront acceptés à partir du 10 février 2017 :

  • La catégorie Professional wrestling, qui était auparavant un enfant de la catégorie Sports, est désormais un enfant de Entertainment.
  • La catégorie TV shows, qui est un enfant de Entertainment, est nouvelle.
  • La catégorie Health, qui était auparavant une catégorie enfant de Lifestyle, a été supprimée.

  Notez également qu'il existe quelques catégories parentes (Entertainment, Gaming, Lifestyle, Music et Sports). Toute vidéo associée à une catégorie enfant, comme Tennis, sera également associée à la catégorie parente (Sports).

10 novembre 2016

Cette mise à jour inclut les changements suivants :

• Comme annoncé le 11 août 2016, l'arrêt de Freebase et de l'API Freebase nécessite plusieurs modifications concernant les ID de thèmes. Les ID de thèmes identifient les thèmes associés aux ressources channel et video. Vous pouvez également utiliser le paramètre de recherche topicId pour trouver des chaînes ou des vidéos liées à un thème spécifique.

  Le 10 février 2017, YouTube commencera à renvoyer un petit ensemble d'ID de thèmes au lieu de l'ensemble beaucoup plus précis d'ID renvoyés jusqu'à présent. Notez également que l'association des chaînes et des vidéos à des thèmes n'est pas garantie, ce qui est conforme au comportement actuel de l'API.

  Pour vous permettre de préparer vos clients API à ces modifications, les définitions des paramètres et propriétés d'API suivants ont été mises à jour pour lister les ID de thèmes qui seront acceptés après cette date. Notez que la liste des catégories est identique pour toutes les propriétés.

  • Propriété topicDetails.topicIds[] de la ressource channel.
  • Propriété topicDetails.relevantTopicIds[] de la ressource video.
  • Paramètre topicId de la méthode search.list.

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

  Les propriétés suivantes sont obsolètes :

  • Propriété topicDetails.topicIds[] de la ressource channel. Cette propriété sera acceptée jusqu'au 10 novembre 2017.
  • Propriété topicDetails.relevantTopicIds[] de la ressource video. Cette propriété sera acceptée jusqu'au 10 novembre 2017.
  • Propriété topicDetails.topicIds[] de la ressource video. Cette propriété ne contiendra plus de valeurs après le 10 février 2017. (Après cette date, la valeur de la propriété topicDetails.relevantTopicIds[] identifiera tous les thèmes associés à une vidéo.)

• Étant donné que Freebase a déjà été abandonné, le guide Rechercher avec les thèmes Freebase a été supprimé de la documentation. Ce guide fournissait des exemples de code pour montrer comment une application fonctionnerait avec l'API Freebase.

  De plus, plusieurs exemples de code liés aux ID de thèmes ont été supprimés de la documentation de la méthode search.list.

2 novembre 2016

Cette mise à jour inclut les changements suivants :

• Nouveaux paramètres et propriétés

  • La ressource video contient plusieurs nouvelles propriétés :

    • La propriété player.embedHtml contient une balise <iframe> que vous pouvez utiliser pour intégrer un lecteur qui lit la vidéo. Les nouvelles propriétés player.embedHeight et player.embedWidth identifient les dimensions du lecteur intégré. Ces propriétés ne sont renvoyées que si la requête API spécifie une valeur pour au moins l'un des paramètres maxHeight ou maxWidth. Ces deux nouveaux paramètres sont expliqués plus loin dans cette entrée de l'historique des révisions.

    • La nouvelle propriété hasCustomThumbnail indique si l'utilisateur ayant mis en ligne la vidéo a fourni une miniature personnalisée pour celle-ci. Notez que cette propriété n'est visible que par l'utilisateur ayant mis en ligne la vidéo.

    • Le nouvel élément fpbRatingReasons[] identifie les raisons pour lesquelles la vidéo a reçu sa classification FPB (Afrique du Sud).

    • Le nouveau mcstRating identifie la note que la vidéo a reçue au Vietnam.

  • La méthode videos.list est compatible avec deux nouveaux paramètres, maxHeight et maxWidth. Vous pouvez utiliser l'un ou l'autre des paramètres, ou les deux, lorsque vous récupérez la partie player dans les ressources video.

    Par défaut, la hauteur de l'<iframe> renvoyé dans la propriété player.embedHtml est de 360 px. La largeur s'ajuste pour correspondre aux proportions de la vidéo, ce qui permet de s'assurer que le lecteur intégré ne présente pas de barres noires autour de la vidéo. Par exemple, si le format d'une vidéo est 16:9, la largeur du lecteur sera de 640 px.

    Grâce à ces nouveaux paramètres, vous pouvez spécifier que le code d'intégration doit utiliser une hauteur et/ou une largeur adaptées à la mise en page de votre application au lieu des dimensions par défaut. Le serveur de l'API ajuste les dimensions du lecteur de manière appropriée pour s'assurer que le lecteur intégré ne présente pas de barres noires autour de la vidéo. Notez que les deux paramètres spécifient les dimensions maximales du lecteur intégré. Ainsi, si les deux paramètres sont spécifiés, il est possible qu'une dimension soit toujours inférieure à la quantité maximale autorisée pour cette dimension.

    Par exemple, supposons qu'une vidéo soit au format 16:9. Ainsi, la balise player.embedHtml contiendrait un lecteur 640x360 si les paramètres maxHeight ou maxWidth ne sont pas définis.

    • Si le paramètre maxHeight est défini sur 720 et que le paramètre maxWidth n'est pas défini, l'API renvoie un lecteur 1280x720.
    • Si le paramètre maxWidth est défini sur 960 et que le paramètre maxHeight n'est pas défini, l'API renvoie un lecteur 960x540.
    • Si le paramètre maxWidth est défini sur 960 et le paramètre maxHeight sur 450, l'API renvoie un lecteur de 800 x 450.

    Les nouvelles propriétés player.embedHeight et player.embedWidth, décrites ci-dessus, identifient les dimensions du lecteur.

• Modifications apportées aux méthodes, propriétés et paramètres existants

  • La description de la ressource channelSection a été mise à jour pour indiquer qu'une chaîne peut créer au maximum 10 rayons sans définir de données de ciblage et au maximum 100 rayons avec des données de ciblage.

    De plus, la propriété targeting de la ressource channelSection a été mise à jour pour refléter le fait que les options de ciblage ne peuvent être définies qu'à l'aide de l'API. Les options de ciblage sont supprimées si la section de la chaîne est modifiée à l'aide de l'interface utilisateur sur le site Web YouTube.

  • La définition de la propriété snippet.name de la ressource i18nLanguage a été corrigée pour indiquer que la valeur représente le nom d'une langue tel qu'il est écrit dans la langue spécifiée par le paramètre hl de la méthode i18nLanguage.list.

  • La propriété contentDetails.note de la ressource playlistItem a été mise à jour pour indiquer que la longueur maximale de la valeur de la propriété est de 280 caractères.

  • Les propriétés contentDetails.startAt et contentDetails.endAt de la ressource playlistItem sont obsolètes. Ces champs sont ignorés s'ils sont définis dans les requêtes playlistItems.insert ou playlistItems.update.

  • Les méthodes playlistItems.delete et playlistItems.update sont désormais compatibles avec le paramètre onBehalfOfContentOwner, qui l'est déjà pour plusieurs autres méthodes. Les requêtes qui utilisent cette méthode doivent également être autorisées avec un jeton qui donne accès au champ d'application https://www.googleapis.com/auth/youtubepartner.

  • Les paramètres publishedBefore et publishedAfter de la méthode search.list ont tous deux été mis à jour pour indiquer que les valeurs des paramètres sont incluses. Par exemple, si le paramètre publishedBefore est défini, l'API renvoie les ressources créées avant ou à l'heure spécifiée.

  • La propriété contentDetails.contentRating.grfilmRating de la ressource video accepte trois valeurs supplémentaires : grfilmK12, grfilmK15 et grfilmK18.

  • La description de la méthode videos.insert a été mise à jour pour indiquer que la taille maximale des fichiers vidéo importés est passée de 64 Go à 128 Go.

• Erreurs nouvelles et mises à jour

  • L'API est compatible avec les nouvelles erreurs suivantes :

    Type d'erreur	Détails de l'erreur	Description
    forbidden (403)	homeParameterDeprecated	La méthode activities.list renvoie cette erreur pour indiquer que les données d'activité de la page d'accueil de l'utilisateur ne sont pas disponibles via cette API. Cette erreur peut se produire si vous définissez le paramètre home sur true dans une requête non autorisée.
    invalidValue (400)	invalidContentDetails	La méthode playlistItems.insert renvoie cette erreur pour indiquer que l'objet contentDetails de la requête n'est pas valide. Cette erreur se produit, entre autres, lorsque le champ contentDetails.note comporte plus de 280 caractères.
    forbidden (403)	watchHistoryNotAccessible	La méthode playlistItems.list renvoie cette erreur pour indiquer que la requête a tenté de récupérer les éléments de la playlist "Historique des vidéos regardées", mais que ceux-ci ne peuvent pas être récupérés à l'aide de l'API.
    forbidden (403)	watchLaterNotAccessible	La méthode playlistItems.list renvoie cette erreur pour indiquer que la requête a tenté de récupérer des éléments de la playlist "À regarder plus tard", mais que ceux-ci ne peuvent pas être récupérés à l'aide de l'API.
    badRequest (400)	uploadLimitExceeded	La méthode videos.insert renvoie cette erreur pour indiquer que la chaîne a dépassé le nombre de vidéos qu'elle peut mettre en ligne.
    forbidden (403)	forbiddenEmbedSetting	La méthode videos.update renvoie cette erreur pour indiquer que la requête API tente de définir un paramètre d'intégration non valide pour la vidéo. Notez que certaines chaînes ne sont pas autorisées à proposer des lecteurs intégrés pour les diffusions en direct. Pour en savoir plus, consultez le Centre d'aide YouTube.

  • La méthode playlistItems.insert ne renvoie plus d'erreur si vous insérez une vidéo en double dans une playlist. Cette erreur se produisait auparavant pour certaines playlists, comme les vidéos favorites, qui n'autorisaient pas les doublons, mais qui ne sont plus prises en charge. En général, les playlists autorisent les vidéos en double.

• Autres nouveautés

  • L'entrée de l'historique des révisions du 15 septembre 2016 a été mise à jour pour préciser que, chaque fois que les propriétés contentDetails.relatedPlaylists.watchHistory et contentDetails.relatedPlaylists.watchLater de la ressource channel sont incluses dans une réponse, elles contiennent toujours les valeurs HL et WL, respectivement. De plus, ces propriétés ne sont incluses que si un utilisateur autorisé récupère des données sur sa propre chaîne.

15 septembre 2016

Cette mise à jour inclut les changements suivants :

• La mise à jour de l'historique des révisions du 11 août 2016 a présenté plusieurs modifications concernant les ID de thèmes, y compris le fait que l'ensemble des ID de thèmes acceptés changera à compter du 10 février 2017. La liste des thèmes acceptés sera publiée d'ici le 10 novembre 2016.

• Les modifications suivantes sont désormais en vigueur. Ces modifications ont été annoncées dans l'historique des révisions le 11 août 2016 :

  • Si la méthode activities.list est appelée avec le paramètre home défini sur true, la réponse de l'API contient désormais des éléments semblables à ceux qu'un utilisateur YouTube déconnecté verrait sur la page d'accueil.

    Il s'agit d'un léger changement qui vise à améliorer l'expérience utilisateur par rapport au comportement décrit dans la mise à jour de l'historique des révisions du 11 août 2016. Cette mise à jour indiquait que les requêtes utilisant le paramètre home renverraient une liste vide.

  • Les propriétés contentDetails.relatedPlaylists.watchHistory et contentDetails.relatedPlaylists.watchLater de la ressource channel contiennent désormais les valeurs HL et WL, respectivement, pour toutes les chaînes.

    Pour être clair, ces propriétés ne sont visibles que par un utilisateur autorisé qui récupère des données sur son propre canal. Les propriétés contiennent toujours les valeurs HL et WL, même pour un utilisateur autorisé qui récupère des données sur sa propre chaîne. Par conséquent, les ID de l'historique des vidéos regardées et de la playlist "À regarder plus tard" ne peuvent pas être récupérés via l'API.

    De plus, les requêtes visant à récupérer les détails (playlists.list) ou les éléments (playlistItems.list) de la playlist "Historique des vidéos regardées" ou "À regarder plus tard" d'une chaîne renvoient désormais des listes vides. Ce comportement s'applique aux nouvelles valeurs, HL et WL, ainsi qu'à tous les ID d'historique des vidéos regardées ou de playlist "À regarder plus tard" que votre client API a peut-être déjà stockés.

• L'objet fileDetails.recordingLocation de la ressource video et ses propriétés enfants ne sont plus renvoyés. Auparavant, ces données (comme l'objet fileDetails parent) ne pouvaient être récupérées que par le propriétaire d'une vidéo.

11 août 2016

Cette mise à jour inclut les changements suivants :

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

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

• L'arrêt de Freebase et de l'API Freebase entraîne plusieurs modifications liées aux ID de thèmes. Les ID de thèmes sont utilisés dans les ressources et méthodes d'API suivantes :

  • La partie topicDetails de la ressource channel identifie les thèmes associés à la chaîne.
  • La partie topicDetails de la ressource video identifie les thèmes associés à la vidéo.
  • Le paramètre topicId de la méthode search.list vous permet de rechercher des vidéos ou des chaînes liées à un thème spécifique.

  Voici les modifications apportées à ces fonctionnalités :

  • À partir du 10 février 2017, YouTube commencera à renvoyer un petit ensemble d'ID de thèmes au lieu de l'ensemble beaucoup plus précis d'ID renvoyés jusqu'à présent. Cet ensemble de thèmes acceptés identifie des catégories générales telles que Sports ou Basket-ball, mais pas des équipes ou des joueurs spécifiques, par exemple. Nous annoncerons l'ensemble des thèmes acceptés afin que vous ayez le temps de préparer votre application à ce changement.

  • Vous pouvez utiliser les ID de thèmes Freebase que vous avez déjà récupérés pour rechercher du contenu jusqu'au 10 février 2017. Toutefois, après cette période, vous ne pourrez utiliser que le plus petit ensemble de thèmes identifiés dans l'élément précédent pour récupérer les résultats de recherche par thème.

  • Après le 10 février 2017, si vous essayez de rechercher des résultats à l'aide d'un ID de thème qui ne figure pas dans le plus petit ensemble d'ID de thèmes compatibles, l'API renverra un ensemble de résultats vide.

• Plusieurs champs et paramètres d'API seront obsolètes à compter du 12 septembre 2016 :

  • Le paramètre home de la méthode activities.list permettait à un utilisateur autorisé de récupérer le flux d'activité qui s'affichait sur la page d'accueil YouTube pour cet utilisateur. Les requêtes qui utilisent ce paramètre après le 12 septembre 2016 renverront une liste vide.

  • Les propriétés contentDetails.relatedPlaylists.watchHistory et contentDetails.relatedPlaylists.watchLater de la ressource channel ne sont visibles que par un utilisateur autorisé qui récupère des données sur son propre canal. Après le 12 septembre 2016, contentDetails.relatedPlaylists.watchHistory renverra la valeur HL et la propriété contentDetails.relatedPlaylists.watchLater renverra la valeur WL pour tous les canaux.

    Les requêtes permettant de récupérer les détails d'une playlist (playlists.list) pour l'historique des vidéos regardées ou la playlist "À regarder plus tard" d'une chaîne renverront une liste vide après le 12 septembre 2016. Les demandes de récupération des éléments de playlist (playlistItems.list) dans l'une ou l'autre de ces playlists renverront également une liste vide après cette heure. Cela vaut pour les nouvelles valeurs, HL et WL, ainsi que pour tous les ID d'historique des vidéos regardées ou de playlist "À regarder plus tard" que votre client API a peut-être déjà stockés.

  • L'objet fileDetails.recordingLocation de la ressource video ou l'une de ses propriétés enfants ne seront plus renvoyés après le 12 septembre 2016. Seul le propriétaire d'une vidéo peut récupérer ces données, car seul le propriétaire d'une vidéo peut récupérer l'objet fileDetails parent.

13 juin 2016

Cette mise à jour inclut les changements suivants :

• La propriété contentDetails.googlePlusUserId de la ressource channel est obsolète. Auparavant, la propriété n'était présente que si la chaîne était associée à un profil Google+. Une fois la propriété obsolète, elle ne sera plus incluse dans aucune ressource channel.

• La propriété snippet.authorGoogleplusProfileUrl de la ressource comment est obsolète. Auparavant, la propriété n'était présente que si la chaîne était associée à un profil Google+. Une fois la propriété obsolète, elle ne sera plus incluse dans aucune ressource comment.

Étant donné qu'aucune de ces propriétés ne sera renvoyée après l'abandon, elles ont toutes les deux été supprimées de la documentation sur les ressources correspondantes.

31 mai 2016

Cette mise à jour inclut les changements suivants :

• Le nouveau paramètre myRecentSubscribers de la méthode subscriptions.list récupère la liste des abonnés à la chaîne de l'utilisateur authentifié, par ordre chronologique inverse de la date à laquelle ils se sont abonnés à la chaîne.

  Notez que le nouveau paramètre ne permet de récupérer que les 1 000 derniers abonnés à la chaîne de l'utilisateur authentifié. Pour récupérer la liste complète des abonnés, utilisez le paramètre mySubscribers. Ce paramètre, qui ne renvoie pas les abonnés dans un ordre particulier, ne limite pas le nombre d'abonnés pouvant être récupérés.

• La définition de la propriété snippet.thumbnails.(key) a été mise à jour pour les ressources activity, playlistItem, playlist, search result, thumbnail et video afin de préciser que des tailles de miniatures supplémentaires sont disponibles pour certaines vidéos.

  • L'image standard mesure 640 pixels de large et 480 pixels de haut.
  • L'image maxres mesure 1 280 pixels de large et 720 pixels de haut.

• La définition du paramètre part de la méthode channelSection.list a été mise à jour pour indiquer que la partie targeting peut être récupérée au prix de 2 unités de quota.

• La méthode videos.list renvoie désormais une erreur forbidden (403) lorsqu'une requête mal autorisée tente de récupérer les parties fileDetails, processingDetails ou suggestions d'une ressource video. Ces parties ne sont disponibles que pour le propriétaire de la vidéo.

17 mai 2016

Le nouvel outil Extraits de code de l'API Data fournit de courts extraits de code pour les cas d'utilisation courants de l'API YouTube Data. Des extraits de code sont actuellement disponibles pour toutes les méthodes d'API en lecture seule dans Apps Script, Go, JavaScript, PHP, Python et Ruby.

Pour chaque méthode, l'outil affiche des exemples de code pour un ou plusieurs cas d'utilisation. Par exemple, il fournit cinq extraits de code pour la méthode search.list :

• Lister les vidéos par mot clé
• Lister les vidéos par lieu
• Lister les événements en direct
• Rechercher les vidéos de l'utilisateur authentifié
• Lister les vidéos similaires

Pour chaque cas d'utilisation, l'outil affiche les paramètres utilisés dans la requête API. Vous pouvez modifier les valeurs des paramètres. Dans ce cas, l'outil met à jour les extraits de code pour refléter les valeurs des paramètres que vous avez fournies.

Enfin, l'outil affiche la réponse de l'API à chaque requête. Si vous avez modifié les paramètres de la requête, la réponse de l'API est basée sur les valeurs des paramètres que vous avez fournies. Notez que vous devez autoriser l'outil à envoyer des requêtes en votre nom pour que les réponses de l'API s'affichent.

28 avril 2016

Cette mise à jour inclut les changements suivants :

• La nouvelle propriété contentDetails.projection de la ressource video spécifie le format de projection de la vidéo. Les valeurs de propriété valides sont 360 et rectangular.

• Les propriétés recordingDetails.location et fileDetails.recordingLocation de la ressource video ont été mises à jour pour expliquer la différence entre les deux propriétés :

  • La propriété recordingDetails.location identifie le lieu que le propriétaire de la vidéo souhaite associer à la vidéo. Ce lieu est modifiable, inclus dans l'index de recherche des vidéos publiques et peut être affiché aux utilisateurs pour les vidéos publiques.
  • La valeur de la propriété fileDetails.recordingLocation est immuable et représente l'emplacement associé au fichier vidéo d'origine importé. Seul le propriétaire de la vidéo peut voir cette valeur.

• La définition de la propriété contentDetails.relatedPlaylists.favorites de la ressource channel a été mise à jour pour indiquer que la valeur de la propriété peut contenir un ID de playlist qui fait référence à une playlist vide et qui ne peut pas être récupérée. En effet, la fonctionnalité permettant d'ajouter des vidéos aux favoris a déjà été abandonnée. Notez que cette propriété n'est pas soumise au règlement relatif à l'abandon d'API.

• La définition de l'erreur ineligibleAccount, qui peut être renvoyée par les méthodes comments.insert, comments.update, commentThreads.insert ou commentThreads.update, a été mise à jour pour indiquer que l'erreur se produit lorsque le compte YouTube utilisé pour autoriser la requête API n'a pas été fusionné avec le compte Google de l'utilisateur.

20 avril 2016

Cette mise à jour inclut les changements suivants :

• La définition du paramètre part de la méthode channels.update a été mise à jour pour indiquer que localizations est également une valeur valide pour ce paramètre.

• La section Utilisation du quota du guide de démarrage a été mise à jour pour inclure un lien vers la console Google Developers, où vous pouvez consulter votre quota réel et son utilisation.

16 mars 2016

Cette mise à jour inclut les changements suivants :

• Mises à jour des ressources et méthodes existantes

  • La documentation sur la ressource channelBanner a été mise à jour pour indiquer que la taille recommandée pour l'image de bannière de chaîne importée est de 2 560 x 1 440 px. La taille minimale (2 048 x 1 152 pixels) n'a pas changé.

  • La nouvelle propriété snippet.customUrl de la ressource channel identifie l'URL personnalisée associée à la chaîne. (Toutes les chaînes ne disposent pas d'URL personnalisées.) Le Centre d'aide YouTube explique les critères d'éligibilité pour obtenir une URL personnalisée et comment la configurer.

  • L'objet brandingSettings.watch de la ressource channel et toutes ses propriétés enfants ont été abandonnés.

  • La réponse de l'API à une requête search.list contient désormais une propriété regionCode. La propriété identifie le code de région utilisé pour la requête de recherche. Le code régional indique à l'API de renvoyer les résultats de recherche pour le pays spécifié.

    La valeur de la propriété est un code pays ISO à deux lettres qui identifie la région. La méthode i18nRegions.list renvoie la liste des régions acceptées. La valeur par défaut est US. Si une région non acceptée est spécifiée, YouTube peut quand même en sélectionner une autre, plutôt que la valeur par défaut, pour traiter la requête.

  • Les définitions des propriétés snippet.label et snippet.secondaryReasons[].label de la ressource videoAbuseReportReason ont été mises à jour pour indiquer que les propriétés contiennent du texte de libellé localisé pour les motifs de signalement d'abus.

    De plus, la méthode videoAbuseReportReasons.list est désormais compatible avec le paramètre hl, qui spécifie la langue à utiliser pour le texte des libellés dans la réponse de l'API. La valeur par défaut du paramètre est en_US.

  • La nouvelle propriété contentDetails.contentRating.ecbmctRating de la ressource video identifie la classification d'une vidéo attribuée par le Conseil d'évaluation et de classification du ministère turc de la Culture et du Tourisme.

    De plus, les propriétés d'API pour les autres systèmes de classification acceptent les nouvelles valeurs de propriété suivantes :

    • contentDetails.contentRating.fpbRating (Afrique du Sud)
      Note : 10 ; valeur de la propriété : fpb10
    • contentDetails.contentRating.moctwRating (Taïwan)
      Classification : R-12 ; valeur de la propriété : moctwR12
    • contentDetails.contentRating.moctwRating (Taïwan)
      Classification : R-15 ; valeur de la propriété : moctwR15

  • La propriété liveStreamingDetails.activeLiveChatId de la ressource video contient l'ID de la discussion en direct active associée à la vidéo. La valeur de la propriété n'est présente que si la vidéo est une diffusion en direct en cours pour laquelle le chat en direct est activé. Une fois la diffusion et le chat en direct terminés, la propriété n'est plus renvoyée pour la vidéo.

  • La propriété status.rejectionReason de la ressource video accepte la nouvelle valeur de propriété legal.

• L'API est compatible avec les nouvelles erreurs suivantes :

  Type d'erreur	Détails de l'erreur	Description
  badRequest (400)	notEditable	Les méthodes channelSections.insert, channelSections.update et channelSections.delete renvoient cette erreur pour indiquer que la section de chaîne spécifiée ne peut pas être créée, mise à jour ni supprimée.
  badRequest (400)	styleRequired	Les méthodes channelSections.insert et channelSections.update renvoient cette erreur pour indiquer que la ressource channelSection envoyée dans la requête d'API doit spécifier une valeur pour la propriété snippet.style.
  badRequest (400)	typeRequired	Les méthodes channelSections.insert et channelSections.update renvoient cette erreur pour indiquer que la ressource channelSection envoyée dans la requête d'API doit spécifier une valeur pour la propriété snippet.type.
  badRequest (400)	processingFailure	La méthode commentThreads.list renvoie cette erreur pour indiquer que le serveur d'API n'a pas pu traiter la requête. Bien qu'il puisse s'agir d'une erreur temporaire, elle indique généralement que l'entrée de la requête n'est pas valide. Vérifiez la structure de la ressource commentThread dans le corps de la requête pour vous assurer qu'elle est valide.
  forbidden (403)	commentsDisabled	La méthode commentThreads.list renvoie cette erreur pour indiquer que les commentaires ont été désactivés pour la vidéo identifiée par le paramètre videoId.
  badRequest (400)	commentTextTooLong	La méthode commentThreads.insert renvoie cette erreur pour indiquer que la ressource comment insérée contient trop de caractères dans la propriété snippet.topLevelComment.snippet.textOriginal.
  invalidValue (400)	videoAlreadyInAnotherSeriesPlaylist	La méthode playlistItems.insert renvoie cette erreur pour indiquer que la vidéo que vous essayez d'ajouter à la playlist figure déjà dans une autre playlist de séries. Pour en savoir plus sur les playlists de séries, consultez le Centre d'aide YouTube.
  badRequest (400)	subscriptionForbidden	La méthode subscriptions.insert renvoie cette erreur pour indiquer que vous avez atteint le nombre maximal d'abonnements ou que vous avez créé trop d'abonnements récents. Dans ce dernier cas, vous pouvez relancer la requête après quelques heures.
  badRequest (400)	invalidCategoryId	La méthode videos.update renvoie cette erreur pour indiquer que la propriété snippet.categoryId de la ressource video importée a spécifié un ID de catégorie non valide. Utilisez la méthode videoCategories.list pour récupérer les catégories acceptées.
  badRequest (400)	invalidDescription	La méthode videos.update renvoie cette erreur pour indiquer que la propriété snippet.description de la ressource video importée a spécifié une valeur non valide.
  badRequest (400)	invalidPublishAt	La méthode videos.update renvoie cette erreur pour indiquer que la propriété status.publishAt de la ressource video importée a spécifié une heure de publication programmée non valide.
  badRequest (400)	invalidRecordingDetails	La méthode videos.update renvoie cette erreur pour indiquer que l'objet recordingDetails de la ressource video importée spécifie des informations d'enregistrement non valides.
  badRequest (400)	invalidTags	La méthode videos.update renvoie cette erreur pour indiquer que la propriété snippet.tags de la ressource video importée a spécifié une valeur non valide.
  badRequest (400)	invalidTitle	La méthode videos.update renvoie cette erreur pour indiquer que la propriété snippet.title de la ressource video importée a spécifié un titre de vidéo non valide ou vide.
  badRequest (400)	invalidVideoMetadata	La méthode videos.update renvoie cette erreur pour indiquer que les métadonnées de la requête ne sont pas valides. Cette erreur se produit si la requête met à jour la partie snippet d'une ressource video, mais ne définit pas de valeur pour les propriétés snippet.title et snippet.categoryId.

18 décembre 2015

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

19 novembre 2015

L'API permet désormais de définir et de récupérer du texte localisé pour les propriétés snippet.title et snippet.description des ressources playlist et video, la propriété snippet.title de la ressource channelSection et la propriété snippet.description de la ressource channel.

• Définir des titres et des descriptions localisés

  Vous pouvez définir des valeurs localisées pour une ressource lorsque vous appelez la méthode insert ou update pour cette ressource. Pour définir des valeurs localisées pour une ressource, procédez comme suit :

  • Assurez-vous qu'une valeur est définie pour la propriété snippet.defaultLanguage de la ressource. Cette propriété identifie la langue des propriétés snippet.title et snippet.description de la ressource. Sa valeur peut correspondre à n'importe quelle langue d'application acceptée ou à la plupart des autres codes de langue ISO 639-1:2002. Par exemple, si vous mettez en ligne une vidéo dont le titre et la description sont en anglais, vous devez définir la propriété snippet.defaultLanguage sur en.

    Remarque concernant la mise à jour des ressources channel : Pour définir la propriété snippet.defaultLanguage d'une ressource channel, vous devez en fait mettre à jour la propriété brandingSettings.channel.defaultLanguage.

  • Ajoutez l'objet localizations à la ressource que vous mettez à jour. Chaque clé d'objet est une chaîne qui identifie une langue d'application ou un code de langue ISO 639-1:2002. Chaque clé est associée à un objet contenant le titre (et la description) localisés de la ressource.

    L'extrait d'exemple ci-dessous définit la langue par défaut de la ressource sur l'anglais. Il ajoute également des titres et des descriptions localisés en allemand et en espagnol à une vidéo :

    {
      "kind": "youtube#video",
      ...
      "snippet": {
        "title": "Playing soccer",
        "description": "We play soccer in the park on Sundays.",
        "defaultLanguage": "en",
        ...
      },
      "localizations":
        "de": {
          "title": "Fußball spielen",
          "description": "Wir spielen Fußball im Park am Sonntag"
        },
        "es": {
          "title": "Jugar al fútbol",
          "description": "Nosotros jugamos fútbol en el parque los domingos",
        }
      }
    }

  Important : N'oubliez pas que lorsque vous mettez à jour les données localisées d'une ressource, votre requête API doit inclure toutes les versions localisées existantes des données. Par exemple, si vous envoyez une demande ultérieure pour ajouter des données en portugais à la vidéo de l'exemple ci-dessus, vous devrez inclure les données localisées pour l'allemand, l'espagnol et le portugais.

• Récupérer les valeurs localisées

  L'API permet de récupérer les valeurs localisées d'une ressource de deux manières :

  • Ajoutez le paramètre hl à votre requête channels.list, channelSections.list, playlists.list ou videos.list pour récupérer les données localisées pour une langue d'application spécifique compatible avec le site Web YouTube. Si des informations localisées sur la ressource sont disponibles dans cette langue, l'objet snippet.localized de la ressource contiendra les valeurs localisées. Toutefois, si les informations localisées ne sont pas disponibles, l'objet snippet.localized contiendra les informations sur la ressource dans la langue par défaut de la ressource.

    Par exemple, supposons qu'une requête videos.list ait récupéré des données pour la vidéo décrite ci-dessus avec des données localisées en allemand et en espagnol. Si le paramètre hl était défini sur de, la ressource contiendrait les données suivantes :

    {
      "kind": "youtube#video",
      ...
      "snippet": {
        "title": "Playing soccer",
        "description": "We play soccer in the park on Sundays.",
        "defaultLanguage": "en",
        "localized": {
          "title": "Fußball spielen",
          "description": "Wir spielen Fußball im Park am Sonntag"
        }
        ...
      }
    }

    Toutefois, si le paramètre hl était défini sur fr, l'objet snippet.localized contiendrait le titre et la description en anglais, car l'anglais est la langue par défaut de la ressource et les informations localisées en français ne sont pas disponibles.

    Important : Le paramètre hl n'accepte que les valeurs qui identifient les langues d'application compatibles avec le site Web YouTube. Pour déterminer si du texte localisé est disponible dans d'autres langues, vous devez récupérer la partie localizations de la ressource et filtrer pour déterminer si le texte localisé existe.
    
    Par exemple, vous devrez récupérer la liste complète des localisations pour déterminer si du texte localisé est disponible en anglais des Appalaches.
    
    

  • Lorsque vous récupérez une ressource, incluez localizations dans la valeur du paramètre part pour récupérer tous les détails localisés de cette ressource. Si vous récupérez des données localisées pour une langue qui n'est pas une langue d'application YouTube actuelle, vous devez utiliser cette approche pour récupérer toutes les localisations, puis filtrer les résultats pour déterminer si les données localisées souhaitées existent.

• Erreurs liées aux valeurs textuelles localisées

  L'API accepte également les nouvelles erreurs suivantes pour les valeurs de texte localisées :

  Type d'erreur	Détails de l'erreur	Description
  badRequest (400)	defaultLanguageNotSetError	Cette erreur indique qu'une requête qui tente d'insérer ou de mettre à jour l'objet localizations pour une ressource échoue, car la propriété snippet.defaultLanguage n'est pas définie pour cette ressource. Les méthodes channels.update, channelSections.insert, channelSections.update, playlists.insert, playlists.update, videos.insert et videos.update acceptent cette erreur.
  badRequest (400)	localizationValidationError	Cette erreur indique que l'une des valeurs de l'objet localizations d'une ressource n'a pas pu être validée. Par exemple, cette erreur peut se produire si l'objet contient un code de langue non valide. Les méthodes channels.update, channelSections.insert, channelSections.update, playlists.insert et playlists.update acceptent cette erreur.

4 novembre 2015

Cette mise à jour inclut les changements suivants :

• Mises à jour des ressources et méthodes existantes

  • Le paramètre order de la méthode search.list a été mis à jour pour indiquer que si vous triez les diffusions en direct par viewCount, les résultats de l'API sont triés par nombre de spectateurs simultanés pendant que les diffusions sont en cours.

  • Le paramètre relatedToVideoId de la méthode search.list a été mis à jour pour indiquer que, si le paramètre est défini, les seuls autres paramètres acceptés sont part, maxResults, pageToken, regionCode, relevanceLanguage, safeSearch, type (qui doit être défini sur video) et fields. Cette mise à jour ne reflète pas un changement de comportement de l'API.

  • La définition de la propriété snippet.publishedAt de la ressource video a été mise à jour pour indiquer que la valeur de la propriété, qui spécifie la date et l'heure de publication de la vidéo, peut être différente de l'heure de mise en ligne de la vidéo. Par exemple, si une vidéo est mise en ligne en tant que vidéo privée, puis rendue publique ultérieurement, la valeur de la propriété indique l'heure à laquelle la vidéo a été rendue publique. La définition mise à jour explique également comment la valeur est renseignée pour les vidéos privées et non répertoriées.

    Ce changement ne reflète pas une modification du comportement de l'API.

  • La définition de la propriété status.publishAt de la ressource video a été mise à jour pour indiquer :

    • Si vous définissez la valeur de cette propriété lorsque vous appelez la méthode videos.update, vous devez également définir la valeur de la propriété status.privacyStatus sur private, même si la vidéo est déjà privée.
    • Si la requête programme la publication d'une vidéo à une heure passée, elle est publiée immédiatement. Par conséquent, définir la propriété status.publishAt sur une date et une heure passées a le même effet que de modifier la propriété privacyStatus de la vidéo de private à public.

  • La propriété contentDetails.contentRating.cncRating de la ressource video spécifie la classification de la vidéo attribuée par la Commission de classification cinématographique française. Cette propriété remplace la propriété contentDetails.contentRating.fmocRating, qui est désormais obsolète.

  • La définition de brandingSettings.channel.keywords pour la ressource channel a été mise à jour pour refléter correctement le fait que la valeur de la propriété contient une liste de chaînes séparées par des espaces et non une liste séparée par des virgules, comme indiqué précédemment. Cette mise à jour ne reflète pas un changement de comportement de l'API.

  • La documentation de la méthode thumbnails.set a été mise à jour pour indiquer avec précision que le corps de la requête contient l'image miniature que vous mettez en ligne et associez à une vidéo. Le corps de la requête ne contient pas de ressource thumbnail. Auparavant, la documentation indiquait que vous ne deviez pas fournir de corps de requête lorsque vous appeliez cette méthode. Cette mise à jour ne reflète pas un changement de comportement de l'API.

  • La description de la ressource activity a été mise à jour pour refléter le fait que la méthode activities.list n'inclut actuellement pas les ressources liées aux nouveaux commentaires sur les vidéos. Les snippet.type et contentDetails.comment de la ressource ont également été mis à jour.

• Erreurs nouvelles et mises à jour

  • L'API est désormais compatible avec les erreurs suivantes :

    Informations sur les erreurs
    activities.insert	Code de réponse HTTP badRequest (400) Motif invalidMetadata Description La propriété kind ne correspond pas au type d'ID fourni.
    commentThreads.update comments.insert comments.update	Code de réponse HTTP badRequest (400) Motif commentTextTooLong Description La ressource comment insérée ou mise à jour contient trop de caractères dans la propriété snippet.topLevelComment.snippet.textOriginal.
    playlistItems.insert playlistItems.update	Code de réponse HTTP forbidden (403) Motif playlistItemsNotAccessible Description La requête n'est pas correctement autorisée à insérer, mettre à jour ou supprimer l'élément de playlist spécifié.
    playlists.delete playlists.insert playlists.update	Code de réponse HTTP badRequest (400) Motif playlistForbidden Description Cette opération est interdite ou la requête n'est pas correctement autorisée.
    search.list	Code de réponse HTTP badRequest (400) Motif invalidLocation Description La valeur du paramètre location et/ou locationRadius n'est pas au bon format.
    search.list	Code de réponse HTTP badRequest (400) Motif invalidRelevanceLanguage Description La valeur du paramètre relevanceLanguage n'est pas au bon format.
    subscriptions.insert	Code de réponse HTTP badRequest (400) Motif subscriptionForbidden Description Cette erreur se produit lorsque l'une des conditions suivantes est remplie : L'abonnement que vous essayez de créer existe déjà Vous avez déjà atteint le nombre maximal d'abonnements Vous essayez de vous abonner à votre propre chaîne, ce qui n'est pas possible. Vous avez créé trop d'abonnements récemment. Vous devez attendre quelques heures avant de réessayer.
    videos.update	Code de réponse HTTP badRequest (400) Motif invalidDefaultBroadcastPrivacySetting Description La requête tente de définir un paramètre de confidentialité non valide pour la diffusion par défaut.

28 août 2015

Cette mise à jour inclut les changements suivants :

• Mises à jour des ressources et méthodes existantes

  • La propriété statistics.favoriteCount de la ressource video est obsolète.

    Conformément à notre règlement relatif aux abandons, cette propriété continuera d'être incluse dans les ressources video pendant au moins un an après cette annonce. Toutefois, la valeur de la propriété est désormais toujours définie sur 0.

7 août 2015

Cette mise à jour inclut les changements suivants :

• Mises à jour des ressources et méthodes existantes

  • La définition de la propriété snippet.tags[] de la ressource video a été mise à jour pour fournir plus d'informations sur la façon dont le serveur d'API calcule la longueur de la valeur de la propriété. Notez que cette mise à jour ne reflète pas un changement dans le comportement de l'API.

    Plus précisément, la définition explique désormais que si un tag contient un espace, le serveur d'API gère la valeur du tag comme si elle était entre guillemets, et que les guillemets sont pris en compte dans la limite de caractères. Ainsi, pour les limites de caractères, le tag Foo-Baz contient sept caractères, mais le tag Foo Baz en contient neuf.

  • La méthode commentThreads.insert n'est plus compatible avec le paramètre shareOnGooglePlus, qui indiquait auparavant si un commentaire et les réponses à ce commentaire devaient également être publiés sur le profil Google+ de l'auteur. Si une requête envoie le paramètre, le serveur d'API l'ignore, mais traite la requête.

18 juin 2015

Cette mise à jour inclut les changements suivants :

• Mises à jour des ressources et méthodes existantes

  • Le nouveau paramètre order de la méthode commentThreads.list spécifie l'ordre dans lequel la réponse de l'API doit lister les fils de commentaires. Les fils de discussion peuvent être classés par date ou par pertinence. Le comportement par défaut consiste à les trier par heure.

  • La nouvelle propriété snippet.defaultAudioLanguage de la ressource video spécifie la langue parlée dans la piste audio par défaut de la vidéo.

  • La définition de la propriété contentDetails.licensedContent de la ressource video a été mise à jour pour préciser que le contenu doit avoir été mis en ligne à l'origine sur une chaîne associée à un partenaire de contenu YouTube, puis revendiqué par ce partenaire. Cela ne représente pas un changement dans le comportement réel de l'API.

  • Les méthodes captions.delete, captions.download, captions.insert, captions.list et captions.update sont désormais compatibles avec le paramètre onBehalfOfContentOwner, qui l'est déjà pour plusieurs autres méthodes. Les requêtes qui utilisent cette méthode doivent également être autorisées avec un jeton qui donne accès au champ d'application https://www.googleapis.com/auth/youtubepartner.

• Erreurs nouvelles et mises à jour

  • L'API est désormais compatible avec les erreurs suivantes :

    Informations sur les erreurs
    videos.rate	Code de réponse HTTP badRequest (400) Motif emailNotVerified Description L'utilisateur doit valider son adresse e-mail avant de pouvoir évaluer la vidéo.
    videos.rate	Code de réponse HTTP badRequest (400) Motif videoPurchaseRequired Description Seuls les utilisateurs qui ont loué des vidéos peuvent les évaluer.

  • Les méthodes subscriptions.delete et subscriptions.insert ne sont plus compatibles avec les erreurs accountClosed et accountSuspended.

27 avril 2015

Cette mise à jour inclut les changements suivants :

• Nouvelles ressources et méthodes

  • La nouvelle ressource videoAbuseReportReason contient des informations sur les raisons pour lesquelles une vidéo peut être signalée pour contenu abusif. La méthode videoAbuseReportReasons.list vous permet de récupérer la liste de tous les motifs pour lesquels des vidéos peuvent être signalées.

  • La nouvelle méthode videos.reportAbuse permet de signaler une vidéo contenant du contenu abusif. Le corps de la requête contient un objet JSON qui spécifie la vidéo signalée ainsi que la raison pour laquelle elle est considérée comme contenant du contenu abusif. Les raisons valides peuvent être obtenues à partir de la méthode videoAbuseReportReason.list décrite ci-dessus.

    Le guide de migration a également été mis à jour avec un exemple de signalement d'une vidéo abusive. Grâce à cette modification, l'API v3 est désormais compatible avec toutes les fonctionnalités de l'API v2 qu'elle est censée prendre en charge. Ces fonctionnalités sont également toutes expliquées dans le guide de migration.

• Mises à jour des ressources et méthodes existantes

  • Le nouveau paramètre de filtre forDeveloper de la méthode search.list limite une recherche afin de n'extraire que les vidéos mises en ligne via l'application ou le site Web du développeur. Le paramètre forDeveloper peut être utilisé conjointement avec des paramètres de recherche facultatifs tels que le paramètre q.

    Pour cette fonctionnalité, chaque vidéo importée est automatiquement taguée avec le numéro de projet associé à l'application du développeur dans la Google Developers Console.

    Lorsqu'une requête de recherche définit ensuite le paramètre forDeveloper sur true, le serveur d'API utilise les identifiants d'autorisation de la requête pour identifier le développeur. Par conséquent, un développeur peut limiter les résultats aux vidéos mises en ligne via sa propre application ou son propre site Web, mais pas à celles mises en ligne via d'autres applications ou sites.

    Cette nouvelle fonctionnalité est similaire, mais pas identique, à celle des tags de développeur que l'API v2 prenait en charge.

  • La nouvelle propriété snippet.country de la ressource channel permet aux propriétaires de chaînes d'associer leurs chaînes à un pays spécifique.

    Remarque : Pour définir la propriété snippet.country d'une ressource channel, vous devez en fait mettre à jour la propriété brandingSettings.channel.country.

  • L'API est désormais compatible avec le ciblage des ressources channelSection. Le ciblage des sections de chaîne permet de limiter la visibilité d'une section de contenu aux utilisateurs qui répondent à des critères spécifiques.

    L'API expose trois options de ciblage. Un utilisateur doit remplir tous les paramètres de ciblage pour qu'une section de chaîne soit visible.

    • targeting.languages[] : liste des langues de l'application YouTube. Les utilisateurs qui ont choisi l'une de ces langues peuvent voir la section de chaîne correspondante.

    • targeting.regions[] : liste des régions de contenu privilégié YouTube. La section des chaînes est visible par les utilisateurs qui ont sélectionné l'une de ces régions, ainsi que par ceux pour lesquels l'une de ces régions est automatiquement sélectionnée.

    • targeting.countries[] : liste des pays où la section de chaîne est visible. Chaque valeur de la liste est un code pays ISO 3166-1 alpha-2.

  • La définition de la propriété contentDetails.duration de la ressource video a été corrigée pour indiquer que la valeur peut refléter des heures, des jours, etc.

  • La documentation des méthodes channelSections.delete, playlistItems.delete, playlists.delete, subscriptions.delete et videos.delete a été corrigée pour indiquer que, en cas de réussite, ces méthodes renvoient toutes un code de réponse HTTP 204 (No Content).

• Erreurs nouvelles et mises à jour

  • L'API est désormais compatible avec les erreurs suivantes :

    Type d'erreur	Détails de l'erreur	Description
    badRequest (400)	targetInvalidCountry	Les méthodes channelSections.insert et channelSections.update renvoient cette erreur si la ressource channelSection insérée contenait une valeur non valide pour la propriété targeting.countries[].
    badRequest (400)	targetInvalidLanguage	Les méthodes channelSections.insert et channelSections.update renvoient cette erreur si la ressource channelSection insérée contenait une valeur non valide pour la propriété targeting.languages[].
    badRequest (400)	targetInvalidRegion	Les méthodes channelSections.insert et channelSections.update renvoient cette erreur si la ressource channelSection insérée contenait une valeur non valide pour la propriété targeting.regions[].
    badRequest (400)	operationNotSupported	La méthode comments.insert renvoie cette erreur si l'utilisateur de l'API n'est pas en mesure d'insérer un commentaire en réponse au commentaire de premier niveau identifié par la propriété snippet.parentId. Dans une ressource commentThread, la propriété snippet.canReply indique si le spectateur actuel peut répondre au fil de discussion.
    badRequest (400)	invalidChannelId	La méthode search.list renvoie cette erreur si le paramètre channelId de la requête a spécifié un ID de chaîne non valide.
    badRequest (400)	subscriptionForbidden	La méthode subscriptions.insert renvoie cette erreur si l'utilisateur de l'API tente de s'abonner à sa propre chaîne.

  • La méthode captions.update n'est plus compatible avec les erreurs invalidMetadata et videoNotFound.

16 avril 2015

Cette mise à jour inclut les changements suivants :

• Le guide de migration a été mis à jour pour expliquer comment migrer les applications qui utilisent encore la fonctionnalité de commentaires de l'API v2.

  Le guide mentionne également plusieurs fonctionnalités de commentaires qui n'étaient pas disponibles dans l'API v2, mais qui le sont dans l'API v3. Exemples :

  • Récupérer les commentaires sur une chaîne
  • Récupérer tous les fils de discussion associés à une chaîne, ce qui signifie que la réponse de l'API peut contenir des commentaires sur la chaîne ou sur l'une de ses vidéos.
  • Modifier le texte d'un commentaire
  • Marquer un commentaire comme spam
  • Définir l'état de modération d'un commentaire

• Le guide S'abonner aux notifications push a été mis à jour pour refléter le fait que les notifications ne sont envoyées qu'au hub Google PubSubHubBub et non également au hub Superfeedr, comme indiqué précédemment.

9 avril 2015

Cette mise à jour inclut les changements suivants :

• Les nouvelles ressources commentThread et comment de l'API vous permettent de récupérer, d'insérer, de modifier, de supprimer et de modérer des commentaires.

  • Une ressource commentThread contient des informations sur un fil de discussion YouTube, qui comprend un commentaire de premier niveau et les réponses à ce commentaire, le cas échéant. Une ressource commentThread peut représenter des commentaires sur une vidéo ou une chaîne.

    Le commentaire de premier niveau et les réponses sont en fait des ressources comment imbriquées dans la ressource commentThread. Il est important de noter que la ressource commentThread ne contient pas nécessairement toutes les réponses à un commentaire. Vous devez utiliser la méthode comments.list si vous souhaitez récupérer toutes les réponses à un commentaire spécifique. De plus, certains commentaires n'ont pas de réponse.

    L'API accepte les méthodes suivantes pour les ressources commentThread :

    • commentThreads.list : récupérez la liste des fils de commentaires. Utilisez cette méthode pour récupérer les commentaires associés à une vidéo ou une chaîne spécifiques.
    • commentThreads.insert : créez un commentaire de premier niveau. (Utilisez la méthode comments.insert pour répondre à un commentaire existant.)
    • commentThreads.update : modifiez un commentaire de premier niveau.

  • Une ressource comment contient des informations sur un seul commentaire YouTube. Une ressource comment peut représenter un commentaire sur une vidéo ou une chaîne. De plus, le commentaire peut être un commentaire de premier niveau ou une réponse à un commentaire de premier niveau.

    L'API accepte les méthodes suivantes pour les ressources comment :

    • comments.list : récupérez une liste de commentaires. Utilisez cette méthode pour récupérer toutes les réponses à un commentaire spécifique.
    • comments.insert : créez une réponse à un commentaire existant.
    • comments.update : modifier un commentaire.
    • comments.markAsSpam : signalez un ou plusieurs commentaires comme spam.
    • comments.setModerationStatus : définissez l'état de modération d'un ou de plusieurs commentaires. Par exemple, vous pouvez autoriser la publication d'un commentaire ou le refuser. La requête API doit être autorisée par le propriétaire de la chaîne ou de la vidéo associée aux commentaires.
    • comments.delete : supprimez un commentaire.

  Notez que le nouveau champ d'application https://www.googleapis.com/auth/youtube.force-ssl de l'API, décrit dans l'historique des révisions du 2 avril 2015, est requis pour les appels aux méthodes comments.insert, comments.update, comments.markAsSpam, comments.setModerationStatus, comments.delete, commentThreads.insert et commentThreads.update.

• Le nouveau guide S'abonner aux notifications push explique la nouvelle compatibilité de l'API avec les notifications push via PubSubHubBub, un protocole de publication/abonnement de serveur à serveur pour les ressources accessibles sur le Web. Votre serveur de rappel PubSubHubBub peut recevoir des notifications de flux Atom lorsqu'une chaîne effectue l'une des activités suivantes :

  • met en ligne une vidéo ;
  • met à jour le titre d'une vidéo.
  • met à jour la description d'une vidéo.

• Le guide de migration a également été mis à jour pour indiquer la nouvelle compatibilité avec les notifications push. Toutefois, comme l'API v2 était compatible avec de nombreux autres types de notifications push qui ne le sont pas dans l'API v3, la mention de la compatibilité avec PubSubHubBub figure toujours dans la section Obsolète de ce guide.

• La nouvelle portée https://www.googleapis.com/auth/youtube.force-ssl de l'API est désormais une portée valide pour toute méthode d'API qui acceptait auparavant la portée https://www.googleapis.com/auth/youtube.

• L'API est désormais compatible avec les erreurs suivantes :

  Type d'erreur	Détails de l'erreur	Description
  badRequest (400)	invalidRating	La méthode videos.rate renvoie cette erreur si la requête contenait une valeur inattendue pour le paramètre rating.

• La méthode subscriptions.insert n'accepte plus l'erreur subscriptionLimitExceeded, qui indiquait auparavant que l'abonné identifié dans la requête avait dépassé la limite de débit de l'abonnement.

2 avril 2015

Cette mise à jour inclut les changements suivants :

• La nouvelle ressource captions représente une piste de sous-titres YouTube. Une piste de sous-titres est associée à une seule vidéo YouTube.

  L'API est compatible avec les méthodes permettant de lister, d'insérer, de mettre à jour, de télécharger et de supprimer les pistes de sous-titres.

• Le guide de migration a également été mis à jour pour expliquer comment migrer les applications qui utilisent encore la fonctionnalité de sous-titres dans l'API v2.

• La nouvelle portée https://www.googleapis.com/auth/youtube.force-ssl de l'API exige que la communication avec le serveur d'API se fasse via une connexion SSL.

  Ce nouveau champ d'application accorde le même accès que le champ d'application https://www.googleapis.com/auth/youtube. En fait, ces deux niveaux d'accès sont fonctionnellement identiques, car le serveur de l'API YouTube n'est disponible que via un point de terminaison HTTPS. Par conséquent, même si le champ d'application https://www.googleapis.com/auth/youtube ne nécessite pas de connexion SSL, il n'existe en fait aucune autre façon d'envoyer une requête API.

  La nouvelle portée est requise pour les appels à toutes les méthodes de la ressource caption.

11 mars 2015

Cette mise à jour inclut les changements suivants :

• Le guide de migration de l'API YouTube Data (v3) contient un nouvel onglet, Nouveautés de l'API v3, qui liste les fonctionnalités compatibles avec l'API v3, mais pas avec l'API v2. Les mêmes fonctionnalités étaient et sont toujours listées dans d'autres onglets du guide. Par exemple, la nouvelle fonctionnalité expliquant comment mettre à jour les données des campagnes promotionnelles dans les vidéos d'une chaîne est également listée dans l'onglet Chaînes (profils).

• Le guide de migration de l'API YouTube Data (v3) a été mis à jour pour indiquer que l'API v3 sera compatible avec la fonctionnalité suivante de l'API v2 :

  • Signaler une vidéo

• Le guide de migration de l'API YouTube Data (v3) a été mis à jour pour indiquer que les fonctionnalités suivantes de l'API v2 ne seront pas compatibles avec l'API v3 :

  • Récupérer des recommandations de vidéos : l'API v3 ne récupère pas de liste contenant uniquement les vidéos recommandées pour l'utilisateur actuel de l'API. Toutefois, vous pouvez utiliser l'API v3 pour trouver des vidéos recommandées en appelant la méthode activities.list et en définissant la valeur du paramètre home sur true.

    Dans la réponse de l'API, une ressource correspond à une vidéo recommandée si la valeur de la propriété snippet.type est recommendation. Dans ce cas, les propriétés contentDetails.recommendation.reason et contentDetails.recommendation.seedResourceId contiendront des informations sur les raisons pour lesquelles la vidéo a été recommandée. Notez que nous ne pouvons pas vous garantir que la réponse contiendra un nombre spécifique de vidéos recommandées.

  • Récupérer des suggestions de chaînes

  • Récupérer les nouvelles vidéos des abonnements : l'API v3 ne récupère pas de liste contenant uniquement les vidéos récemment mises en ligne sur les chaînes auxquelles l'utilisateur de l'API est abonné. Toutefois, vous pouvez utiliser l'API v3 pour trouver de nouvelles vidéos d'abonnement en appelant la méthode activities.list et en définissant la valeur du paramètre home sur true.

    Dans la réponse de l'API, une ressource correspond à une nouvelle vidéo réservée aux abonnés si la valeur de la propriété snippet.type est upload. Notez que nous ne pouvons pas vous garantir que la réponse contiendra un nombre spécifique de nouvelles vidéos d'abonnement.

  • Compatibilité avec les flux RSS

  • Notifications push pour les mises à jour des flux : l'API v2 acceptait les notifications push, à l'aide du protocole SUP (Simple Update Protocol) ou de PubSubHubbub, pour surveiller les flux d'activité des utilisateurs YouTube. Des notifications étaient envoyées pour les nouveaux abonnements à des chaînes, ainsi que lorsque des vidéos étaient notées, partagées, ajoutées aux favoris, commentées ou mises en ligne.

    L'API v3 prendra en charge les notifications push à l'aide du protocole PubSubHubbub, mais les notifications ne concerneront que les mises en ligne de vidéos et les modifications apportées aux titres ou aux descriptions des vidéos.

  • Position de la chaîne : l'API v2 utilisait la balise <yt:location> pour identifier la position de l'utilisateur telle qu'elle était indiquée dans le profil public YouTube de la chaîne. Bien que certains développeurs aient utilisé ce champ pour associer une chaîne à un pays spécifique, les données du champ ne pouvaient pas être utilisées de manière cohérente à cette fin.

  • Définir ou récupérer des tags de développeur : l'API v2 permettait d'associer des mots clés ou des tags de développeur à une vidéo au moment de sa mise en ligne. Les tags de développeur ne s'affichaient pas pour les utilisateurs YouTube, mais les propriétaires de vidéos pouvaient récupérer les vidéos correspondant à un tag de développeur spécifique.

    L'API v3 proposera une fonctionnalité similaire, mais pas identique. Plus précisément, un développeur pourra rechercher les vidéos mises en ligne par sa propre application. Pour cette fonctionnalité, chaque vidéo importée est automatiquement taguée avec le numéro de projet associé à l'application du développeur dans la Google Developers Console. Le développeur utilise ensuite le même numéro de projet pour rechercher des vidéos.

  • Lister les vidéos par date de publication, nombre de vues ou note : dans l'API v2, le paramètre orderby vous permet de trier les vidéos d'une playlist par position, durée, date de publication, titre et plusieurs autres valeurs. Dans l'API v3, les éléments de playlist sont généralement triés par position dans l'ordre croissant. Les autres options de tri ne sont pas disponibles.

    Il existe quelques exceptions. Une nouvelle mise en ligne, une vidéo ajoutée aux favoris, une vidéo "J'aime" ou une vidéo regardée récemment est automatiquement ajoutée en tant que premier élément (snippet.position=0) pour les types de playlists suivants. Chacune de ces listes est donc triée du plus récent au plus ancien en fonction de la date d'ajout des éléments.

    • importations utilisateur
    • vidéos favorites
    • vidéos "J'aime"
    • historique des vidéos regardées

    Toutefois, un nouvel élément ajouté à la playlist "À regarder plus tard" est ajouté en dernier. Cette playlist est donc triée du plus ancien au plus récent.

  • Traitement par lot : l'API v3 est compatible avec l'un des cas d'utilisation du traitement par lot pris en charge par l'API v2. Les méthodes channels.list, channelSections.list, guideCategories.list, playlistItems.list, playlists.list, subscriptions.list, videoCategories.list et videos.list de l'API v3 acceptent toutes un paramètre id, qui peut être utilisé pour spécifier une liste d'ID séparés par une virgule (ID de vidéo, ID de chaîne, etc.). Grâce à ces méthodes, vous pouvez récupérer une liste de plusieurs ressources avec une seule requête.

  Grâce à ces modifications, le guide identifie désormais toutes les fonctionnalités compatibles avec l'ancienne API (v2) qui seront obsolètes dans la version actuelle de l'API (v3).

4 mars 2015

Cette mise à jour inclut les changements suivants :

• Les méthodes channelSections.delete et channelSections.update sont désormais compatibles avec le paramètre onBehalfOfContentOwner, qui l'est déjà pour plusieurs autres méthodes.

• Les propriétés suivantes et leurs propriétés enfants ont été abandonnées :

  • brandingSettings.image.backgroundImageUrl
  • brandingSettings.image.largeBrandedBannerImageImapScript
  • brandingSettings.image.largeBrandedBannerImageUrl
  • brandingSettings.image.smallBrandedBannerImageImapScript
  • brandingSettings.image.smallBrandedBannerImageUrl

  Remarque : Aucune de ces propriétés n'était soumise au règlement sur l'abandon des API.

• La nouvelle propriété contentDetails.contentRating.contentDetails.contentRating.djctqRatingReasons de la ressource video identifie les raisons pour lesquelles la vidéo a reçu sa classification DJCQT (Brésil).

• L'API est désormais compatible avec les erreurs suivantes :

  Type d'erreur	Détails de l'erreur	Description
  notFound (404)	channelNotFound	La méthode channels.update renvoie cette erreur si le paramètre id de la requête spécifie une chaîne introuvable.
  badRequest (400)	manualSortRequiredinvalidValue	Les méthodes playlistItems.insert et playlistItems.update renvoient cette erreur si la requête tente de définir la position de l'élément de playlist, mais que la playlist n'utilise pas le tri manuel. Par exemple, les éléments d'une playlist peuvent être triés par date ou par popularité. Pour résoudre cette erreur, supprimez l'élément snippet.position de la ressource envoyée dans le corps de la requête. Si vous souhaitez que l'élément de playlist occupe une position spécifique dans la liste, vous devez d'abord définir le paramètre d'ordre de la playlist sur Manuel. Vous pouvez ajuster ce paramètre dans le Gestionnaire de vidéos YouTube.
  forbidden (403)	channelClosed	La méthode playlists.list renvoie cette erreur si le paramètre channelId de la requête spécifie une chaîne qui a été fermée.
  forbidden (403)	channelSuspended	La méthode playlists.list renvoie cette erreur si le paramètre channelId de la requête spécifie une chaîne suspendue.
  forbidden (403)	playlistForbidden	La méthode playlists.list renvoie cette erreur si le paramètre id de la requête n'est pas compatible avec la requête ou si la requête n'est pas correctement autorisée.
  notFound (404)	channelNotFound	La méthode playlists.list renvoie cette erreur si le paramètre channelId de la requête spécifie une chaîne introuvable.
  notFound (404)	playlistNotFound	La méthode playlists.list renvoie cette erreur si le paramètre id de la requête spécifie une playlist introuvable.
  notFound (404)	videoNotFound	La méthode videos.list renvoie cette erreur si le paramètre id de la requête spécifie une vidéo introuvable.
  badRequest (400)	invalidRating	La méthode videos.rate renvoie cette erreur si la requête contient une valeur inattendue pour le paramètre rating.

2 mars 2015

Cette mise à jour inclut les changements suivants :

• La méthode search.list est désormais compatible avec le paramètre relevanceLanguage, qui vous permet de demander les résultats les plus pertinents pour une langue spécifique.

  Le guide de migration de l'API YouTube Data (v3) a également été mis à jour pour expliquer comment utiliser ce nouveau paramètre. Ce paramètre comble un manque de fonctionnalité qui existait auparavant entre la version actuelle de l'API (v3) et la version précédente (v2), qui est déjà obsolète.

• Le guide de migration de l'API YouTube Data (v3) a également été mis à jour pour indiquer l'abandon des flux spéciaux et des champs de métadonnées que l'API v2 fournissait pour décrire les films, les bandes-annonces, les séries télévisées, les saisons et les épisodes.

14 janvier 2015

Cette mise à jour inclut les changements suivants :

• Le guide de migration de l'API YouTube Data (v3) a été mis à jour pour expliquer comment utiliser l'API v3 afin de mettre en ligne des vidéos à l'aide de JavaScript. (Pour en savoir plus, consultez la section Mettre en ligne une vidéo.) Cette fonctionnalité est comparable à la fonctionnalité d'importation basée sur le navigateur que l'API v2 prend en charge. Notez que cette modification du guide de migration ne reflète pas un changement réel de l'API, mais plutôt la disponibilité d'un nouvel exemple de code pour importer des vidéos avec JavaScript côté client.

  Étant donné que l'importation de vidéos avec la bibliothèque cliente JavaScript et CORS est désormais possible, le guide de migration ne mentionne plus l'importation basée sur le navigateur comme une fonctionnalité qui pourrait être abandonnée dans l'API v3.

• La documentation de la méthode videos.insert a été mise à jour pour inclure le nouvel exemple de code JavaScript décrit ci-dessus. La liste des exemples de code JavaScript pour l'API YouTube Data (v3) a également été mise à jour.

11 novembre 2014

Cette mise à jour inclut les changements suivants :

• Le coût du quota pour un appel à la méthode search.list est passé à 100 unités.

  Important : Dans de nombreux cas, vous pouvez utiliser d'autres méthodes d'API pour récupérer des informations à un coût de quota inférieur. Par exemple, voici deux façons de trouver des vidéos mises en ligne sur la chaîne GoogleDevelopers.

  • Coût du quota : 100 unités

    Appelez la méthode search.list et recherchez GoogleDevelopers.

  • Coût du quota : 6 unités

    Appelez la méthode channels.list pour trouver l'ID de chaîne approprié. Définissez le paramètre forUsername sur GoogleDevelopers et le paramètre part sur contentDetails. Dans la réponse de l'API, la propriété contentDetails.relatedPlaylists.uploads spécifie l'ID de la playlist des vidéos mises en ligne sur la chaîne.

    Appelez ensuite la méthode playlistItems.list et définissez le paramètre playlistId sur l'ID capturé et le paramètre part sur snippet.

8 octobre 2014

Cette mise à jour inclut les changements suivants :

• La ressource channel contient deux nouvelles propriétés :

  • La propriété status.longUploadsStatus indique si la chaîne est autorisée à mettre en ligne des vidéos de plus de 15 minutes. Cette propriété n'est renvoyée que si le propriétaire de la chaîne a autorisé la requête API. Les valeurs de propriété valides sont les suivantes :

    • allowed : la chaîne peut mettre en ligne des vidéos de plus de 15 minutes.
    • eligible : la chaîne est éligible à la mise en ligne de vidéos de plus de 15 minutes, mais elle doit d'abord activer la fonctionnalité.
    • disallowed : la chaîne n'est pas en mesure de mettre en ligne des vidéos de plus de 15 minutes ou n'y est pas éligible.

    Pour en savoir plus sur ces valeurs, consultez la définition de la propriété. Le Centre d'aide YouTube fournit également des informations plus détaillées sur cette fonctionnalité.

  • La propriété invideoPromotion.useSmartTiming indique si la campagne promotionnelle de la chaîne utilise le "timing intelligent". Cette fonctionnalité tente d'afficher les promotions à un moment de la vidéo où elles sont plus susceptibles de générer des clics et moins susceptibles de perturber l'expérience de visionnage. Cette fonctionnalité sélectionne également une seule promotion à afficher sur chaque vidéo.

• Les définitions des propriétés snippet.title et snippet.categoryId de la ressource video ont été mises à jour pour clarifier la façon dont l'API gère les appels à la méthode videos.update. Si vous appelez cette méthode pour mettre à jour la partie snippet d'une ressource video, vous devez définir une valeur pour ces deux propriétés.

  Si vous essayez de mettre à jour la partie snippet d'une ressource video et que vous ne définissez pas de valeur pour ces deux propriétés, l'API renvoie une erreur invalidRequest. La description de cette erreur a également été mise à jour.

• La propriété contentDetails.contentRating.oflcRating de la ressource video, qui identifie la classification d'une vidéo attribuée par l'Office of Film and Literature Classification (OFLC) de Nouvelle-Zélande, accepte désormais deux nouvelles classifications : oflcRp13 et oflcRp16. Elles correspondent respectivement aux notes RP13 et RP16.

• La méthode channelBanners.insert est désormais compatible avec l'erreur suivante :

  Type d'erreur	Détails de l'erreur	Description
  badRequest	bannerAlbumFull	L'album "Illustrations de la chaîne YouTube" du propriétaire de la chaîne contient trop d'images. Le propriétaire de la chaîne doit accéder à http://photos.google.com, puis à la page des albums, et supprimer des images de l'album.

12 septembre 2014

Cette mise à jour inclut les changements suivants :

• Le coût du quota pour un appel à la méthode search.list est passé de 1 unité à 2 unités, en plus du coût des parties de ressources spécifiées.

13 août 2014

Cette mise à jour inclut les changements suivants :

• La méthode subscriptions.insert est désormais compatible avec l'erreur suivante :

  Type d'erreur	Détails de l'erreur	Description
  badRequest	subscriptionLimitExceeded	L'abonné identifié dans la demande a dépassé la limite de fréquence d'abonnement. Vous pourrez réessayer de vous abonner dans quelques heures.

12 août 2014

Cette mise à jour inclut les changements suivants :

• Un nouveau guide intitulé Migrer votre application vers l'API YouTube Data (v3) explique comment utiliser l'API YouTube Data (v3) pour effectuer des opérations disponibles dans l'API YouTube Data (v2). L'ancienne API est officiellement obsolète depuis le 4 mars 2014. Ce guide a pour objectif de vous aider à migrer les applications qui utilisent encore l'API v2 vers la version la plus récente de l'API.

8 juillet 2014

Cette mise à jour inclut les changements suivants :

• La méthode playlists.insert est désormais compatible avec l'erreur suivante :

  Type d'erreur	Détails de l'erreur	Description
  badRequest	maxPlaylistExceeded	Cette erreur se produit si une playlist ne peut pas être créée, car la chaîne a déjà atteint le nombre maximal de playlists autorisées.

18 juin 2014

Cette mise à jour inclut les changements suivants :

• La description de chaque méthode d'API a été mise à jour pour inclure le coût du quota entraîné par un appel à cette méthode. De même, les définitions des paramètres part ont été mises à jour pour spécifier le coût du quota de chaque partie pouvant être récupérée dans un appel d'API. Par exemple, un appel à la méthode subscriptions.insert a un coût de quota d'environ 50 unités. La ressource subscription contient également trois parties (snippet, contentDetails et subscriberSnippet), chacune coûtant deux unités.

  N'oubliez pas que les coûts de quota peuvent changer sans préavis.

• La ressource video est désormais compatible avec 43 nouveaux systèmes de classification du contenu, qui identifient les classifications attribuées aux vidéos par différentes agences nationales de classification. Les systèmes de classification nouvellement pris en charge proviennent des pays suivants : Argentine, Autriche, Belgique, Bulgarie, Chili (télévision), Chili (cinéma), République tchèque, Colombie, Danemark, Égypte, Estonie, Finlande, France, Grèce, Hong Kong, Islande, Indonésie, Irlande, Israël, Italie, Kenya, Lettonie, Luxembourg, Malaisie, Maldives, Malte, Pays-Bas, Nigeria, Norvège, Pérou, Philippines, Portugal, Roumanie, Singapour, Slovaquie, Afrique du Sud, Suède, Suisse, Taïwan, Thaïlande et Venezuela.

28 mai 2014

Cette mise à jour inclut les changements suivants :

• La méthode search.list est désormais compatible avec les paramètres location et locationRadius, qui vous permettent de rechercher des vidéos associées à une zone géographique. Une requête doit spécifier une valeur pour les deux paramètres afin de récupérer des résultats basés sur la localisation. L'API renverra une erreur si une requête n'inclut qu'un seul des deux paramètres.

  • Le paramètre location spécifie les coordonnées de latitude/longitude au centre de la zone géographique circulaire.

  • Le paramètre locationRadius spécifie la distance maximale à laquelle le lieu associé à une vidéo peut se trouver du centre de la zone pour que la vidéo soit toujours incluse dans les résultats de recherche.

13 mai 2014

Cette mise à jour inclut les changements suivants :

• La propriété invideoPromotion.items[] de la ressource channel a été mise à jour pour indiquer que vous ne pouvez généralement définir qu'un seul élément promu pour votre chaîne. Si vous essayez d'insérer trop d'articles promus, l'API renvoie une erreur tooManyPromotedItems, qui a un code d'état HTTP 400.

• La ressource channelSection peut désormais contenir des informations sur de nouveaux types de contenus mis en avant. La propriété snippet.type de la ressource channelSection accepte désormais les valeurs suivantes :

  • postedPlaylists : playlists que le propriétaire de la chaîne a publiées dans le flux d'activité de la chaîne
  • postedVideos : vidéos que le propriétaire de la chaîne a publiées dans le flux d'activités de la chaîne
  • subscriptions : chaînes auxquelles le propriétaire de la chaîne est abonné

• La nouvelle propriété contentDetails.contentRating.ifcoRating de la ressource video identifie la classification attribuée à une vidéo par l'Irish Film Classification Office.

• La définition de la propriété position.cornerPosition de la ressource watermark a été mise à jour pour indiquer que le filigrane apparaît toujours en haut à droite du lecteur.

• La définition du paramètre q pour la méthode search.list a été mise à jour pour indiquer que le terme de requête peut utiliser l'opérateur booléen NOT (-) afin d'exclure les vidéos associées à un terme de recherche spécifique. La valeur peut également utiliser l'opérateur booléen OR (|) pour trouver des vidéos associées à l'un des termes de recherche.

• La définition de la propriété pageInfo.totalResults renvoyée dans une réponse d'API à un appel search.list a été mise à jour pour indiquer que la valeur est une approximation et qu'elle peut ne pas représenter une valeur exacte. De plus, la valeur maximale est de 1 000 000. Vous ne devez pas utiliser cette valeur pour créer des liens de pagination. Utilisez plutôt les valeurs des propriétés nextPageToken et prevPageToken pour déterminer s'il faut afficher des liens de pagination.

• Les méthodes watermarks.set et watermarks.unset ont été mises à jour pour indiquer que l'API renvoie un code de réponse HTTP 204 pour les requêtes qui aboutissent.

2 mai 2014

Cette mise à jour inclut les changements suivants :

• La nouvelle ressource i18nLanguage identifie une langue d'application compatible avec le site Web YouTube. La langue de l'application peut également être appelée "langue de l'interface utilisateur". Pour le site Web YouTube, une langue d'application peut être sélectionnée automatiquement en fonction des paramètres du compte Google, de la langue du navigateur ou de l'adresse IP. Un utilisateur peut également sélectionner manuellement la langue de l'interface utilisateur souhaitée dans le pied de page du site YouTube.

  L'API est compatible avec une méthode permettant de lister les langues d'application acceptées. Les langues acceptées peuvent être utilisées comme valeur du paramètre hl lorsque vous appelez des méthodes d'API telles que videoCategories.list et guideCategories.list.

• La nouvelle ressource i18nRegion identifie une zone géographique qu'un utilisateur YouTube peut sélectionner comme région de contenu préférée. La région de contenu peut également être appelée "paramètres régionaux du contenu". Pour le site Web YouTube, une région de contenu peut être sélectionnée automatiquement en fonction d'heuristiques telles que le domaine YouTube ou l'adresse IP de l'utilisateur. Un utilisateur peut également sélectionner manuellement la région de contenu souhaitée dans le pied de page du site YouTube.

  L'API est compatible avec une méthode permettant de lister les régions de contenu acceptées. Les codes régionaux compatibles peuvent être utilisés comme valeur du paramètre regionCode lorsque vous appelez des méthodes d'API telles que search.list, videos.list, activities.list et videoCategories.list.

7 avril 2014

Cette mise à jour inclut les changements suivants :

• La nouvelle ressource channelSection contient des informations sur un ensemble de vidéos qu'une chaîne a choisi de mettre en avant. Par exemple, une section peut présenter les dernières vidéos mises en ligne d'une chaîne, ses vidéos les plus populaires ou les vidéos d'une ou plusieurs playlists.

  L'API est compatible avec les méthodes permettant de lister, d'insérer, de mettre à jour ou de supprimer des sections de chaîne. Vous pouvez récupérer la liste des sections de la chaîne de l'utilisateur authentifié en spécifiant un ID de chaîne particulier ou une liste d'ID de section de chaîne uniques.

  La documentation sur les erreurs a également été mise à jour pour décrire les messages d'erreur que l'API accepte spécifiquement pour ces nouvelles méthodes.

• La définition de l'objet fileDetails de la ressource video a été mise à jour pour expliquer que cet objet ne sera renvoyé que si la propriété processingDetails.fileDetailsAvailability de la vidéo a la valeur available.

  De même, la définition de l'objet suggestions de la ressource video a été mise à jour pour expliquer que cet objet ne sera renvoyé que si la propriété processingDetails.tagSuggestionsAvailability ou processingDetails.editorSuggestionsAvailability de la vidéo a la valeur available.

• La documentation des méthodes videos.insert et videos.update a été mise à jour pour indiquer que la propriété status.publishAt peut être définie lors de l'appel de ces méthodes.

• La définition de l'objet invideoPromotion de la ressource channel a été mise à jour pour expliquer que l'objet ne peut être récupéré que par le propriétaire de la chaîne.

• La liste des paramètres de la méthode videos.rate a été mise à jour pour indiquer que cette méthode n'est pas compatible avec le paramètre onBehalfOfContentOwner. Il s'agissait d'une erreur de documentation, car les requêtes videos.rate qui définissent ce paramètre renvoient une erreur 500.

31 mars 2014

Cette mise à jour inclut les changements suivants :

• La nouvelle propriété status.publishAt de la ressource video vous permet de spécifier la date et l'heure de publication d'une vidéo privée. Cette propriété ne peut être définie que si l'état de confidentialité de la vidéo est private et que la vidéo n'a jamais été publiée. Cette nouvelle propriété n'est pas soumise à la règle d'obsolescence.

13 mars 2014

Cette mise à jour inclut les changements suivants :

• L'API est désormais compatible avec la partie contentOwnerDetails pour les ressources channel. La nouvelle partie contient des données sur la chaîne qui sont pertinentes pour les partenaires YouTube associés à la chaîne, y compris l'ID du propriétaire de contenu associé à la chaîne, ainsi que la date et l'heure auxquelles le propriétaire de contenu et la chaîne ont été associés. Notez que cette nouvelle partie n'est pas soumise à la règle d'obsolescence.

• La documentation indique désormais la longueur maximale de caractères acceptée pour les propriétés suivantes :

  Ressource	Propriété	Durée maximale
  channel	invideoPromotion.items[].customMessage	40 caractères
  video	snippet.title	100 caractères
  video	snippet.description	5 000 octets
  video	snippet.tags	500 caractères. Notez que la valeur de la propriété est une liste et que les virgules entre les éléments de la liste sont comptabilisées dans la limite.

• La propriété brandingSettings.watch.featuredPlaylistId de la ressource channel est obsolète. L'API renverra une erreur si vous tentez de définir sa valeur.

• Les propriétés de ressource video suivantes ont été ajoutées à la liste des valeurs qui peuvent être définies lors de l'insertion ou de la mise à jour d'une vidéo :

  • recordingDetails.locationDescription
  • recordingDetails.location.latitude
  • recordingDetails.location.longitude
  • recordingDetails.recordingDate

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

• L'API est désormais compatible avec les erreurs suivantes :

  Type d'erreur	Détails de l'erreur	Description
  badRequest (400)	invalidCriteria	La méthode channels.list renvoie cette erreur si la requête spécifie des paramètres de filtre qui ne peuvent pas être utilisés ensemble.
  badRequest (400)	channelTitleUpdateForbidden	La méthode channels.update renvoie cette erreur si vous tentez de mettre à jour la partie brandingSettings d'une chaîne et de modifier la valeur de la propriété brandingSettings.channel.title. (Notez que l'API ne renvoie pas l'erreur si vous omettez la propriété.)
  badRequest (400)	invalidRecentlyUploadedBy	La méthode channels.update renvoie cette erreur si la propriété invideoPromotion.items[].id.recentlyUploadedBy spécifie un ID de chaîne non valide.
  badRequest (400)	invalidTimingOffset	La méthode channels.update renvoie cette erreur si la partie invideoPromotion spécifie un code temporel non valide.
  badRequest (400)	tooManyPromotedItems	La méthode channels.update renvoie cette erreur si la partie invideoPromotion spécifie un nombre d'articles mis en avant supérieur au nombre autorisé.
  forbidden (403)	promotedVideoNotAllowed	La méthode channels.update renvoie cette erreur si la propriété invideoPromotion.items[].id.videoId spécifie un ID vidéo introuvable ou qui ne peut pas être utilisé comme élément promu.
  forbidden (403)	websiteLinkNotAllowed	La méthode channels.update renvoie cette erreur si la propriété invideoPromotion.items[].id.websiteUrl spécifie une URL non autorisée.
  required (400)	requiredTimingType	La méthode channels.update renvoie cette erreur si une requête ne spécifie pas de paramètres de timing par défaut pour le moment où YouTube doit afficher un élément promu.
  required (400)	requiredTiming	La méthode channels.update doit spécifier un objet invideoPromotion.items[].timing pour chaque élément promu.
  required (400)	requiredWebsiteUrl	La méthode channels.update doit spécifier une propriété invideoPromotion.items[].id.websiteUrl pour chaque élément promu.
  badRequest (400)	invalidPublishAt	La méthode videos.insert renvoie cette erreur si les métadonnées de la requête spécifient une heure de publication planifiée non valide.

4 mars 2014

Cette mise à jour inclut les changements suivants :

• L'API YouTube Data, version 3, est désormais soumise au règlement relatif aux abandons décrit dans les Conditions d'utilisation des API YouTube. Notez que la page qui répertorie les API soumises à la règle d'abandon exclut spécifiquement certaines fonctionnalités de l'API v3 de cette règle.

5 décembre 2013

Cette mise à jour inclut les changements suivants :

• La documentation de la méthode search.list a été mise à jour pour indiquer correctement que vous n'avez pas besoin de spécifier de valeur pour exactement un paramètre de filtre lorsque vous envoyez une demande de recherche. Vous pouvez définir une valeur pour zéro ou un paramètre de filtre.

• Les définitions des paramètres de la méthode search.list ont été mises à jour pour indiquer que vous devez définir la valeur du paramètre type sur video si vous spécifiez également une valeur pour l'un des paramètres suivants :

  • eventType
  • videoCaption
  • videoCategoryId
  • videoDefinition
  • videoDimension
  • videoDuration
  • videoEmbeddable
  • videoLicense
  • videoSyndicated
  • videoType

• La taille minimale des bannières de chaîne importées a été réduite à 2 048 x 1 152 pixels. (Auparavant, la taille minimale était de 2 120 x 1 192 pixels.) Notez également que la documentation sur les ressources channel spécifie la taille maximale de toutes les images de bannières diffusées à partir de l'API. Par exemple, la taille maximale de l'image brandingSettings.image.bannerTvImageUrl pour les applications TV est de 2 120 x 1 192 pixels, mais l'image réelle peut être de 2 048 x 1 152 pixels. Le Centre d'aide YouTube fournit des conseils supplémentaires pour optimiser les illustrations de chaîne afin qu'elles s'affichent correctement sur différents types d'appareils.

• Plusieurs définitions de propriétés de ressources channel ont été mises à jour pour refléter les informations suivantes :

  • La valeur de la propriété brandingSettings.channel.description ne peut pas comporter plus de 1 000 caractères.
  • La propriété brandingSettings.channel.featuredChannelsTitle ne doit pas comporter plus de 30 caractères.
  • La propriété brandingSettings.channel.featuredChannelsUrls[] peut désormais lister jusqu'à 100 chaînes.
  • Si elle est définie, la valeur de la propriété brandingSettings.channel.unsubscribedTrailer doit spécifier l'ID YouTube d'une vidéo publique ou non répertoriée appartenant au propriétaire de la chaîne.

• La méthode channels.update accepte désormais les modifications apportées à la propriété invideoPromotion.items[].promotedByContentOwner. Cette propriété indique si le nom du propriétaire du contenu sera affiché lors de la diffusion de la promotion. Il ne peut être défini que si la requête API qui définit la valeur de la propriété est effectuée au nom du propriétaire du contenu à l'aide du paramètre onBehalfOfContentOwner.

• Les méthodes playlistItems.list et playlistItems.insert sont désormais compatibles avec le paramètre onBehalfOfContentOwner, qui l'est déjà pour plusieurs autres méthodes.

• La propriété contentDetails.contentRating.acbRating peut désormais spécifier une classification de l'Australian Classification Board (ACB) pour les films ou de l'Australian Communications and Media Authority (ACMA) pour les programmes télévisés pour enfants.

• Les nouvelles propriétés contentDetails.contentRating.catvRating et contentDetails.contentRating.catvfrRating identifient les classifications qu'une vidéo a reçues respectivement en vertu du système canadien de classification de la télévision et du système de classification de la Régie du cinéma en langue française, utilisé au Québec.

• La nouvelle propriété snippet.assignable de la ressource videoCategory indique si les vidéos mises à jour ou les nouvelles vidéos mises en ligne peuvent être associées à cette catégorie de vidéos.

• Des exemples de code ont été ajoutés pour les méthodes suivantes :

  • activities.insert (Go)
  • channelBanners.insert (Python)
  • channels.update (Python)
  • playlistItems.list (Go)
  • search.list (Go)
  • thumbnails.set (Java)
  • videos.insert (Go)

24 octobre 2013

Cette mise à jour inclut les changements suivants :

• L'API inclut deux fonctionnalités supplémentaires conçues pour vous aider à trouver et à mettre en avant des contenus de diffusion en direct :

  La nouvelle propriété snippet.liveBroadcastContent dans les résultats de recherche indique si une vidéo ou une chaîne contient du contenu de diffusion en direct. Les valeurs de propriété valides sont upcoming, active et none.

  • La nouvelle propriété snippet.liveBroadcastContent de la ressource video indique si la vidéo est une diffusion en direct à venir ou en cours. La liste ci-dessous explique les valeurs possibles de la propriété :

    • upcoming : la vidéo est une diffusion en direct qui n'a pas encore commencé.
    • active : la vidéo est une diffusion en direct en cours.
    • none : la vidéo n'est pas une diffusion en direct à venir ni en cours. Il s'agit de la valeur de la propriété pour les diffusions terminées qui sont toujours visibles sur YouTube.

  • La nouvelle propriété liveStreamingDetails de la ressource video est un objet qui contient des métadonnées sur une diffusion vidéo en direct. Pour récupérer ces métadonnées, incluez liveStreamingDetails dans la liste des parties de ressources de la valeur du paramètre part. Les métadonnées incluent les nouvelles propriétés suivantes :

    • liveStreamingDetails.actualStartTime : heure à laquelle la diffusion a réellement commencé. (Cette valeur sera présente une fois l'état de la diffusion défini sur active.)
    • liveStreamingDetails.actualEndTime : heure à laquelle la diffusion s'est réellement terminée. (Cette valeur sera présente une fois la diffusion terminée.)
    • liveStreamingDetails.scheduledStartTime : heure à laquelle la diffusion doit commencer.
    • liveStreamingDetails.scheduledEndTime : heure de fin prévue de la diffusion. Si la valeur de la propriété est vide ou si la propriété n'est pas présente, la diffusion est programmée pour durer indéfiniment.
    • liveStreamingDetails.concurrentViewers : nombre de personnes qui regardent la diffusion en direct.

    Pour récupérer ces métadonnées, incluez liveStreamingDetails dans la valeur du paramètre part lorsque vous appelez la méthode videos.list, videos.insert ou videos.update.

  Notez que deux autres fonctionnalités permettant d'identifier les contenus de diffusion en direct ont été publiées le 1er octobre 2013 : le paramètre eventType de la méthode search.list et la propriété snippet.liveBroadcastContent du résultat de recherche.

• La méthode videos.insert est désormais compatible avec le paramètre notifySubscribers, qui indique si YouTube doit envoyer une notification concernant la nouvelle vidéo aux utilisateurs abonnés à la chaîne de la vidéo. La valeur par défaut du paramètre est True, ce qui indique que les abonnés seront informés des nouvelles vidéos mises en ligne. Toutefois, un propriétaire de chaîne qui met en ligne de nombreuses vidéos peut préférer définir la valeur sur False pour éviter d'envoyer une notification à chaque nouvelle vidéo aux abonnés de la chaîne.

• La liste des propriétés pouvant être modifiées lors de l'appel de la méthode channels.update a été mise à jour pour inclure les propriétés invideoPromotion.items[].customMessage et invideoPromotion.items[].websiteUrl. De plus, la liste a été modifiée pour identifier les propriétés brandingSettings qui peuvent être modifiées. Ces propriétés brandingSettings étaient déjà modifiables. La modification de la documentation ne reflète donc pas un changement de la fonctionnalité existante de l'API.

• Les méthodes playlists.insert, playlists.update et playlists.delete sont désormais compatibles avec le paramètre onBehalfOfContentOwner, qui l'est déjà pour plusieurs autres méthodes.

• La méthode playlists.insert est désormais compatible avec le paramètre onBehalfOfContentOwnerChannel, qui l'est déjà pour plusieurs autres méthodes.

• La propriété contentDetails.contentRating.tvpgRating de la ressource video accepte désormais la valeur pg14, qui correspond à une classification TV-14.

• La définition de la propriété snippet.liveBroadcastContent, qui fait partie des résultats de recherche, a été corrigée pour indiquer que live est une valeur de propriété valide, mais que active ne l'est pas.

• La propriété contentDetails.contentRating.mibacRating de la ressource video accepte désormais deux notes supplémentaires :

  • mibacVap (VAP) : les enfants doivent être accompagnés d'un adulte.
  • mibacVm6 (V.M.6) – Interdit aux moins de 6 ans.
  • mibacVm12 (V.M.12) : interdit aux moins de 12 ans.

• La nouvelle propriété invideoPromotion.items[].promotedByContentOwner de la ressource channel indique si le nom du propriétaire du contenu sera affiché lors de la diffusion de la promotion. Ce champ ne peut être défini que si la requête API qui définit la valeur est effectuée au nom du propriétaire du contenu. Pour en savoir plus, consultez le paramètre onBehalfOfContentOwner.

1er octobre 2013

Cette mise à jour inclut les changements suivants :

• Le nouvel objet auditDetails de la ressource channel contient des données de chaîne qu'un réseau multichaîne évaluerait pour déterminer s'il doit accepter ou refuser une chaîne spécifique. Notez que toute requête API qui récupère cette partie de ressource doit fournir un jeton d'autorisation contenant le champ d'application https://www.googleapis.com/auth/youtubepartner-channel-audit. De plus, tout jeton utilisant ce champ d'application doit être révoqué lorsque le CM décide d'accepter ou de refuser la chaîne, ou dans les deux semaines suivant la date d'émission du jeton.

• La propriété invideoPromotion.items[].id.type de la ressource channel accepte désormais la valeur recentUpload, qui indique que l'élément promu est la vidéo la plus récemment mise en ligne sur une chaîne spécifiée.

  Par défaut, le canal est le même que celui pour lequel les données de promotion dans la vidéo sont définies. Toutefois, vous pouvez promouvoir la dernière vidéo mise en ligne d'une autre chaîne en définissant la valeur de la nouvelle propriété invideoPromotion.items[].id.recentlyUploadedBy sur l'ID de cette chaîne.

• La ressource channel contient trois nouvelles propriétés (brandingSettings.image.bannerTvLowImageUrl, brandingSettings.image.bannerTvMediumImageUrl et brandingSettings.image.bannerTvHighImageUrl) qui spécifient les URL des images de bannières affichées sur les pages de chaînes dans les applications TV.

• La nouvelle propriété snippet.liveBroadcastContent dans les résultats de recherche indique si une vidéo ou une chaîne contient du contenu de diffusion en direct. Les valeurs de propriété valides sont upcoming, active et none.

  • Pour une ressource video, une valeur upcoming indique que la vidéo est une diffusion en direct qui n'a pas encore commencé, tandis qu'une valeur active indique que la vidéo est une diffusion en direct en cours.
  • Pour une ressource channel, une valeur upcoming indique que la chaîne a une diffusion programmée qui n'a pas encore commencé, tandis qu'une valeur acive indique que la chaîne a une diffusion en direct en cours.

• Dans la ressource watermark, la propriété targetChannelId est passée d'un objet à une chaîne. Au lieu de contenir une propriété enfant qui spécifie l'ID de chaîne YouTube de la chaîne vers laquelle l'image de filigrane renvoie, la propriété targetChannelId spécifie désormais cette valeur elle-même. Par conséquent, la propriété targetChannelId.value de la ressource a été supprimée.

• La méthode thumbnails.set est désormais compatible avec le paramètre onBehalfOfContentOwner, qui l'est déjà pour plusieurs autres méthodes.

• La méthode search.list est désormais compatible avec le paramètre eventType, qui limite une recherche pour ne renvoyer que les événements de diffusion actifs, à venir ou terminés.

• La nouvelle propriété contentDetails.contentRating.mibacRating identifie la classification attribuée à une vidéo par le Ministero dei Beni e delle Attività Culturali e del Turismo italien.

• L'API est désormais compatible avec les erreurs suivantes :

  Type d'erreur	Détails de l'erreur	Description
  badRequest	invalidImage	La méthode thumbnails.set renvoie cette erreur si le contenu de l'image fournie n'est pas valide.
  forbidden	videoRatingDisabled	La méthode videos.rate renvoie cette erreur si le propriétaire de la vidéo évaluée a désactivé les évaluations pour cette vidéo.

27 août 2013

Cette mise à jour inclut les changements suivants :

• La nouvelle ressource watermark identifie une image qui s'affiche lors de la lecture des vidéos d'une chaîne spécifiée. Vous pouvez également spécifier un canal cible vers lequel l'image sera redirigée, ainsi que des informations sur le timing qui déterminent quand le filigrane apparaît pendant la lecture de la vidéo et pendant combien de temps il est visible.

  La méthode watermarks.set importe et définit l'image du filigrane d'une chaîne. La méthode watermarks.unset supprime l'image de filigrane d'une chaîne.

  La documentation sur les erreurs décrit les messages d'erreur que l'API accepte spécifiquement pour les méthodes watermarks.set et watermarks.unset.

• La nouvelle propriété statistics.hiddenSubscriberCount de la ressource channel contient une valeur booléenne indiquant si le nombre d'abonnés de la chaîne est masqué. Par conséquent, la valeur de la propriété est false si le nombre d'abonnés de la chaîne est visible publiquement.

• La méthode playlists.list est désormais compatible avec les paramètres onBehalfOfContentOwner et onBehalfOfContentOwnerChannel. Ces deux paramètres sont déjà compatibles avec plusieurs autres méthodes.

• La méthode videos.list prend désormais en charge le paramètre regionCode, qui identifie la région de contenu pour laquelle un graphique doit être récupéré. Ce paramètre ne peut être utilisé qu'avec le paramètre chart. La valeur du paramètre est un code pays ISO 3166-1 alpha-2.

• error documentation décrit la nouvelle erreur de requête courante suivante, qui peut se produire pour plusieurs méthodes d'API :

  Type d'erreur	Détails de l'erreur	Description
  forbidden	insufficientPermissions	Les champs d'application associés au jeton OAuth 2.0 fourni pour la requête sont insuffisants pour accéder aux données demandées.

15 août 2013

Cette mise à jour inclut les changements suivants :

• L'objet invideoPromotion de la ressource channel comporte les propriétés nouvelles et mises à jour suivantes :

  • L'API permet désormais de spécifier un site Web comme élément promu. Pour ce faire, définissez la valeur de la propriété invideoPromotion.items[].id.type sur website et utilisez la nouvelle propriété invideoPromotion.items[].id.websiteUrl pour spécifier l'URL. Utilisez également la nouvelle propriété invideoPromotion.items[].customMessage pour définir un message personnalisé à afficher pour la promotion.

    Les liens peuvent rediriger vers des sites Web associés, des sites marchands ou des sites de réseaux sociaux. Pour savoir comment activer les liens vers vos contenus, consultez les instructions du centre d'aide YouTube concernant les sites Web associés et les sites de marchands.

    En ajoutant des liens promotionnels, vous acceptez qu'ils ne soient pas utilisés pour rediriger le trafic vers des sites non autorisés et qu'ils respectent les Règles AdWords, les Règles relatives aux annonces YouTube, le Règlement de la communauté YouTube et les Conditions d'utilisation de YouTube.

  • Les propriétés liées aux paramètres de timing pour l'affichage des articles sponsorisés pendant la lecture de la vidéo ont été restructurées :

    • L'objet invideoPromotion.timing a été déplacé vers invideoPromotion.items[].timing. Cet objet vous permet désormais de personnaliser les données de timing pour chaque élément promu de la liste invideoPromotion.items[].

    • Le nouvel objet invideoPromotion.defaultTiming spécifie les paramètres de timing par défaut de votre promotion. Ces paramètres définissent le moment où un article promu s'affiche pendant la lecture d'une vidéo de votre chaîne. Vous pouvez remplacer le timing par défaut d'un élément promu donné à l'aide de l'objet invideoPromotion.items[].timing.

    • La nouvelle propriété invideoPromotion.items[].timing.durationMs spécifie la durée d'affichage de la promotion, en millisecondes. L'objet invideoPromotion.defaultTiming contient également un champ durationMs qui spécifie la durée par défaut pendant laquelle l'article promu s'affichera.

  • Les propriétés invideoPromotion.items[].type et invideoPromotion.items[].videoId ont toutes deux été déplacées dans l'objet invideoPromotion.items[].id.

• La méthode subscriptions.list est désormais compatible avec les paramètres onBehalfOfContentOwner et onBehalfOfContentOwnerChannel. Ces deux paramètres sont déjà compatibles avec plusieurs autres méthodes.

• Dans la réponse de l'API à une requête thumbnails.set, la valeur de la propriété kind est passée de youtube#thumbnailListResponse à youtube#thumbnailSetResponse.

• Des exemples de code ont été ajoutés pour les méthodes suivantes :

  • channels.update (Java, Python)
  • playlists.insert (.NET, PHP)
  • subscriptions.insert (PHP, Python)
  • thumbnails.set (PHP, Python)
  • videos.insert (PHP)
  • videos.list (PHP)
  • videos.rate (Python)
  • videos.update (Java, PHP, Python)

  Notez que l'exemple Python pour la méthode playlistItems.insert a également été supprimé, car la fonctionnalité qu'il illustrait est désormais gérée par la méthode videos.rate.

• error documentation décrit la nouvelle erreur de contexte de requête suivante, qui peut se produire pour n'importe quelle méthode d'API compatible avec le paramètre de requête mine :

  Type d'erreur	Détails de l'erreur	Description
  badRequest	invalidMine	Le paramètre mine ne peut pas être utilisé dans les requêtes où l'utilisateur authentifié est un partenaire YouTube. Vous devez supprimer le paramètre mine, vous authentifier en tant qu'utilisateur YouTube en supprimant le paramètre onBehalfOfContentOwner, ou agir en tant que l'une des chaînes du partenaire en fournissant le paramètre onBehalfOfContentOwnerChannel s'il est disponible pour la méthode appelée.

8 août 2013

Cette mise à jour inclut les changements suivants :

• La section Utilisation du quota du guide Premiers pas avec l'API YouTube Data a été mise à jour pour refléter une modification du coût du quota pour la mise en ligne d'une vidéo, qui est passé d'environ 16 000 unités à environ 1 600 unités.

30 juillet 2013

Cette mise à jour inclut les changements suivants :

• Dans une ressource channelBanner, la valeur de la propriété kind est passée de youtube#channelBannerInsertResponse à youtube#channelBannerResource. Cette ressource est renvoyée en réponse à une requête channelBanners.insert.

• La nouvelle propriété brandingSettings.channel.profileColor de la ressource channel spécifie une couleur dominante qui complète le contenu de la chaîne. La valeur de la propriété est un signe dièse (#) suivi d'une chaîne hexadécimale de six caractères, telle que #2793e6.

• L'API permet désormais d'indiquer si un abonnement concerne toutes les activités d'une chaîne ou uniquement les nouvelles mises en ligne. La nouvelle propriété contentDetails.activityType de la ressource subscription identifie les types d'activités pour lesquelles l'abonné recevra des notifications. Les valeurs de propriété valides sont all et uploads.

• La méthode videos.list est compatible avec de nouveaux paramètres permettant de récupérer un classement des vidéos les plus populaires sur YouTube :

  • Le paramètre chart identifie le graphique que vous souhaitez récupérer. Actuellement, la seule valeur acceptée est mostPopular. Notez que le paramètre chart est un paramètre de filtre. Cela signifie qu'il ne peut pas être utilisé dans la même requête que d'autres paramètres de filtre (id et myRating).
  • Le paramètre videoCategoryId identifie la catégorie de vidéo pour laquelle le graphique doit être récupéré. Ce paramètre ne peut être utilisé qu'avec le paramètre chart. Par défaut, les graphiques ne sont pas limités à une catégorie spécifique.

• La nouvelle propriété topicDetails.relevantTopicIds[] de la ressource video fournit une liste d'ID de thèmes Freebase en rapport avec la vidéo ou son contenu. Les sujets de ces thèmes peuvent être mentionnés ou apparaître dans la vidéo.

• La propriété recordingDetails.location.elevation de la ressource video a été renommée recordingDetails.location.altitude, et sa propriété fileDetails.recordingLocation.location.elevation a été renommée fileDetails.recordingLocation.location.altitude.

• L'objet contentDetails.contentRating de la ressource video spécifie les classifications attribuées à une vidéo dans différents systèmes de classification, y compris les classifications MPAA, TVPG, etc. Pour chaque système de classification, l'API accepte désormais une valeur de classification indiquant que la vidéo n'a pas été classée. Notez que pour les classifications MPAA, la classification "Non classé" est souvent utilisée pour identifier les versions non censurées de films dont la version censurée a reçu une classification officielle.

• La nouvelle propriété contentDetails.contentRating.ytRating de la ressource video identifie le contenu soumis à une limite d'âge. La valeur de la propriété sera ytAgeRestricted si YouTube a identifié que la vidéo contient du contenu inapproprié pour les utilisateurs de moins de 18 ans. Si la propriété est absente ou si sa valeur est vide, cela signifie que le contenu n'a pas été identifié comme soumis à une limite d'âge.

• Le paramètre mySubscribers de la méthode channels.list a été abandonné. Utilisez la méthode subscriptions.list et son paramètre mySubscribers pour récupérer la liste des abonnés à la chaîne de l'utilisateur authentifié.

• Les méthodes channelBanners.insert, channels.update, videos.getRating et videos.rate sont désormais compatibles avec le paramètre onBehalfOfContentOwner. Ce paramètre indique que l'utilisateur authentifié agit au nom du propriétaire du contenu spécifié dans la valeur du paramètre.

• La documentation de la méthode channels.update a été mise à jour pour refléter le fait que cette méthode peut être utilisée pour mettre à jour l'objet brandingSettings de la ressource channel et ses propriétés enfants. La documentation liste désormais la liste mise à jour des propriétés que vous pouvez définir pour l'objet invideoPromotion de la ressource channel.

• error documentation décrit les nouvelles erreurs suivantes :

  Type d'erreur	Détails de l'erreur	Description
  forbidden	accountDelegationForbidden	Cette erreur n'est pas spécifique à une méthode API particulière. Elle indique que l'utilisateur authentifié n'est pas autorisé à agir au nom du compte Google spécifié.
  forbidden	authenticatedUserAccountClosed	Cette erreur n'est pas spécifique à une méthode API particulière. Elle indique que le compte YouTube de l'utilisateur authentifié est clôturé. Si l'utilisateur agit au nom d'un autre compte Google, cette erreur indique que ce compte est fermé.
  forbidden	authenticatedUserAccountSuspended	Cette erreur n'est pas spécifique à une méthode API particulière. Il indique que le compte YouTube de l'utilisateur authentifié est suspendu. Si l'utilisateur agit au nom d'un autre compte Google, cette erreur indique que cet autre compte est suspendu.
  forbidden	authenticatedUserNotChannel	Cette erreur n'est pas spécifique à une méthode API particulière. Cela indique que le serveur d'API ne parvient pas à identifier la chaîne associée à la requête API. Si la requête est autorisée et utilise le paramètre onBehalfOfContentOwner, vous devez également définir le paramètre onBehalfOfContentOwnerChannel.
  forbidden	cmsUserAccountNotFound	Cette erreur n'est pas spécifique à une méthode API particulière. L'utilisateur du CMS n'est pas autorisé à agir au nom du propriétaire de contenu spécifié.
  notFound	contentOwnerAccountNotFound	Cette erreur n'est pas spécifique à une méthode API particulière. Le compte de propriétaire de contenu spécifié est introuvable.
  badRequest	invalidPart	Cette erreur n'est pas spécifique à une méthode API particulière. Le paramètre part de la requête spécifie des parties qui ne peuvent pas être écrites en même temps.
  badRequest	videoChartNotFound	La méthode videos.list renvoie cette erreur lorsque la requête spécifie un graphique vidéo non compatible ou non disponible.
  notFound	videoNotFound	La méthode videos.update renvoie cette erreur pour indiquer que la vidéo que vous essayez de modifier est introuvable. Vérifiez que la valeur de la propriété id dans le corps de la requête est correcte.

10 juin 2013

Cette mise à jour inclut les changements suivants :

• Le nouveau paramètre forUsername de la méthode channels.list vous permet de récupérer des informations sur une chaîne en spécifiant son nom d'utilisateur YouTube.

• La méthode activities.list est désormais compatible avec le paramètre regionCode, qui indique à l'API de renvoyer les résultats correspondant au pays spécifié. YouTube utilise cette valeur lorsque l'activité précédente de l'utilisateur autorisé sur YouTube ne fournit pas suffisamment d'informations pour générer le flux d'activité.

• Les ressources de playlist contiennent désormais la propriété snippet.tags. La propriété ne sera renvoyée qu'aux utilisateurs autorisés qui récupèrent des données sur leurs propres playlists. Les utilisateurs autorisés peuvent également définir des tags de playlist lorsqu'ils appellent les méthodes playlists.insert ou playlists.update.

• Le paramètre onBehalfOfContentOwner, qui était auparavant compatible avec les méthodes channels.list et search.list, l'est désormais également avec les méthodes videos.insert, videos.update et videos.delete. Notez que lorsque ce paramètre est utilisé dans un appel à la méthode videos.insert, la requête doit également spécifier une valeur pour le nouveau paramètre onBehalfOfContentOwnerChannel, qui identifie la chaîne à laquelle la vidéo sera ajoutée. La chaîne doit être associée au propriétaire de contenu spécifié par le paramètre onBehalfOfContentOwner.

  Ce paramètre indique que les identifiants d'autorisation de la requête identifient un utilisateur du CMS YouTube qui agit au nom du propriétaire du contenu spécifié dans la valeur du paramètre. Le compte CMS avec lequel l'utilisateur s'authentifie doit être associé au propriétaire de contenu YouTube spécifié.

  Ce paramètre est destiné aux partenaires de contenu qui possèdent et gèrent de nombreuses chaînes YouTube différentes. Ce paramètre permet à ces partenaires de s'authentifier une seule fois et d'accéder à toutes leurs données vidéo et de chaîne, sans avoir à fournir d'identifiants d'authentification pour chaque chaîne.

  Plus précisément, en ce qui concerne cette version, le paramètre permet désormais à un partenaire de contenu d'insérer, de modifier ou de supprimer des vidéos dans l'une des chaînes YouTube dont il est propriétaire.

• error documentation décrit les nouvelles erreurs suivantes :

  Type d'erreur	Détails de l'erreur	Description
  forbidden	insufficientCapabilities	Cette erreur n'est pas spécifique à une méthode API particulière. Cela indique que l'utilisateur du CMS qui appelle l'API ne dispose pas des autorisations suffisantes pour effectuer l'opération demandée. Cette erreur est associée à l'utilisation du paramètre onBehalfOfContentOwner, qui est compatible avec plusieurs méthodes d'API.
  unauthorized	authorizationRequired	La méthode activities.list renvoie cette erreur lorsque la requête utilise le paramètre home, mais n'est pas correctement autorisée.

• Dans la ressource channels, la propriété invideoPromotion.channelId a été supprimée, car l'ID de chaîne est déjà spécifié à l'aide de la propriété id de la ressource.

• Le nouveau guide Utiliser les ID de chaîne explique comment l'API utilise les ID de chaîne. Ce guide peut être particulièrement utile aux développeurs qui migrent depuis la version précédente de l'API et qui disposent d'applications qui demandent du contenu pour l'utilisateur default ou qui reposent sur l'idée que chaque chaîne YouTube possède un nom d'utilisateur unique, ce qui n'est plus le cas.

22 mai 2013

Cette mise à jour inclut les changements suivants :

• La nouvelle méthode channelBanners.insert vous permet d'importer une bannière qui peut ensuite être définie comme bannière d'une chaîne à l'aide de la nouvelle propriété brandingSettings.image.bannerExternalUrl de la ressource channel.

• La documentation de la méthode channels.update a été mise à jour pour lister les propriétés qui peuvent être modifiées lors de l'appel de la méthode.

• La documentation sur la ressource video n'indique plus unspecified comme valeur de propriété valide pour les propriétés suggestions.processingErrors[], suggestions.processingHints[], suggestions.processingWarnings[] et suggestions.editorSuggestions[].

• Le paramètre maxResults de la méthode videos.list a désormais une valeur par défaut de 5.

• error documentation liste désormais les erreurs pour les méthodes channelBanners.insert et subscriptions.list. Il liste également plusieurs nouvelles erreurs pour la méthode channels.update.

14 mai 2013

Cette mise à jour inclut les changements suivants :

• Les pages autonomes listent désormais des exemples de code pour Java, .NET, PHP et Ruby.

• La page qui liste les exemples de code Python inclut désormais des exemples pour ajouter un abonnement, créer une playlist et modifier une vidéo.

10 mai 2013

Cette mise à jour inclut les changements suivants :

• YouTube n'identifie plus les fonctionnalités et services d'API expérimentaux. Nous fournissons désormais une liste des API YouTube soumises au règlement relatif aux abandons.

8 mai 2013

Cette mise à jour inclut les changements suivants :

• Les ressources de chaîne sont désormais compatibles avec l'objet inVideoPromotion, qui encapsule les informations sur une campagne promotionnelle associée à la chaîne. Une chaîne peut utiliser une campagne promotionnelle dans une vidéo pour afficher des miniatures d'une vidéo promue dans le lecteur vidéo lors de la lecture des vidéos de la chaîne.

  Vous pouvez récupérer ces données en incluant invideoPromotion dans la valeur du paramètre part d'une requête channels.list.

• La nouvelle méthode channels.update permet de mettre à jour les données des campagnes promotionnelles dans les vidéos d'une chaîne. Notez que la méthode n'est compatible qu'avec les mises à jour de la partie invideoPromotion de la ressource channel. Elle n'est pas encore compatible avec les mises à jour d'autres parties de cette ressource.

2 mai 2013

Cette mise à jour inclut les changements suivants :

• Les ressources de chaîne sont désormais compatibles avec la propriété status.isLinked, qui indique si les données de la chaîne identifient un utilisateur déjà associé à un nom d'utilisateur YouTube ou à un compte Google+. Un utilisateur qui possède l'un de ces liens dispose déjà d'une identité YouTube publique, ce qui est une condition requise pour plusieurs actions, comme la mise en ligne de vidéos.

• Les ressources d'abonnement sont désormais compatibles avec la partie subscriberSnippet. Cet objet encapsule les données d'extrait de la chaîne de l'abonné.

• L'API est désormais compatible avec la méthode videos.getRating, qui récupère les notes attribuées par l'utilisateur authentifié à une liste d'une ou plusieurs vidéos.

• Le nouveau paramètre myRating de la méthode videos.list vous permet de récupérer la liste des vidéos auxquelles l'utilisateur authentifié a attribué une note like ou dislike.

  Les paramètres myRating et id sont désormais considérés comme des paramètres de filtre. Cela signifie qu'une requête API doit spécifier exactement l'un des paramètres. (Auparavant, le paramètre id était obligatoire pour cette méthode.)

  La méthode renvoie une erreur forbidden pour les requêtes qui tentent de récupérer des informations sur la classification des vidéos, mais qui ne sont pas correctement autorisées à le faire.

• Avec l'introduction du paramètre myRating, la méthode videos.list a également été mise à jour pour prendre en charge la pagination. Notez toutefois que les paramètres de pagination ne sont acceptés que pour les requêtes utilisant le paramètre myRating. (Les paramètres et informations de pagination ne sont pas acceptés pour les requêtes qui utilisent le paramètre id.)

  • Le paramètre maxResults spécifie le nombre maximal de vidéos que l'API peut renvoyer dans l'ensemble de résultats, et le paramètre pageToken identifie une page spécifique de l'ensemble de résultats que vous souhaitez récupérer.

  • La ressource youtube#videoListResponse, qui est renvoyée en réponse à une requête videos.list, contient désormais l'objet pageInfo, qui inclut des informations telles que le nombre total de résultats et le nombre de résultats inclus dans l'ensemble de résultats actuel. La ressource youtube#videoListResponse peut également inclure les propriétés nextPageToken et prevPageToken, qui fournissent chacune un jeton pouvant être utilisé pour récupérer une page spécifique dans l'ensemble de résultats.

• La méthode videos.insert accepte les nouveaux paramètres suivants :

  • autoLevels : définissez la valeur de ce paramètre sur true pour demander à YouTube d'améliorer automatiquement la luminosité et la couleur de la vidéo.
  • stabilize : définissez la valeur de ce paramètre sur true pour demander à YouTube d'ajuster la vidéo en supprimant les tremblements dus aux mouvements de la caméra.

• La propriété channelTitle a été ajoutée à snippet pour les ressources suivantes :

  • playlistItem : la propriété spécifie le nom de la chaîne qui a ajouté l'élément de playlist.
  • playlist : la propriété spécifie le nom de la chaîne qui a créé la playlist.
  • subscription : la propriété spécifie le nom de la chaîne à laquelle l'utilisateur est abonné.

• Des exemples de code ont été ajoutés pour les méthodes suivantes :

  • activities.insert (Ruby)
  • playlistItems.list (.NET)
  • search.list (.NET)
  • subscriptions.insert (Java, Ruby)
  • videos.insert (.NET, Ruby)

• Le nouveau paramètre mySubscribers de la méthode subscriptions.list vous permet de récupérer la liste des abonnés de l'utilisateur actuellement authentifié. Ce paramètre ne peut être utilisé que dans une requête correctement autorisée.

  Remarque : Cette fonctionnalité est destinée à remplacer le paramètre mySubscribers actuellement compatible avec la méthode channels.list. Ce paramètre sera obsolète.

• Dans une ressource video, la valeur de propriété unspecified n'est plus une valeur possible pour les propriétés suivantes :

  • fileDetails.fileType
  • fileDetails.videoStreams[].rotation
  • processingDetails.processingStatus
  • processingDetails.processingFailureReason
  • fileDetails.fileType

• Les requêtes d'API qui contiennent un paramètre inattendu renvoient désormais une erreur badRequest, et la raison de l'erreur est unexpectedParameter.

• L'erreur renvoyée par la méthode playlistItems.insert lorsque la playlist contient déjà le nombre maximal d'éléments autorisés a été modifiée. L'erreur est désormais signalée comme une erreur forbidden, et la raison de l'erreur est playlistContainsMaximumNumberOfVideos.

19 avril 2013

Cette mise à jour inclut les changements suivants :

• La nouvelle méthode videos.rate permet à un utilisateur d'attribuer une note like ou dislike à une vidéo, ou de supprimer une note.

  La documentation sur les erreurs a également été mise à jour pour lister les erreurs que l'API peut renvoyer en réponse à un appel de méthode videos.rate.

• Les miniatures sont désormais identifiées dans la documentation de l'API comme une ressource distincte. La nouvelle méthode thumbnails.set vous permet d'importer une miniature vidéo personnalisée sur YouTube et de la définir pour une vidéo.

  La documentation sur les erreurs a également été mise à jour pour lister les erreurs que l'API peut renvoyer en réponse à un appel de méthode thumbnails.set.

  Notez que ce changement n'affecte pas vraiment les ressources existantes qui renvoient des miniatures. Les miniatures sont renvoyées dans ces ressources de la même manière qu'auparavant. Toutefois, la documentation liste désormais les noms des différentes tailles de miniatures que l'API peut renvoyer.

• La nouvelle partie brandingSettings de la ressource channel identifie les paramètres, le texte et les images pour la page de la chaîne et les pages de lecture des vidéos.

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

  • Le nouvel objet status encapsule les informations sur l'état de l'élément de playlist, et la propriété status.privacyStatus identifie l'état de confidentialité de l'élément de playlist.

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

  • La propriété status.publicStatsViewable indique si les statistiques vidéo étendues sur la page de lecture sont visibles publiquement. Par défaut, ces statistiques sont visibles. De plus, les statistiques telles que le nombre de vues et les évaluations d'une vidéo resteront publiques même si la valeur de cette propriété est définie sur false. Vous pouvez définir la valeur de cette propriété lorsque vous appelez la méthode videos.insert ou videos.update.

  • L'objet contentDetails.contentRating encapsule les classifications attribuées à la vidéo selon différents systèmes de classification. La liste ci-dessous identifie les systèmes de classification acceptés et fournit un lien vers la propriété associée à chaque système de classification. Les définitions des propriétés identifient les valeurs de classification acceptées pour chaque système.

    Pays	Système de classification	Propriété
    United States	Motion Picture Association of America (MPAA)	contentDetails.contentRating.mpaaRating
    United States	TV Parental Guidelines	contentDetails.contentRating.tvpgRating
    Australia	Australian Classification Board (ACB)	contentDetails.contentRating.acbRating
    Brazil	Departamento de Justiça, Classificação, Qualificação e Títulos	contentDetails.contentRating.djctqRating
    Canada	Canadian Home Video Rating System (CHVRS)	contentDetails.contentRating.chvrsRating
    France	Centre national du cinéma et de l'image animée (ministère français de la Culture)	contentDetails.contentRating.fmocRating
    Germany	Freiwillige Selbstkontrolle der Filmwirtschaft (FSK)	contentDetails.contentRating.fskRating
    Great Britain	British Board of Film Classification (BBFC)	contentDetails.contentRating.bbfcRating
    India	Central Board of Film Certification (CBFC)	contentDetails.contentRating.cbfcRating
    Japan	映倫管理委員会 (EIRIN)	contentDetails.contentRating.eirinRating
    Korea	영상물등급위원회 (KMRB)	contentDetails.contentRating.kmrbRating
    Mexico	Direction générale de la radio, de la télévision et du cinéma (RTC)	contentDetails.contentRating.rtcRating
    New Zealand	Office of Film and Literature Classification	contentDetails.contentRating.oflcRating
    Russia	Registre national des films de la Fédération de Russie	contentDetails.contentRating.russiaRating
    Spain	Instituto de la Cinematografía y de las Artes Audiovisuales (ICAA)	contentDetails.contentRating.icaaRating

• La documentation de la méthode playlistItems.update a été mise à jour pour indiquer que la propriété snippet.resourceId doit être spécifiée dans la ressource envoyée en tant que corps de la requête.

• La méthode search.list est désormais compatible avec les fonctionnalités suivantes :

  • Le nouveau paramètre forMine limite une recherche à la récupération des vidéos de l'utilisateur authentifié uniquement.

  • Le paramètre order permet désormais de trier les résultats par ordre alphabétique selon le titre (order=title) ou par nombre de vidéos par ordre décroissant (order=videoCount).

  • Le nouveau paramètre safeSearch indique si les résultats de recherche doivent inclure du contenu soumis à restriction.

• La méthode videos.insert accepte plusieurs nouvelles erreurs, qui sont listées dans le tableau ci-dessous :

  Type d'erreur	Détails de l'erreur	Description
  badRequest	invalidCategoryId	La propriété snippet.categoryId spécifie un ID de catégorie non valide. Utilisez la méthode videoCategories.list pour récupérer les catégories acceptées.
  badRequest	invalidRecordingDetails	metadata indique des informations d'enregistrement non valides.
  badRequest	invalidVideoGameRating	Les métadonnées de la requête spécifient une classification de jeu vidéo non valide.
  badRequest	invalidVideoMetadata	Les métadonnées de la demande ne sont pas valides.

• Le paramètre onBehalfOfContentOwner a été supprimé de la liste des paramètres acceptés pour les méthodes videos.update et videos.delete.

12 mars 2013

Cette mise à jour inclut les changements suivants :

• La propriété channelTitle a été ajoutée à snippet pour les ressources suivantes :

  • activity : la propriété spécifie le nom de la chaîne responsable de l'activité.
  • search : la propriété spécifie le nom de la chaîne associée à la ressource identifiée par le résultat de recherche.
  • video : la propriété spécifie le nom de la chaîne qui a importé la vidéo.

• La méthode search.list accepte les nouveaux paramètres suivants :

  • Le paramètre channelType vous permet de limiter une recherche de chaînes pour récupérer toutes les chaînes ou uniquement les séries.

  • Le paramètre videoType vous permet de limiter une recherche de vidéos pour récupérer toutes les vidéos, ou uniquement les films ou les épisodes de séries.

• La définition de la partie recordingDetails de la ressource video a été mise à jour pour indiquer que l'objet ne sera renvoyé pour une vidéo que si les données de géolocalisation ou l'heure d'enregistrement de la vidéo ont été définies.

• La méthode playlistItems.update renvoie désormais une erreur invalidSnippet, qui est renvoyée si la requête API ne spécifie pas d'extrait valide.

• Plusieurs méthodes d'API sont compatibles avec de nouveaux paramètres destinés exclusivement aux partenaires de contenu YouTube. Les partenaires de contenu YouTube incluent des studios de cinéma et de télévision, des maisons de disques et d'autres créateurs de contenu qui mettent leurs contenus à disposition sur YouTube.

  • Le paramètre onBehalfOfContentOwner indique que les identifiants d'autorisation de la requête identifient un utilisateur du CMS YouTube qui agit au nom du propriétaire du contenu spécifié dans la valeur du paramètre. Le compte CMS avec lequel l'utilisateur s'authentifie doit être associé au propriétaire de contenu YouTube spécifié.

    Ce paramètre est destiné aux partenaires de contenu qui possèdent et gèrent de nombreuses chaînes YouTube différentes. Ce paramètre permet à ces partenaires de s'authentifier une seule fois et d'accéder à toutes leurs données vidéo et de chaîne, sans avoir à fournir d'identifiants d'authentification pour chaque chaîne.

    Les méthodes channels.list, search.list, videos.delete, videos.list et videos.update sont toutes compatibles avec ce paramètre.

  • Le paramètre managedByMe, qui est compatible avec la méthode channels.list, indique à l'API de renvoyer toutes les chaînes appartenant au propriétaire du contenu spécifié par le paramètre onBehalfOfContentOwner.

  • Le paramètre forContentOwner, qui est compatible avec la méthode search.list, indique à l'API de limiter les résultats de recherche aux ressources appartenant au propriétaire du contenu spécifié par le paramètre onBehalfOfContentOwner.

25 février 2013

Cette mise à jour inclut les changements suivants :

• L'API est compatible avec plusieurs nouvelles parties et propriétés pour les ressources video :

  • Les nouvelles sections fileDetails, processingDetails et suggestions fournissent des informations aux propriétaires de vidéos sur les vidéos qu'ils ont mises en ligne. Ces données sont très utiles dans les applications qui permettent d'importer des vidéos. Elles incluent les éléments suivants :

    • l'état et la progression du traitement ;
    • les erreurs ou autres problèmes rencontrés lors du traitement d'une vidéo.
    • Disponibilité des miniatures
    • des suggestions pour améliorer la qualité des vidéos ou des métadonnées.
    • des informations sur le fichier d'origine mis en ligne sur YouTube.

    Seul le propriétaire de la vidéo peut récupérer toutes ces parties. La liste ci-dessous décrit brièvement les nouvelles parties, et la documentation sur la ressource video définit toutes les propriétés que contient chaque partie.

    • L'objet fileDetails contient des informations sur le fichier vidéo importé sur YouTube, y compris la résolution, la durée, les codecs audio et vidéo, les débits binaires des flux, etc.

    • L'objet processingProgress contient des informations sur la progression de YouTube dans le traitement du fichier vidéo importé. Les propriétés de l'objet identifient l'état de traitement actuel et estiment le temps restant avant que YouTube ait terminé de traiter la vidéo. Cette section indique également si différents types de données ou de contenus, tels que les informations sur le fichier ou les miniatures, sont disponibles pour la vidéo.

      Cet objet est conçu pour être interrogé afin que l'utilisateur qui met en ligne la vidéo puisse suivre la progression de YouTube dans le traitement du fichier vidéo importé.

    • L'objet suggestions contient des suggestions qui identifient des opportunités d'améliorer la qualité vidéo ou les métadonnées de la vidéo importée.

  • La partie contentDetails contient quatre nouvelles propriétés. Ces propriétés peuvent être récupérées avec des requêtes non authentifiées.

    • dimension : indique si la vidéo est disponible en 2D ou en 3D.
    • definition : indique si la vidéo est disponible en définition standard ou haute définition.
    • caption : indique si des sous-titres sont disponibles pour la vidéo.
    • licensedContent : indique si la vidéo contient du contenu revendiqué par un partenaire de contenu YouTube.

  • La partie status contient deux nouvelles propriétés. Les propriétaires de vidéos peuvent définir des valeurs pour les deux propriétés lorsqu'ils insèrent ou mettent à jour une vidéo. Ces propriétés peuvent également être récupérées avec des requêtes non authentifiées.

    • embeddable : indique si la vidéo peut être intégrée sur un autre site Web.
    • license : spécifie la licence de la vidéo. Les valeurs valides sont creativeCommon et youtube.

• La définition du paramètre part a été mise à jour pour les méthodes videos.list, videos.insert et videos.update afin de lister les nouvelles pièces ajoutées décrites ci-dessus, ainsi que la pièce recordingDetails, qui avait été omise par inadvertance.

• La nouvelle propriété contentDetails.googlePlusUserId de la ressource channel spécifie l'ID de profil Google+ associé à la chaîne. Cette valeur peut être utilisée pour générer un lien vers le profil Google+.

• Chaque objet d'image miniature spécifie désormais la largeur et la hauteur de l'image. Les miniatures sont actuellement renvoyées dans les ressources activity, channel, playlist, playlistItem, search result, subscription et video.

• playlistItems.list est désormais compatible avec le paramètre videoId, qui peut être utilisé conjointement avec le paramètre playlistId pour ne récupérer que l'élément de playlist représentant la vidéo spécifiée.

  L'API renvoie une erreur notFound si la vidéo identifiée par le paramètre est introuvable dans la playlist.

• La documentation sur les erreurs décrit une nouvelle erreur forbidden, qui indique qu'une requête n'est pas correctement autorisée pour l'action demandée.

• La propriété snippet.channelId de la ressource channel a été supprimée. La propriété id de la ressource fournit la même valeur.

30 janvier 2013

Cette mise à jour inclut les changements suivants :

• La nouvelle page Erreurs répertorie les erreurs que l'API peut renvoyer. La page inclut des erreurs générales, qui peuvent se produire pour plusieurs méthodes d'API différentes, ainsi que des erreurs spécifiques à une méthode.

16 janvier 2013

Cette mise à jour inclut les changements suivants :

• Des exemples de code sont désormais disponibles pour les méthodes et les langages indiqués dans la liste ci-dessous :

  • activities.insert – Java
  • playlistItems.insert – Python
  • playlistItems.list : Java, JavaScript, PHP, Python, Ruby
  • playlists.insert : Java, JavaScript, Python
  • search.list : Java, JavaScript, Python, Ruby
  • videos.insert – Java

• Une ressource activity peut désormais signaler une action channelItem, qui se produit lorsque YouTube ajoute une vidéo à une chaîne YouTube générée automatiquement. (L'algorithme YouTube identifie les thèmes qui sont très présents sur le site Web YouTube et génère automatiquement des chaînes pour ces thèmes.)

• Les paramètres search.list suivants ont été modifiés :

  • Le paramètre q n'est plus désigné comme filtre, ce qui signifie que…
  • Le paramètre relatedToVideo a été renommé relatedToVideoId.
  • Le paramètre published a été remplacé par deux nouveaux paramètres, publishedAfter et publishedBefore, décrits ci-dessous.

• La méthode search.list accepte les nouveaux paramètres suivants :

  Nom du paramètre	Valeur	Description
  channelId	string	Renvoie les ressources créées par le canal spécifié.
  publishedAfter	datetime	Renvoie les ressources créées après l'heure spécifiée.
  publishedBefore	datetime	Renvoie les ressources créées avant l'heure spécifiée.
  regionCode	string	Renvoie les ressources pour le pays spécifié.
  videoCategoryId	string	Filtrer les résultats de recherche de vidéos pour n'inclure que les vidéos associées à la catégorie de vidéo spécifiée.
  videoEmbeddable	string	Filtrez les résultats de recherche de vidéos pour n'inclure que les vidéos pouvant être lues dans un lecteur intégré sur une page Web. Définissez la valeur du paramètre sur true pour ne récupérer que les vidéos intégrables.
  videoSyndicated	string	Filtrez les résultats de recherche de vidéos pour n'inclure que les vidéos pouvant être lues en dehors de YouTube.com. Définissez la valeur du paramètre sur true pour n'extraire que les vidéos syndiquées.

• Plusieurs ressources d'API sont compatibles avec de nouvelles propriétés. Le tableau ci-dessous identifie les ressources et leurs nouvelles propriétés :

  Ressource	Nom de propriété	Valeur	Description
  activity	contentDetails.playlistItem.playlistItemId	string	ID de l'élément de playlist attribué par YouTube pour identifier de manière unique l'élément dans la playlist.
  activity	contentDetails.channelItem	object	Objet contenant des informations sur une ressource ajoutée à une chaîne. Cette propriété n'est présente que si snippet.type est défini sur channelItem.
  activity	contentDetails.channelItem.resourceId	object	Objet qui identifie la ressource ajoutée à la chaîne. Comme les autres propriétés resourceId, elle contient une propriété kind qui spécifie le type de ressource, comme une vidéo ou une playlist. Il contient également exactement l'une des nombreuses propriétés (videoId, playlistId, etc.) qui spécifie l'ID identifiant de manière unique cette ressource.
  channel	status	object	Cet objet contient des informations sur l'état de confidentialité de la chaîne.
  channel	status.privacyStatus	string	État de confidentialité de la chaîne. Les valeurs valides sont private et public.
  playlist	contentDetails	object	Cet objet contient des métadonnées sur le contenu de la playlist.
  playlist	contentDetails.itemCount	unsigned integer	Nombre de vidéos dans la playlist.
  playlist	player	object	Cet objet contient les informations dont vous avez besoin pour lire la playlist dans un lecteur intégré.
  playlist	player.embedHtml	string	Balise <iframe> qui intègre un lecteur vidéo permettant de lire la playlist.
  video	recordingDetails	object	Cet objet contient des informations qui identifient ou décrivent le lieu et l'heure d'enregistrement de la vidéo.
  video	recordingDetails.location	object	Cet objet contient des informations de géolocalisation associées à la vidéo.
  video	recordingDetails.location.latitude	double	Latitude en degrés.
  video	recordingDetails.location.longitude	double	Longueur en degrés.
  video	recordingDetails.location.elevation	double	Altitude au-dessus de la Terre, en mètres.
  video	recordingDetails.locationDescription	string	Description textuelle du lieu où la vidéo a été enregistrée.
  video	recordingDetails.recordingDate	datetime	Date et heure auxquelles la vidéo a été enregistrée. La valeur est spécifiée au format ISO 8601 (YYYY-MM-DDThh:mm:ss.sZ).

• La documentation de plusieurs méthodes d'API identifie désormais les propriétés qui doivent être spécifiées dans le corps de la requête ou qui sont mises à jour en fonction des valeurs du corps de la requête. Le tableau ci-dessous liste ces méthodes ainsi que les propriétés requises ou modifiables.

  Remarque : La documentation d'autres méthodes peut déjà lister les propriétés requises et modifiables.

  Méthode	Propriétés
  activities.insert	Propriétés requises : snippet.description Propriétés modifiables : snippet.description contentDetails.bulletin.resourceId
  playlists.update	Propriétés requises : id
  playlistItems.update	Propriétés requises : id
  videos.update	Propriétés requises : id

• L'API ne renvoie plus d'erreur playlistAlreadyExists si vous essayez de créer ou de modifier une playlist qui aurait le même titre qu'une playlist déjà existante dans la même chaîne.

• Plusieurs méthodes d'API sont compatibles avec de nouveaux types d'erreurs. Le tableau ci-dessous identifie la méthode et les nouvelles erreurs acceptées :

  Méthode	Type d'erreur	Détails de l'erreur	Description
  guideCategories.list	notFound	notFound	La catégorie de guide identifiée par le paramètre id est introuvable. Utilisez la méthode guideCategories.list pour récupérer la liste des valeurs valides.
  playlistItems.delete	forbidden	playlistItemsNotAccessible	La demande n'est pas correctement autorisée à supprimer l'élément de playlist spécifié.
  videoCategories.list	notFound	videoCategoryNotFound	La catégorie de vidéo identifiée par le paramètre id est introuvable. Utilisez la méthode videoCategories.list pour récupérer la liste des valeurs valides.