Historique des révisions

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

22 août 2022

Correction des annotations de type pour les champs video.statistics de façon à créer une chaîne de caractères sans caractères longs.

5 août 2022

YouTube a changé 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. Il peut s'agir d'une modification incompatible avec les versions antérieures pour les applications qui stockent des valeurs caption_id, bien qu'elle n'affecte 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, à partir du 1er décembre 2022, YouTube n'acceptera plus 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 entraînera une erreur captionNotFound.

Pour vous préparer à ce changement, nous vous conseillons de remplacer toutes les données des pistes de sous-titres stockées d'ici le 1er décembre 2022. Par conséquent, vous devez supprimer les données actuellement stockées pour toute vidéo pour laquelle vous stockez des données de piste de sous-titres, puis appeler la méthode captions.list afin de récupérer l'ensemble actuel de pistes de sous-titres pour la vidéo et stocker les données dans la réponse de l'API, comme vous le faites habituellement.

12 juillet 2022

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

27 avril 2022

La description de la méthode videos.insert a été mise à jour pour indiquer que la taille de fichier maximale des vidéos mises en ligne 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 toutes deux été mises à jour pour indiquer que le nombre maximal d'abonnés renvoyé par l'API peut être limité. Cette modification constitue une correction de la documentation et non un changement du comportement de l'API.

15 décembre 2021

Comme annoncé le 18 novembre 2021, en plus des modifications visant à rendre privées le nombre 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

Parallèlement à la modification du paramètre permettant de rendre le nombre de "Je n'aime pas" privé sur l'ensemble de la plate-forme YouTube, la propriété statistics.dislikeCount de la ressource video deviendra privée à partir du 13 décembre 2021. Cela signifie que la propriété ne sera incluse dans une réponse d'API à partir du point de terminaison videos.list que si la requête API a été authentifiée par le propriétaire de la vidéo.

Le point de terminaison videos.rate n'est pas concerné par cette modification.

Les développeurs qui n'affichent pas publiquement le nombre de "Je n'aime pas" et qui ont encore besoin du nombre de "Je n'aime pas" pour leur client API peuvent demander à figurer sur une liste d'autorisation en vue d'une exception. Pour demander une exemption, vous devez remplir ce formulaire.

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 est obsolète et n'est plus compatible. Cette fonctionnalité de duplication des points de terminaison est disponible via d'autres points de terminaison de l'API. À la place, vous pouvez 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 effectuer un audit de conformité de l'API pour pouvoir dépasser le quota par défaut de 10 000 unités. À ce jour, le processus d'audit de conformité et les demandes d'allocations de quotas supplémentaires ont été effectués par les développeurs qui remplissent et envoient le formulaire sur les services d'API YouTube – Audit et augmentation des quotas.

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 de développeur pour un audit: les développeurs qui ont déjà passé un audit de conformité de l'API peuvent remplir et envoyer ce formulaire plus court pour demander une extension de quota allouée.
• Formulaire d'appel : les développeurs dont les projets d'API ont échoué à un audit de conformité (ou qui ont reçu une augmentation de leur quota) peuvent remplir et envoyer ce formulaire.
• Formulaire de changement de contrôle: les développeurs ou toute autre personne gérant un client API pour le compte d'un développeur et en cas de changement de contrôle (par exemple, via un achat ou une vente d'actions, une fusion ou toute autre forme de transaction d'entreprise) associée à un projet d'API doivent remplir et envoyer ce formulaire. Cela permet à l'équipe API YouTube de mettre à jour nos enregistrements, de vérifier la conformité des cas d'utilisation du nouveau projet d'API et de valider l'allocation de quotas actuelle du développeur.

Chaque nouveau formulaire nous informera de votre utilisation 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 concerne les modifications d'API suivantes:

• La propriété contentDetails.relatedPlaylists.favorites de la ressource channel a été abandonnée. La fonctionnalité de favoris est obsolète depuis 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 nouvelle playlist si un client API tentait d'ajouter une vidéo à une playlist inexistante. Dans ce cas, la playlist ne sera pas créée et l'API renverra une erreur. Les tentatives de modification des playlists favorites par l'ajout, la modification ou la suppression d'éléments sont également obsolètes conformément aux annonces précédentes et peuvent commencer à renvoyer des erreurs à tout moment.

• Les propriétés de ressources channel suivantes ont été abandonnées. Ces propriétés ne sont pas acceptées dans l'interface utilisateur de YouTube Studio ni sur YouTube. Par conséquent, ils ne sont plus compatibles avec 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 ressource channel et leurs définitions ont été supprimées de la liste de 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 ressources channelSection suivantes ont été abandonnées. Ces propriétés ne sont pas acceptées dans l'interface utilisateur de YouTube Studio ni sur YouTube. Par conséquent, ils ne sont plus compatibles avec l'API.

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

  Parallèlement à cette modification, le paramètre hl de la méthode channelSection.list est également obsolète, car les fonctionnalités qu'il accepte ne sont pas compatibles.

  Toutes les propriétés ont été supprimées de la représentation de ressource channelSection et leurs définitions ont été supprimées de la liste de 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 pas acceptées sur les pages de chaînes 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 a été abandonnée. Cette propriété n'est pas compatible avec YouTube. Par conséquent, elle n'est plus acceptée 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 playlist.
• La propriété snippet.videoOwnerChannelTitle indique le nom de la chaîne qui a mis en ligne 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. L'erreur se produit lorsqu'une requête tente d'effectuer une opération qui n'est pas autorisée pour une playlist particulière. Par exemple, un utilisateur ne peut pas supprimer une vidéo de sa playlist de vidéos mises en ligne 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 des utilisateurs et les listes "À regarder plus tard" ne soient pas accessibles via l'API, ces erreurs ne sont pas renvoyées par l'API.

15 octobre 2020

Deux nouvelles sections ont été ajoutées au Règlement pour les 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 intégré YouTube. Vous êtes responsable des données utilisateur que vous nous envoyez via un lecteur intégré YouTube avant qu'il n'interagisse avec le lecteur afin d'indiquer l'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 s'applique à la vérification de l'état du contenu conçu pour les enfants avant d'être intégré à vos sites et applications. Vous êtes tenu de savoir si les vidéos que vous intégrez à votre client API sont conçues pour les enfants et de traiter les données collectées depuis le lecteur intégré en conséquence. Vous devez donc vérifier l'état du contenu à l'aide du service d'API YouTube Data avant de l'intégrer à votre Client API via un lecteur intégré à YouTube.

Le nouveau guide Trouver l'état MadeForKids d'une vidéo explique comment rechercher l'état du contenu conçu pour les enfants à l'aide du service d'API YouTube Data.

Parallèlement à 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 aura lieu sans interaction de l'utilisateur avec le lecteur. La collecte et le partage des données de lecture se produiront donc une fois la page chargée.

8 octobre 2020

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

• L'objet snippet.thumbnails, qui identifie les images miniatures d'un canal, peut être vide pour les nouveaux canaux créés et mettre jusqu'à un jour à s'afficher.
• La propriété statistics.videoCount indique uniquement le nombre de vidéos publiques de la chaîne, même pour les propriétaires. Ce comportement est cohérent avec les chiffres affichés sur le site Web YouTube.
• Les mots clés de la chaîne, qui sont 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 sans échappement ("). Notez que la limite de 500 caractères n'est pas une limite par mot clé, mais une limite sur la longueur totale de tous les mots clés. Ce comportement est cohérent avec celui du site Web YouTube.

9 septembre 2020

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

Cette mise à jour concerne les modifications d'API suivantes. Toutes les modifications entreront en vigueur le 9 septembre 2020, ou après cette date. Ainsi, les développeurs ne doivent plus avoir recours aux fonctionnalités d'API répertoriées ci-dessous.

• Les ressources, méthodes, paramètres et propriétés de ressources de l'API suivants sont immédiatement obsolètes et cesseront de fonctionner à compter de la date de cette annonce :
  • Les propriétés de ressources channel suivantes :
    • La propriété statistics.commentCount
    • L'objet brandingSettings.image et toutes ses propriétés enfants
    • Liste brandingSettings.hints et toutes ses propriétés enfants
  • Paramètre de filtre categoryId de la méthode channels.list
  • La ressource guideCategories et la 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 et n'affecte pas la propriété nextPageToken pour les requêtes.
• Les propriétés contentDetails.relatedPlaylists.watchLater et contentDetails.relatedPlaylists.watchHistory de la ressource channel ont toutes deux é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 désormais complètement obsolète, et les deux propriétés ont été supprimées de la documentation.
• Le paramètre mySubscribers de la méthode channels.list, annoncé comme obsolète 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 le coût supplémentaire associé au paramètre part. Avec effet immédiat, nous ne facturerons que le coût de base pour la méthode appelée. Pour en savoir plus sur le quota simplifié, cliquez ici.

Suite à ce changement, le coût de la plupart des appels d'API sera légèrement inférieur au quota, tandis que le coût de certains appels d'API sera identique. Ce changement n'augmente pas le coût des appels d'API. Globalement, il est probable que votre quota alloué, disponible dans Google Cloud Console, atteigne un peu plus.

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

Cette entrée dans 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 en mode de visionnage privé. Pour lever cette restriction, chaque projet doit faire l'objet d'un audit afin de vérifier la conformité aux Conditions d'utilisation.

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

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

21 juillet 2020

[Mise à jour : 28 juillet 2020] La mise à jour de la documentation référencé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 calcul du quota. Cependant, en raison de circonstances imprévues, la modification du quota n'est pas encore en vigueur. Par conséquent, pour des raisons de précision, la documentation a été rétablie. Pour éviter toute confusion, l'entrée d'historique des révisions expliquant la modification a été supprimée et sera de nouveau publiée dans un avenir proche.

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, et tous deux ont été supprimés de la documentation. Leurs valeurs sont ignorées et n'affectent pas le traitement des nouvelles vidéos mises en ligne.

15 juin 2020

Le nouveau guide Se conformer au règlement pour les développeurs YouTube fournit des conseils et des exemples qui vous aideront à vous assurer que vos clients API respectent certaines sections des Conditions d'utilisation et des Règles des services d'API YouTube.

Ces conseils offrent des informations sur la façon dont YouTube applique certains aspects des conditions d'utilisation de l'API, mais ne remplacent pas les documents existants. Ce guide répond à certaines des questions les plus fréquemment posées par les développeurs lors des audits de conformité des API. Nous espérons qu'il simplifiera le processus de développement de 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 est désormais complètement obsolète. Ce changement a été initialement annoncé le 17 avril 2020 et est maintenant appliqué. Par conséquent, la méthode activities.insert n'est plus compatible et la méthode activities.list ne renvoie plus de bulletins de canal. 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 des bulletins de chaîne. Ces modifications entreront en vigueur dans l'API à compter du 18 mai 2020. 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 fournit 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.

    Cette ressource remplace la ressource sponsor, qui est documentée dans le cadre de l'API YouTube Live Streaming. La ressource sponsor est désormais obsolète, et les clients API doivent mettre à jour les appels à la méthode sponsors.list pour qu'ils utilisent désormais la méthode members.list.

  • La nouvelle ressource membershipsLevel identifie un niveau de tarification géré par le créateur qui a autorisé la requête API. La méthode membershipsLevels.list permet de récupérer la liste de tous les niveaux d'appartenance du créateur.

10 janvier 2020

L'API est désormais compatible avec l'identification des contenus destinés aux enfants, désignés par YouTube comme "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 permettant aux créateurs et aux spectateurs d'identifier les contenus conçus pour les enfants:

• La propriété selfDeclaredMadeForKids permet aux créateurs de contenu de spécifier si une 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çue 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. Consultez le Centre d'aide YouTube pour savoir comment définir l'audience de votre chaîne, de vos vidéos ou de vos diffusions.

Nous avons également mis à jour les conditions d'utilisation des services d'API YouTube et le règlement pour les développeurs. Pour en savoir plus, consultez les Conditions d'utilisation des services d'API YouTube et l'historique des révisions. Les modifications apportées aux conditions d'utilisation des services d'API YouTube et au règlement pour les développeurs entreront en vigueur 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 la modification de la façon dont les nombres d'abonnés sont indiqués sur YouTube et, par conséquent, dans les réponses de l'API. Suite à ce changement, le nombre d'abonnés renvoyé par le service d'API YouTube Data est arrondi à 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 : Cette modification affecte la valeur de cette propriété, même lorsqu'un utilisateur envoie une requête autorisée pour obtenir des données sur son propre canal. Les propriétaires de chaîne 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 contient la valeur 123000. Le tableau ci-dessous montre comment le nombre d'abonnés est arrondi dans les réponses de l'API et abrégé dans d'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é via le widget APIs Explorer. Consultez la documentation de la méthode channels.list pour voir un exemple. Nous avons ajouté deux nouveaux éléments sur les pages qui décrivent les méthodes d'API:

  • Le widget APIs Explorer vous permet de sélectionner des champs d'application des autorisations, de saisir des exemples de valeurs de paramètre et de propriété, puis d'envoyer des requêtes API réelles et de voir les réponses réelles de l'API. Le widget propose également un affichage plein écran qui affiche des exemples complets de code, qui sont mis à jour de manière dynamique pour utiliser les champs d'application et les valeurs que vous avez saisis.

  • La section Cas d'utilisation courants décrit un ou plusieurs cas d'utilisation courants pour 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 un canal spécifique ou pour obtenir des données sur le canal de l'utilisateur actuel.

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

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

• L'outil de exemples de code a également été mis à jour avec une nouvelle interface utilisateur offrant 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 APIs Explorer et d'ouvrir l'explorateur d'API en plein écran pour obtenir des exemples de code en Java, JavaScript, PHP et Python.

  Parallèlement à cette modification, les pages qui contenaient auparavant des 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 lorsque vous affichez des vignettes dans votre application, votre code doit utiliser les URL d'image 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 de miniatures de chaînes ne seront disponibles que dans le domaine https. Les URL s'afficheront ainsi dans les réponses de l'API. Passé ce délai, vous verrez peut-être des images endommagées 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 a été abandonnée. Rien ne garantit que les vidéos renverront des valeurs pour cette propriété. De 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 guide d'implémentation et de migration) a été mis à jour pour supprimer les instructions concernant la migration de l'API v2 vers l'API v3. En outre, des instructions ont été supprimées pour les fonctionnalités qui ne sont plus disponibles dans la version 3 de l'API, telles que les vidéos préférées.

27 novembre 2017

Cette mise à jour inclut les changements suivants :

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

  Les fonctionnalités Sélection vidéo et Sélection de sites Web ne seront plus acceptées dans l'API via l'objet invideoPromotion de la ressource channel. Par conséquent, cet objet, y compris toutes ses propriétés enfants, va être abandonné.

  Vous pouvez 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 renvoient un invideoPromotion vide ou ne renvoient aucune donnée invideoPromotion.
  • Les tentatives de mise à jour des données invideoPromotion lors de l'appel de channels.update renverront une réponse réussie jusqu'au 27 mai 2018 au moins. En revanche, elles seront considérées comme des opérations no-ops, ce qui signifie qu'elles n'effectueront pas de mise à jour.

  Après le 27 mai 2018, il est possible que ces requêtes renvoient des messages d'erreur pour indiquer, par exemple, que invalidPromotion n'est pas une pièce 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 pour presque toutes les méthodes d'API, telles que 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 pour Node.js. Toutefois, les exemples contiennent des fonctions utilitaires qui ne figurent pas dans le guide de démarrage rapide:

  • La fonction removeEmptyParameters utilise une liste de paires clé/valeur correspondant aux paramètres de requête de l'API et supprime les paramètres qui n'ont pas de valeurs.
  • La fonction createResource utilise une liste de paires clé/valeur correspondant aux propriétés d'une ressource API. Il convertit ensuite les propriétés en un objet JSON qui peut être utilisé dans les opérations insert et update. L'exemple ci-dessous présente un ensemble de noms et de valeurs de propriété, ainsi que l'objet JSON que le code doit créer 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 conditions préalables à l'exécution locale d'exemples de code complets dans les instructions de l'outil d'extrait de code.

25 octobre 2017

Cette mise à jour inclut les changements suivants :

• Les exemples de code Python dans l'outil d'extrait de code interactif 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 cette modification, 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 les exemples complets (et ce changement):

  1. Accédez à l'outil d'extrait de code interactif ou à la documentation de n'importe quelle méthode d'API, telle que 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 extrait complet.
     
  4. L'onglet devrait maintenant afficher un exemple de code complet utilisant le flux d'autorisation InstalledAppFlow. La description au-dessus de l'exemple explique cela et contient également un lien vers un exemple pour une 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 relatives à l'exécution locale complète d'exemples de code dans les instructions de l'outil Extrait 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 afin de préciser que les résultats de recherche sont limités aux vidéos pouvant être regardées dans la région spécifiée.
• YouTube a mis à jour ses logos et icônes de branding. Vous pouvez télécharger les nouveaux logos "développés avec YouTube" sur la page Consignes relatives à la marque. D'autres nouveaux logos et icônes YouTube sont également affichés sur cette page. Vous pouvez les télécharger sur le site de la marque YouTube.

24 juillet 2017

Cette mise à jour inclut les changements suivants :

• Un nouveau guide de démarrage rapide sur 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 Swift.
• L'outil d'extrait de code interactif de l'API YouTube Data inclut désormais de la documentation expliquant certaines de ses fonctionnalités :
  • Exécuter des requêtes API
  • Basculer entre des extraits de code et des exemples de code complet
  • Utiliser des fonctions passe-partout
  • Chargement des ressources existantes (pour les méthodes de mise à jour)

  Remarque:Cet outil est également intégré à la documentation de référence de l'API pour 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 ressources video suivantes vont être abandonnées. Les propriétés seront acceptées jusqu'au 1er décembre 2017, mais il n'y a aucune garantie 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èrent 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 plus interactifs. Les pages qui décrivent les méthodes d'API, comme channels.list ou videos.rate, proposent maintenant 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, chacun décrivant 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 un canal spécifique ou sur le canal de l'utilisateur actuel.

  Vous pouvez également interagir avec les exemples de code:

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

  • Basculez entre les extraits de code et les exemples complets. Un extrait de code affiche la partie du code qui appelle la méthode API. Un extrait complet contient cet extrait, ainsi qu'un code récurrent pour autoriser et envoyer des requêtes. Vous pouvez copier et exécuter des exemples complets à partir de la ligne de commande ou d'un serveur Web local.

  • Exécutez des 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é l'explorateur d'API 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 offrant toutes les fonctionnalités décrites ci-dessus. Les principales nouvelles fonctionnalités disponibles sur cette page sont les suivantes:

  • Compatibilité avec les requêtes API qui écrivent des données.
  • Compatibilité avec les exemples Java.
  • Un code récurrent plus flexible et plus 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 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 des sujets renvoyés dans la propriété topicDetails.topicIds[] de la ressource.
• La nouvelle propriété contentDetails.videoPublishedAt de la ressource playlistItem identifie l'heure de publication de la vidéo sur YouTube. La ressource contient déjà la propriété snippet.publishedAt, qui identifie le moment où 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 des 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 que la Motion Picture Association of America a attribuée à la bande-annonce ou à l'aperçu d'un film.

27 février 2017

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

Notez que la liste organisée a subi plusieurs modifications:

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

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

• Le sujet Animated cartoon, qui était auparavant un enfant de Entertainment, a été supprimé.
• Le sujet Children's music, qui était auparavant un enfant de Music, a été supprimé.

En raison de ce changement, les sujets liés à une vidéo sont désormais toujours affichés dans la valeur de la propriété topicDetails.relevantTopicIds[] de la ressource video.

29 novembre 2016

Cette mise à jour inclut les changements suivants :

• Voici les trois modifications mineures apportées à la liste des ID de thèmes qui seront compatibles à compter 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 un enfant de Lifestyle, a été supprimée.

  Sachez également qu'il existe quelques catégories parentes (Entertainment, Gaming, Lifestyle, Music et Sports). Toutes les vidéos associées à une catégorie enfant, comme Tennis, seront également associées à la catégorie parent (Sports).

10 novembre 2016

Cette mise à jour inclut les changements suivants :

• Comme annoncé le 11 août 2016, l'abandon de Freebase et de l'API Freebase nécessite plusieurs modifications liées aux ID des sujets. Les ID de sujet identifient les sujets associés aux ressources channel et video. Vous pouvez également utiliser le paramètre de recherche topicId pour rechercher des chaînes ou des vidéos associées à un sujet particulier.

  Le 10 février 2017, YouTube commencera à renvoyer un petit ensemble d'ID de thèmes au lieu du nombre d'ID beaucoup plus précis renvoyé jusqu'à présent. De plus, il n'est pas garanti que les chaînes et les vidéos soient associées à des sujets, ce qui est conforme au comportement actuel de l'API.

  Pour que vous puissiez préparer vos clients API à ces modifications, les définitions des paramètres et propriétés d'API suivants ont été mises à jour afin de dresser la liste des ID de thèmes compatibles après cette date. Notez que la liste des catégories est la même pour toutes les propriétés.

  • La propriété topicDetails.topicIds[] de la ressource channel.
  • La propriété topicDetails.relevantTopicIds[] de la ressource video.
  • Le paramètre topicId de la méthode search.list.

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

  Les propriétés suivantes vont être abandonnées:

  • La propriété topicDetails.topicIds[] de la ressource channel. Cette propriété sera acceptée jusqu'au 10 novembre 2017.
  • La propriété topicDetails.relevantTopicIds[] de la ressource video. Cette propriété sera acceptée jusqu'au 10 novembre 2017.
  • La 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 sujets associés à une vidéo.)

• Freebase étant déjà obsolète, le guide Searching with Freebase Topics a été supprimé de la documentation. Ce guide fournit des exemples de code illustrant le fonctionnement d'une application avec l'API Freebase.

  En outre, plusieurs exemples de code liés aux ID de sujet 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 un tag <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. Sachez que cette propriété n'est visible que par l'utilisateur ayant mis en ligne la vidéo.

    • La nouvelle fpbRatingReasons[] identifie les raisons pour lesquelles la vidéo a été classée FPB (Afrique du Sud).

    • La nouvelle propriété mcstRating identifie la classification de la vidéo au Nam.

  • La méthode videos.list accepte deux nouveaux paramètres, maxHeight et maxWidth. Vous pouvez utiliser l'un des paramètres, ou les deux, lors de la récupération de la partie player dans les ressources video.

    Par défaut, la hauteur du <iframe> renvoyé dans la propriété player.embedHtml est de 360 px. La largeur s'ajuste au format de la vidéo, de sorte que le lecteur intégré ne comporte pas de barres noires encadrant la vidéo. Par exemple, si le format d'une vidéo est 16:9, la largeur du lecteur serait de 640 pixels.

    Avec les nouveaux paramètres, vous pouvez indiquer qu'au lieu des dimensions par défaut, le code d'intégration doit utiliser une hauteur et/ou une largeur adaptées à la mise en page de votre application. Le serveur d'API met les dimensions du lecteur à l'échelle en conséquence, de sorte que le lecteur intégré ne comporte pas de barres noires encadrant 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 encore inférieure au maximum autorisé pour cette dimension.

    Par exemple, supposons qu'une vidéo soit au format 16:9. Ainsi, la balise player.embedHtml contiendra un lecteur de 640 x 360 pixels si le paramètre maxHeight ou maxWidth n'est pas défini.

    • 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 de 960 x 540 pixels.
    • Si le paramètre maxWidth est défini sur 960 et que le paramètre maxHeight est défini sur 450, l'API affiche un lecteur 800x450.

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

• Mises à jour des méthodes, propriétés et paramètres existants

  • La description de la ressource channelSection a été mise à jour pour indiquer qu'un canal peut créer un maximum de 10 étagères sans définir de données de ciblage et qu'il est possible de créer un maximum de 100 étagères avec des données de ciblage.

    En outre, 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'avec l'API. Les options de ciblage sont supprimées si vous modifiez la section de la chaîne via l'interface utilisateur du 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 telle qu'elle est écrite 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 valeur 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 ont été abandonnées. Ces champs sont ignorés s'ils sont définis dans des requêtes playlistItems.insert ou playlistItems.update.

  • Les méthodes playlistItems.delete et playlistItems.update acceptent désormais le paramètre onBehalfOfContentOwner, qui est déjà compatible avec plusieurs autres méthodes. Les requêtes qui utilisent cette méthode doivent également être autorisées avec un jeton permettant d'accéder 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 inclusives. Ainsi, 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 de fichier maximale des vidéos mises en ligne est passée de 64 Go à 128 Go.

• Erreurs nouvelles et mises à jour

  • L'API accepte 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 avez défini 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 est due au fait que 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 qu'ils 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 qu'ils 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 le nombre de vidéos qu'elle peut mettre en ligne a été dépassé.
    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. Sachez 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. Auparavant, cette erreur s'est produite pour certaines playlists, comme les vidéos préférées, qui n'acceptaient pas les doublons, mais ne sont plus compatibles. En général, les playlists autorisent les vidéos en double.

• Autres mises à jour

  • L'entrée de l'historique des révisions du 15 septembre 2016 a été mise à jour afin de préciser que, lorsque 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 traitait de plusieurs modifications liées aux ID de sujet, y compris le changement de l'ensemble d'ID de thèmes compatibles depuis le 10 février 2017. La liste des thèmes compatibles sera publiée d'ici le 10 novembre 2016.

• Les modifications suivantes sont maintenant en vigueur. Ces modifications ont été annoncées dans la mise à jour de l'historique des révisions du 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 à ce qu'un utilisateur YouTube déconnecté verrait sur la page d'accueil.

    Cette modification 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 renvoyaient 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 tous les canaux.

    Pour rappel, ces propriétés ne sont visibles que par un utilisateur autorisé qui récupère des données sur sa propre chaîne. 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, l'historique des vidéos regardées et les ID des playlists "À regarder plus tard" ne peuvent pas être récupérés via l'API.

    En outre, les demandes d'informations sur les playlists (playlists.list) ou les éléments de playlist (playlistItems.list) pour l'historique des vidéos regardées d'une chaîne ou la playlist "À regarder plus tard" renvoient désormais des listes vides. Ce comportement s'applique aux nouvelles valeurs (HL et WL), ainsi qu'à l'historique des vidéos regardées ou aux ID de playlist des vidéos à 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 affiché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 ("Conditions mises à jour"), détaillées en détail sur le blog des ingénieurs et développeurs YouTube, contiennent de nombreuses mises à jour des conditions d'utilisation actuelles. En plus des Conditions mises à jour, qui entreront en vigueur le 10 février 2017, cette mise à jour inclut plusieurs documents justificatifs pour aider les développeurs à comprendre les règles que les développeurs doivent respecter.

  L'ensemble complet de nouveaux documents est décrit dans l'historique des révisions des conditions d'utilisation mises à jour. De plus, toute modification future apportée aux Conditions mises à jour ou aux documents justificatifs sera également expliquée dans l'historique des révisions. Vous pouvez vous abonner aux modifications apportées à un flux RSS depuis cet historique des révisions à partir d'un lien dans ce document.

• L'abandon de Freebase et de l'API Freebase entraîne plusieurs modifications liées aux ID des sujets. Les ID de sujet sont utilisés dans les ressources et les méthodes d'API suivantes:

  • La partie topicDetails de la ressource channel identifie les sujets associés à la chaîne.
  • La partie topicDetails de la ressource video identifie les sujets 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 associées à un thème spécifique.

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

  • À compter du 10 février 2017, YouTube commencera à renvoyer un petit ensemble d'ID de thèmes au lieu du nombre d'ID beaucoup plus précis renvoyé jusqu'à présent. Cet ensemble de thèmes pris en charge identifie les catégories de haut niveau comme Sports ou Basket-ball, mais n'identifie pas des équipes ou des joueurs spécifiques, par exemple. Afin de vous laisser le temps de préparer votre demande pour ce changement, nous allons annoncer différents thèmes pris en charge.

  • N'importe quel ID de sujet Freebase déjà récupéré peut être utilisé pour rechercher du contenu jusqu'au 10 février 2017. Toutefois, après ce délai, vous ne pourrez utiliser que le plus petit ensemble de sujets identifiés dans l'élément précédent pour récupérer les résultats de recherche par sujet.

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

• Plusieurs champs et paramètres d'API seront abandonnés à compter du 12 septembre 2016:

  • Le paramètre home de la méthode activities.list a permis à un utilisateur autorisé de récupérer le flux d'activité qui s'afficherait sur la page d'accueil YouTube de cet utilisateur. Les requêtes qui utilisent ce paramètre après le 12 septembre 2016 afficheront 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 sa propre chaîne. Après le 12 septembre 2016, la valeur de contentDetails.relatedPlaylists.watchHistory sera HL, et la propriété contentDetails.relatedPlaylists.watchLater renverra la valeur de WL pour toutes les chaînes.

    Les demandes de récupération des informations sur les playlists (playlists.list) pour l'historique des vidéos regardées ou la playlist "À regarder plus tard" afficheront une liste vide à partir du 12 septembre 2016. Les demandes de récupération d'éléments de playlist (playlistItems.list) dans l'une de ces playlists renvoient également une liste vide après cette période. Cela est valable pour les nouvelles valeurs (HL et WL), ainsi que pour l'historique des vidéos regardées ou l'ID des playlists de la playlist "À regarder plus tard" que votre client API ait 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. Ces données ne peuvent être récupérées que par le propriétaire de la vidéo, car l'objet fileDetails parent ne peut être récupéré que par le propriétaire de la vidéo.

13 juin 2016

Cette mise à jour inclut les changements suivants :

• La propriété contentDetails.googlePlusUserId de la ressource channel a été abandonnée. Auparavant, la propriété n'était présente que si la chaîne était associée à un profil Google+. Après l'abandon, la propriété ne sera plus incluse dans aucune ressource channel.

• La propriété snippet.authorGoogleplusProfileUrl de la ressource comment a été abandonnée. Auparavant, la propriété n'était présente que si la chaîne était associée à un profil Google+. Après l'abandon, la propriété ne sera plus incluse dans aucune ressource comment.

Comme aucune de ces propriétés ne sera renvoyée après l'abandon, les deux propriétés ont été supprimées de la documentation correspondante sur les ressources.

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é, dans l'ordre chronologique inverse de l'heure à laquelle il s'y est abonné.

  Notez que le nouveau paramètre permet uniquement de récupérer les 1 000 abonnés les plus récents sur la chaîne de l'utilisateur authentifié. Pour obtenir la liste complète des abonnés, utilisez le paramètre mySubscribers. Ce paramètre, qui ne renvoie pas d'abonnés dans un certain ordre, 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. Notez que d'autres tailles d'images miniatures sont disponibles pour certaines vidéos.

  • L'image standard mesure 640 pixels de large sur 480 pixels de haut.
  • L'image maxres mesure 1 280 pixels de large sur 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. Les 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, elle fournit cinq extraits de code pour la méthode search.list:

• Répertorier les vidéos par mot clé
• Lister les vidéos par emplacement
• Répertorier les événements en direct
• Rechercher les vidéos de l'utilisateur authentifié
• Répertorier 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, auquel cas l'outil met à jour les extraits de code pour refléter les valeurs de 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 requête, la réponse de l'API est basée sur les valeurs de paramètres que vous avez fournies. Notez que vous devez autoriser l'outil à envoyer des demandes 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 valides pour la propriété sont 360 et rectangular.

• Les propriétés recordingDetails.location et fileDetails.recordingLocation de la ressource video ont toutes deux é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 peut être modifié et inclus dans l'index de recherche des vidéos publiques. Il est possible que les utilisateurs voient ces vidéos.
  • La valeur de la propriété fileDetails.recordingLocation est immuable et représente l'emplacement associé au fichier vidéo importé d'origine. 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 faisant référence à une playlist vide et qui ne peut pas être récupérée. Cela s'explique par le fait que la fonctionnalité de vidéos préférées a déjà été abandonnée. Notez que cette propriété n'est pas soumise au règlement relatif aux abandons des API.

• La définition de l'erreur ineligibleAccount, qui peut être renvoyée par la méthode 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, qui contient votre quota et votre utilisation réels.

16 mars 2016

Cette mise à jour inclut les changements suivants :

• Mises à jour des ressources et méthodes existantes

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

  • La nouvelle propriété snippet.customUrl de la ressource channel identifie l'URL personnalisée associée au canal. Toutes les chaînes ne disposent pas d'une URL personnalisée. Consultez le Centre d'aide YouTube pour en savoir plus sur les critères d'éligibilité à l'obtention d'une URL personnalisée et pour savoir comment configurer cette URL.

  • L'objet brandingSettings.watch de la ressource channel et toutes ses propriétés enfants sont obsolètes.

  • 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 de région indique à l'API de renvoyer les résultats de recherche pour le pays spécifié.

    La valeur de la propriété est un code de pays ISO à deux lettres qui identifie la région. La méthode i18nRegions.list renvoie une liste des régions disponibles. La valeur par défaut est US. Si une région non acceptée est spécifiée, il est possible que YouTube en sélectionne une autre, plutôt que la valeur par défaut, pour gérer 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 un texte de libellé localisé pour les raisons de signalement d'abus.

    En outre, la méthode videoAbuseReportReasons.list est désormais compatible avec le paramètre hl, qui spécifie la langue à utiliser pour le texte du libellé 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 auprès du comité d'évaluation et de classification du ministère de la Culture et du Tourisme en Turquie.

    En outre, les propriétés d'API des 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)
      Note: R-15 ; Valeur de la propriété : moctwR15

  • La propriété liveStreamingDetails.activeLiveChatId de la ressource video contient l'ID du chat en direct actif associé à la vidéo. La valeur de la propriété n'est présente que si la vidéo est une diffusion en direct pour laquelle le chat en direct est activé. Une fois la diffusion terminée et le chat en direct terminé, 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 accepte 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 canal spécifiée ne peut pas être créée, mise à jour ou 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 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 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 réussi à traiter la requête. Bien qu'il s'agisse d'une erreur temporaire, cela 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 des commentaires ont été désactivés sur 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 réessayer d'envoyer la requête quelques heures plus tard.
  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 planifié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 détails 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 aucune valeur pour les propriétés snippet.title et snippet.categoryId.

18 décembre 2015

Les lois de l'Union européenne (UE) imposent la divulgation de certaines informations et le consentement des utilisateurs finaux dans l'UE. Par conséquent, vous devez respecter les Règles relatives au consentement de l'utilisateur dans l'UE pour les utilisateurs finaux de l'Union européenne. Nous avons ajouté une notification concernant cette exigence dans les 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 descriptions et des titres 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é correspond à un objet contenant le titre (et la description) localisés pour la ressource.

    L'exemple d'extrait ci-dessous définit l'anglais comme langue par défaut de la ressource. Elle ajoute également des descriptions et des titres 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 des données. Par exemple, si vous avez envoyé une demande d'ajout de données en portugais à la vidéo de l'exemple ci-dessus, la requête doit inclure les données localisées pour l'allemand, l'espagnol et le portugais.

• Récupérer des valeurs localisées

  L'API permet de récupérer les valeurs localisées d'une ressource de deux façons:

  • Ajoutez le paramètre hl à votre requête channels.list, channelSections.list, playlists.list ou videos.list afin de récupérer les données localisées pour une langue d'application spécifique compatible avec le site Web YouTube. Si des détails de ressource localisés sont disponibles, l'objet snippet.localized de la ressource contiendra les valeurs localisées. Toutefois, si les détails localisés ne sont pas disponibles, l'objet snippet.localized contient les détails de 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 est défini sur de, la ressource contiendra 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 est défini sur fr, l'objet snippet.localized contient le titre et la description en anglais, car l'anglais est la langue par défaut de la ressource, et les informations en français localisées ne sont pas disponibles.

    Important:Le paramètre hl n'accepte que les valeurs qui identifient les langues d'application acceptées par le site Web YouTube. Pour savoir si le texte localisé est disponible pour 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 devez récupérer la liste complète des localisations pour déterminer si le 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 la langue actuelle de l'application YouTube, vous devez utiliser cette approche pour récupérer toutes les localisations, puis filtrer pour déterminer si les données localisées souhaitées existent.

• Erreurs liées aux valeurs de texte 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 sont compatibles avec 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 permettent de résoudre 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. Notez que si vous triez les diffusions en direct par viewCount, les résultats de l'API sont triés en fonction du nombre de spectateurs simultanés pendant la diffusion.

  • 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 compatibles 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 celle de la 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 nouvelle définition explique également comment est renseignée la valeur pour les vidéos privées et non répertoriées.

    Cette modification ne reflète pas un changement de comportement de l'API.

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

    • 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 demande programme la publication d'une vidéo, celle-ci est publiée immédiatement. Par conséquent, définir la propriété status.publishAt sur une date et une heure passées revient à modifier la propriété privacyStatus de la vidéo en la faisant passer de private à public.

  • La propriété contentDetails.contentRating.cncRating de la ressource video spécifie la classification de la vidéo issue de 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 du paramètre brandingSettings.channel.keywords de la ressource channel a été mise à jour de façon à indiquer correctement que la valeur de la propriété contient une liste de chaînes séparées par des espaces et non une liste d'éléments séparés par une virgule, 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 précisément 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 aucune ressource thumbnail. Auparavant, la documentation indiquait que vous ne deviez pas fournir de corps de requête lorsque vous appelez 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 afin de refléter le fait que la méthode activities.list n'inclut actuellement pas de ressources liées aux nouveaux commentaires vidéo. Les ressources snippet.type et contentDetails.comment de la ressource ont également été mises à jour.

• Erreurs nouvelles et mises à jour

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

    Infos sur l'erreur
    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 demande 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 Le format des valeurs des paramètres location et/ou locationRadius n'est pas valide.
    search.list	Code de réponse HTTP badRequest (400) Motif invalidRelevanceLanguage Description Le format de la valeur du paramètre relevanceLanguage est incorrect.
    subscriptions.insert	Code de réponse HTTP badRequest (400) Motif subscriptionForbidden Description Cette erreur se produit dans les cas suivants : 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 compatible. Vous avez créé trop d'abonnements récemment et devez attendre quelques heures avant d'envoyer une nouvelle demande.
    videos.update	Code de réponse HTTP badRequest (400) Motif invalidDefaultBroadcastPrivacySetting Description La demande 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 a été abandonnée.

    Conformément à notre règlement relatif aux abandons, cette propriété continuera d'être incluse dans les ressources video pendant au moins un an à compter de 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 manière 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 de comportement de l'API.

    Plus précisément, la définition explique maintenant que si un tag contient un espace, le serveur d'API traite la valeur du tag comme si elle était placée entre guillemets, et les guillemets sont pris en compte dans la limite de caractères. Concernant la limite du nombre de caractères, la balise Foo-Baz en comporte sept, tandis que la balise Foo Baz en contient neuf.

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

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 répertorier les fils de commentaires. Les fils de discussion peuvent être triés par date ou par pertinence. Le comportement par défaut consiste à les classer par date et 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 afin de préciser que le contenu doit avoir été mis en ligne initialement sur une chaîne associée à un partenaire de contenu YouTube, puis revendiqué par ce partenaire. Cela ne change pas le comportement réel de l'API.

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

• Erreurs nouvelles et mises à jour

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

    Infos sur l'erreur
    videos.rate	Code de réponse HTTP badRequest (400) Motif emailNotVerified Description L'utilisateur doit valider son adresse e-mail avant d'évaluer la vidéo.
    videos.rate	Code de réponse HTTP badRequest (400) Motif videoPurchaseRequired Description Seuls les utilisateurs ayant loué une vidéo peuvent la louer.

  • Les méthodes subscriptions.delete et subscriptions.insert n'acceptent plus 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 son contenu abusif. La méthode videoAbuseReportReasons.list vous permet de récupérer la liste de toutes les raisons pour lesquelles des vidéos peuvent être signalées.

  • La nouvelle méthode videos.reportAbuse permet de signaler une vidéo comportant du contenu abusif. Le corps de la requête contient un objet JSON qui spécifie la vidéo signalée ainsi que le motif pour lequel elle contient du contenu abusif. Vous pouvez obtenir des motifs valides à l'aide de la méthode videoAbuseReportReason.list décrite ci-dessus.

    Le guide de migration contient également un exemple de signalement d'une vidéo abusive. Avec ce changement, l'API v3 est désormais compatible avec toutes les fonctionnalités de l'API v2 qu'elle est programmée pour prendre en charge. Ces fonctionnalités sont également 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 la recherche aux vidéos qui ont été mises en ligne via l'application ou le site Web du développeur. Vous pouvez utiliser le paramètre forDeveloper avec des paramètres de recherche facultatifs tels que le paramètre q.

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

    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 sur son propre site ou application, mais pas à celles envoyées via d'autres applications ou sites.

    La nouvelle fonctionnalité offre des fonctionnalités similaires, mais pas identiques, à celles des tags de développeur compatibles avec l'API v2.

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

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

  • L'API est désormais compatible avec le ciblage pour channelSection ressources. Le ciblage par 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 propose trois options de ciblage. Pour qu'une section de canal soit visible, un utilisateur doit remplir tous les paramètres de ciblage.

    • targeting.languages[] : liste des langues des applications 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 YouTube préférées. La section de la chaîne est visible par les utilisateurs qui ont sélectionné l'une de ces régions, ainsi que ceux pour lesquels l'une de ces régions est sélectionnée automatiquement.

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

  • La définition de la propriété contentDetails.duration de la ressource video a été corrigée afin de refléter 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 afin de refléter le fait que, si l'opération réussit, toutes ces méthodes renvoient un code de réponse HTTP 204 (No Content).

• Erreurs nouvelles et mises à jour

  • L'API accepte désormais 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 contient 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 contient 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 contient 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 ne parvient pas à 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 lecteur 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 spécifie un ID de canal 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'accepte plus 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 utilisant encore la fonctionnalité de commentaires de l'API v2.

  Il fait également état de plusieurs fonctionnalités d'ajout de commentaires qui n'étaient pas compatibles avec l'API v2, mais qui sont compatibles avec l'API v3. par exemple :

  • Récupérer des commentaires sur une chaîne
  • Récupérer tous les fils de commentaires d'une chaîne, ce qui signifie que la réponse de l'API peut contenir des commentaires sur la chaîne ou sur n'importe laquelle 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 afin de refléter le fait que les notifications ne sont envoyées que vers le hub Google PubSubHubBub, et non vers le 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 mettre à jour, de supprimer et de modérer des commentaires.

  • Une ressource commentThread contient des informations sur un fil de commentaires YouTube, qui comprennent 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 particulier. En outre, certains commentaires n'ont pas de réponse.

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

    • commentThreads.list : récupère une liste de fils de commentaires. Utilisez cette méthode pour récupérer les commentaires associés à une vidéo ou à une chaîne spécifique.
    • commentThreads.insert : permet de créer un commentaire de premier niveau. (Utilisez la méthode comments.insert pour répondre à un commentaire existant.)
    • commentThreads.update : modifie 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. Il peut s'agir d'un commentaire de premier niveau ou d'une réponse à un commentaire de premier niveau.

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

    • comments.list : récupère une liste de commentaires. Utilisez cette méthode pour récupérer toutes les réponses à un commentaire donné.
    • comments.insert : permet de créer une réponse à un commentaire existant.
    • comments.update : modifie un commentaire.
    • comments.markAsSpam : permet de signaler un ou plusieurs commentaires comme spam.
    • comments.setModerationStatus : permet de définir l'état de modération d'un ou de plusieurs commentaires. Par exemple, effacez un commentaire pour qu'il s'affiche publiquement ou refusez un commentaire qui n'est pas adapté à l'affichage. La demande d'API doit être autorisée par le propriétaire de la chaîne ou de la vidéo associée aux commentaires.
    • comments.delete : supprime 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 obligatoire 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 au Web. Votre serveur de rappel PubSubHubBub peut recevoir des notifications de flux Atom lorsqu'un canal 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 prendre en charge les notifications push. Toutefois, étant donné que la version 2 de l'API était compatible avec de nombreux autres types de notifications push qui ne sont pas compatibles avec la version 3, la mention de la compatibilité de PubSubHubBub est toujours indiquée dans la section Obsolète de ce guide.

• Le nouveau champ d'application https://www.googleapis.com/auth/youtube.force-ssl de l'API est désormais valide pour toute méthode d'API précédemment compatible avec le champ d'application https://www.googleapis.com/auth/youtube.

• L'API accepte désormais 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 contient une valeur inattendue pour le paramètre rating.

• La méthode subscriptions.insert n'accepte plus l'erreur subscriptionLimitExceeded, qui indiquait précédemment que l'abonné identifié avec la requête avait dépassé la limite du taux d'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 suivantes : list, insert, update, download et delete.

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

• Le nouveau champ d'application https://www.googleapis.com/auth/youtube.force-ssl de l'API nécessite la communication avec le serveur d'API 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 champs d'application sont fonctionnellement identiques, car le serveur d'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 réalité aucun autre moyen d'envoyer une requête API.

  Le nouveau champ d'application est requis 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, Nouveau dans l'API v3, qui répertorie les fonctionnalités compatibles avec l'API v3 et l'API v2. Les mêmes fonctionnalités étaient auparavant présentes et sont toujours répertoriées dans d'autres onglets du guide. Par exemple, la nouvelle fonctionnalité expliquant comment mettre à jour les données des campagnes promotionnelles sur les vidéos d'une chaîne est également disponible dans l'onglet Chaînes (profils).

• La version 3 de l'API YouTube Data a été mise à jour. L'API v3 est désormais compatible avec la version 2:

  • 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 disponibles dans l'API v3:

  • Récupération des recommandations de vidéos : la version 3 de l'API ne récupère pas une liste qui ne contient que des vidéos recommandées pour l'utilisateur API actuel. Toutefois, vous pouvez utiliser l'API v3 pour rechercher 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 contiennent des informations sur les raisons pour lesquelles la vidéo a été recommandée. Sachez que rien ne garantit que le commentaire contiendra un nombre particulier de vidéos recommandées.

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

  • Récupération des vidéos d'un nouvel abonnement : la version 3 de l'API ne récupère pas une liste qui ne contient que les vidéos récemment mises en ligne sur des chaînes auxquelles l'utilisateur de l'API s'abonne. Toutefois, vous pouvez utiliser l'API v3 pour rechercher de nouvelles vidéos sur des abonnements 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 à un nouvel abonnement vidéo si la valeur de la propriété snippet.type est upload. Sachez que rien ne garantit que la réponse contiendra un nombre particulier de nouvelles vidéos d'abonnement.

  • Compatibilité avec les flux RSS

  • Notifications push pour les mises à jour de flux : la version 2 de l'API permettait d'envoyer des notifications push aux utilisateurs de YouTube via le protocole SUP (Simple Update Protocol) ou PubSubHubbub. Des notifications ont été fournies pour les nouveaux abonnements aux chaînes, et lorsque les vidéos ont été notées, partagées, ajoutées aux favoris, commentées ou mises en ligne.

    La version 3 de l'API est compatible avec les notifications push envoyées via le protocole PubSubHubbub. Toutefois, les notifications ne concernent que les importations et mises à jour de titres ou de descriptions de vidéos.

  • Emplacement de la chaîne : la version 2 de l'API a utilisé la balise <yt:location> pour identifier l'emplacement de l'utilisateur indiqué dans le profil public de la chaîne YouTube. Certains développeurs utilisaient ce champ pour associer un canal à un pays en particulier, mais les données du champ ne pouvaient pas être systématiquement utilisées à cette fin.

  • Définir ou récupérer des tags de développeur : la version 2 de l'API 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 sont pas visibles par les utilisateurs YouTube, mais les propriétaires de vidéos peuvent récupérer les vidéos qui correspondent à un tag de développeur en particulier.

    La version 3 de l'API proposera une fonctionnalité similaire, mais pas identique. Plus précisément, un développeur peut rechercher des vidéos mises en ligne par son propre application. Pour cette fonctionnalité, le numéro de projet associé à l'application du développeur dans la Google Developers Console est automatiquement ajouté à chaque vidéo importée. Il 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 classification : 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 d'autres valeurs. Dans la version 3 de l'API, les éléments de la playlist sont généralement triés par ordre croissant, et les autres options de tri ne sont pas disponibles.

    Il existe quelques exceptions. Une nouvelle vidéo mise en ligne, une vidéo préférée, une vidéo que vous aimez ou une vidéo que vous avez récemment regardée est ajoutée automatiquement en tant que premier élément (snippet.position = 0) pour les types de playlists suivants. Chacune de ces listes est donc triée par ordre chronologique, du plus récent au plus ancien, en fonction de l'heure à laquelle les articles ont été ajoutés à la liste.

    • mises en ligne par des utilisateurs
    • vidéos préférées
    • vidéos "J'aime"
    • historique des vidéos regardées

    Notez toutefois qu'un nouvel élément ajouté à la playlist "À regarder plus tard" est ajouté en tant que dernier élément de cette liste. Cette liste est donc triée de la plus ancienne à la plus récente.

  • Traitement par lot : la version 3 de l'API est compatible avec l'un des cas d'utilisation pris en charge par la version 2. Les méthodes channels.list, channelSections.list, guideCategories.list, playlistItems.list, playlists.list, subscriptions.list, videoCategories.list et videos.list de l'API v3 sont toutes compatibles avec un paramètre id, qui permet de spécifier une liste d'ID séparés par une virgule (ID vidéo, ID de chaînes, etc.). Ces méthodes vous permettent de 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 abandonnées dans la version actuelle (v3).

4 mars 2015

Cette mise à jour inclut les changements suivants :

• Les méthodes channelSections.delete et channelSections.update acceptent désormais le paramètre onBehalfOfContentOwner, qui est déjà compatible avec plusieurs autres méthodes.

• Les propriétés suivantes et leurs propriétés enfants sont obsolètes:

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

  Remarque:Aucune de ces propriétés n'a été soumise au règlement relatif aux abandons 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 une note DJCQT (Brésil).

• L'API accepte désormais 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 un canal 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 la playlist, mais que la playlist n'utilise pas le tri manuel. Par exemple, les éléments de playlist peuvent être triés par date ou par popularité. Vous pouvez corriger cette erreur en supprimant l'élément snippet.position de la ressource envoyée dans le corps de la requête. Si vous voulez que l'élément de la playlist figure à une position spécifique dans la liste, vous devez d'abord définir le paramètre de tri de la playlist sur Manuel. Vous pouvez modifier 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 un canal qui a été fermé.
  forbidden (403)	channelSuspended	La méthode playlists.list renvoie cette erreur si le paramètre channelId de la requête spécifie un canal suspendu.
  forbidden (403)	playlistForbidden	La méthode playlists.list renvoie cette erreur si le paramètre id de la requête n'est pas compatible 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 un canal 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 particulière.

  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 permet de résoudre un problème 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 vers l'API YouTube Data (v3) a également été mis à jour pour indiquer l'abandon des champs spéciaux de flux et de métadonnées fournis par l'API v2 pour décrire les films, les bandes-annonces, les émissions télévisées, les saisons et les épisodes de série TV.

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 pour 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 compatible avec la version 2 de l'API. Notez que cette modification du guide de migration ne reflète pas une véritable modification de l'API, mais plutôt la disponibilité d'un nouvel exemple de code pour l'importation de vidéos avec un code JavaScript côté client.

  Étant donné qu'il est désormais possible d'importer des vidéos à l'aide de la bibliothèque cliente JavaScript et du CORS, le guide de migration ne répertorie plus l'importation basée sur le navigateur en tant que fonctionnalité potentiellement obsolète dans la version 3 de l'API.

• 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 à moindre coût. Prenons l'exemple de ces 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, puis 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 peut 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 valides pour la propriété sont les suivantes:

    • allowed : la chaîne peut mettre en ligne des vidéos de plus de 15 minutes.
    • eligible : la chaîne peut mettre en ligne des vidéos de plus de 15 minutes, mais elle doit d'abord activer la fonctionnalité.
    • disallowed : la chaîne ne peut pas mettre en ligne de vidéos de plus de 15 minutes ni en être é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 une "planification intelligente". Cette fonctionnalité tente d'afficher les promotions à un moment précis de la vidéo où elles sont davantage susceptibles d'enregistrer des clics et moins susceptibles d'interrompre l'expérience de visionnage. Cette fonctionnalité permet également de diffuser une seule promotion par vidéo.

• Les définitions des propriétés snippet.title et snippet.categoryId de la ressource video ont toutes deux été mises à jour pour clarifier la manière 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 sans définir 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 de l'Office of Film and Literature Classification de la Nouvelle-Zélande, accepte désormais deux nouvelles classifications : oflcRp13 et oflcRp16. Ils correspondent respectivement aux notes RP13 et RP16.

• La méthode channelBanners.insert accepte désormais l'erreur suivante:

  Type d'erreur	Détails de l'erreur	Description
  badRequest	bannerAlbumFull	L'album d'illustration de chaîne YouTube du propriétaire de la chaîne contient trop d'images. Le propriétaire de la chaîne doit accéder à la page http://photos.google.com, puis accéder à la page des albums et supprimer certaines images de cet 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 accepte désormais l'erreur suivante:

  Type d'erreur	Détails de l'erreur	Description
  badRequest	subscriptionLimitExceeded	L'abonné identifié avec la demande a dépassé la limite du taux d'abonnement. D'autres abonnements seront proposés 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 exécuter les fonctionnalités disponibles dans l'API YouTube Data (v2). L'ancienne API a officiellement été abandonnée le 4 mars 2014. Ce guide a pour but de vous aider à migrer les applications utilisant encore l'API v2 vers la version la plus récente.

8 juillet 2014

Cette mise à jour inclut les changements suivants :

• La méthode playlists.insert accepte désormais l'erreur suivante:

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

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 généré par un appel à cette méthode. De même, les définitions des paramètres part ont été mises à jour afin de spécifier le coût du quota de chaque partie pouvant être récupéré 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 ayant un coût de deux unités.

  N'oubliez pas que les coûts de quota peuvent être modifiés sans avertissement préalable.

• La ressource video est désormais compatible avec 43 nouveaux systèmes de classification du contenu, qui identifient les classifications reçues par les organismes de classification nationale. :

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 à un emplacement géographique. Une requête doit spécifier une valeur pour les deux paramètres afin de récupérer les résultats en fonction de l'emplacement. L'API renvoie 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 à partir de laquelle le lieu associé à une vidéo peut se trouver au centre de la zone de la vidéo à inclure 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 en promotion pour votre chaîne. Si vous essayez d'insérer trop d'articles en promotion, l'API renvoie une erreur tooManyPromotedItems, qui est associée au code d'état HTTP 400.

• La ressource channelSection peut désormais contenir des informations sur quelques nouveaux types de contenus. 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és 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 est abonné.

• La nouvelle propriété contentDetails.contentRating.ifcoRating de la ressource video identifie la classification d'une vidéo de 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 s'affiche toujours dans l'angle supérieur droit du lecteur.

• La définition du paramètre q de 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 (-) pour exclure les vidéos associées à un terme de recherche particulier. La valeur peut également utiliser l'opérateur booléen OR (|) pour trouver les 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 approximative et peut ne pas correspondre à une valeur exacte. En outre, 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 si les liens de pagination doivent être affichés.

• 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 réussies vers ces méthodes.

2 mai 2014

Cette mise à jour inclut les changements suivants :

• La nouvelle ressource i18nLanguage identifie une langue d'application acceptée par le site Web YouTube. La langue de l'application peut également être désignée comme langue de l'interface utilisateur. Pour le site Web YouTube, une langue d'application peut être automatiquement sélectionnée en fonction des paramètres du compte Google, de la langue du navigateur ou de l'emplacement de l'adresse IP. Il est également possible de sélectionner manuellement la langue souhaitée dans l'interface utilisateur à partir du pied de page du site YouTube.

  L'API est compatible avec une méthode permettant de répertorier les langues d'applications compatibles. Les langues compatibles 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 est également 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'une heuristique telle que le domaine YouTube ou l'emplacement IP de l'utilisateur. L'utilisateur peut également sélectionner manuellement la région souhaitée dans le pied de page du site YouTube.

  L'API est compatible avec une méthode permettant de répertorier les régions de contenu compatibles. Les codes de région 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 choisi par une chaîne. Par exemple, une section peut présenter les dernières vidéos mises en ligne, les vidéos les plus populaires ou les vidéos d'une ou plusieurs playlists.

  L'API est compatible avec les méthodes permettant de répertorier, insérer, mettre à jour ou 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 spécifique 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 acceptés par l'API 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 de la vidéo ou sa propriété processingDetails.editorSuggestionsAvailability 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'agit d'une erreur de documentation. En effet, 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 de la 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 au règlement relatif aux abandons.

13 mars 2014

Cette mise à jour inclut les changements suivants :

• L'API est désormais compatible avec la partie contentOwnerDetails des ressources channel. La nouvelle partie contient des données pertinentes pour les partenaires YouTube associés, y compris l'ID du propriétaire de contenu associé à la chaîne, ainsi que la date et l'heure de l'association entre le propriétaire de contenu et la chaîne. Notez que cette nouvelle pièce n'est pas soumise au règlement relatif aux abandons.

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

  Ressource	Propriété	Longueur 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 sont comptabilisées dans la limite.

• La propriété brandingSettings.watch.featuredPlaylistId de la ressource channel a été abandonnée. L'API renvoie une erreur si vous tentez de définir sa valeur.

• Les propriétés de ressources video suivantes ont été ajoutées à la liste des valeurs pouvant ê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 accepte désormais 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 conjointement.
  badRequest (400)	channelTitleUpdateForbidden	La méthode channels.update renvoie cette erreur si vous essayez de mettre à jour la partie brandingSettings d'un canal et de modifier la valeur de la propriété brandingSettings.channel.title. Notez que l'API ne renvoie pas d'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 canal non valide.
  badRequest (400)	invalidTimingOffset	La méthode channels.update renvoie cette erreur si la partie invideoPromotion spécifie un décalage temporel non valide.
  badRequest (400)	tooManyPromotedItems	La méthode channels.update renvoie cette erreur si la partie invideoPromotion indique plus d'éléments mis en avant que le 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 qui ne peut pas être trouvé ou qui ne peut pas être utilisé comme élément sponsorisé.
  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 délai par défaut pour le moment où YouTube doit afficher un article sponsorisé.
  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 sponsorisé.
  badRequest (400)	invalidPublishAt	La méthode videos.insert renvoie cette erreur si les métadonnées de la requête indiquent une heure de publication planifiée non valide.

4 mars 2014

Cette mise à jour inclut les changements suivants :

• La version 3 de l'API YouTube Data est désormais soumise aux règles d'obsolescence décrites dans les Conditions d'utilisation des API YouTube. Notez que la page qui répertorie les API soumises au règlement relatif aux abandons exclut expressément certaines fonctionnalités de l'API v3.

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 une valeur pour un seul paramètre de filtre lorsque vous envoyez une requête de recherche. En revanche, vous pouvez définir une valeur pour zéro paramètre de filtre ou pour 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 images de la bannière de la chaîne importée a été réduite à 2 048 x 1 152 pixels. (Auparavant, la taille minimale était de 2 120 x 1 192 pixels.) En outre, notez que la documentation sur les ressources channel spécifie les tailles maximales 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 pour télévision 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 l'illustration de chaîne à afficher 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 doit pas dépasser 1 000 caractères.
  • La propriété brandingSettings.channel.featuredChannelsTitle ne doit pas dépasser 30 caractères.
  • La propriété brandingSettings.channel.featuredChannelsUrls[] peut désormais lister jusqu'à 100 chaînes.
  • La valeur de la propriété brandingSettings.channel.unsubscribedTrailer, si elle est définie, doit indiquer l'ID vidéo 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 mises à jour de la propriété invideoPromotion.items[].promotedByContentOwner. Cette propriété indique si le nom du propriétaire du contenu sera affiché lors de l'affichage de la promotion. Elle ne peut être définie que si la requête API qui définit la valeur de la propriété est effectuée pour le compte du propriétaire de contenu à l'aide du paramètre onBehalfOfContentOwner.

• Les méthodes playlistItems.list et playlistItems.insert acceptent désormais le paramètre onBehalfOfContentOwner, qui est déjà compatible avec plusieurs autres méthodes.

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

• Les nouvelles propriétés contentDetails.contentRating.catvRating et contentDetails.contentRating.catvfrRating identifient les classifications reçues par une vidéo conformément au système de classification de la télévision canadienne et au système de classification en français du Cinéma du Québec, respectivement.

• La nouvelle propriété snippet.assignable de la ressource videoCategory indique si les vidéos mises à jour ou récemment 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 faciliter la recherche et la diffusion de contenus diffusés en direct:

  La nouvelle propriété snippet.liveBroadcastContent dans les résultats de recherche indique si une vidéo ou une ressource de chaîne diffuse du contenu en direct. Les valeurs valides pour cette propriété 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 active. La liste ci-dessous décrit les valeurs possibles de la propriété:

    • upcoming : la vidéo est diffusée en direct et n'a pas encore commencé.
    • active : la vidéo est diffusée en direct.
    • none : la vidéo n'est pas une diffusion en direct à venir ni active. Il s'agira de la valeur de la propriété pour les diffusions terminées qui restent 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 de parties de la ressource du paramètre part. Les métadonnées incluent les nouvelles propriétés suivantes:

    • liveStreamingDetails.actualStartTime : heure de début effective de la diffusion (Cette valeur sera indiquée une fois que la diffusion aura l'état active.)
    • liveStreamingDetails.actualEndTime : heure de fin effective de la diffusion (Cette valeur est indiquée une fois la diffusion terminée.)
    • liveStreamingDetails.scheduledStartTime : heure à laquelle la diffusion est programmée
    • 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 le contenu diffusé en direct ont été lancé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 qui sont abonnés à sa chaîne. La valeur par défaut du paramètre est True, ce qui indique que les abonnés sont informés des nouvelles vidéos mises en ligne. Cependant, le propriétaire d'une chaîne qui met en ligne de nombreuses vidéos peut choisir de définir la valeur sur False pour éviter d'envoyer une notification sur chaque nouvelle vidéo aux abonnés de la chaîne.

• La liste des propriétés qui peuvent ê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. En outre, la liste a été modifiée pour identifier les propriétés brandingSettings modifiables. Ces propriétés brandingSettings étant déjà modifiables, la modification apportée à la documentation ne reflète pas une modification des fonctionnalités existantes de l'API.

• Les méthodes playlists.insert, playlists.update et playlists.delete acceptent désormais le paramètre onBehalfOfContentOwner, qui est déjà compatible avec plusieurs autres méthodes.

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

• La propriété contentDetails.contentRating.tvpgRating de la ressource video accepte désormais la valeur pg14, qui correspond à une note 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 n'est pas une valeur de propriété valide.

• 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) : limité à 6 ans et plus.
  • 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 l'affichage de la promotion. Ce champ ne peut être défini que si la requête API qui définit la valeur est effectuée pour le compte du propriétaire de contenu. Consultez le paramètre onBehalfOfContentOwner pour en savoir plus.

1er octobre 2013

Cette mise à jour inclut les changements suivants :

• Le nouvel objet auditDetails de la ressource channel contient des données de canal qu'un réseau multichaîne évaluerait lors de l'acceptation ou du refus d'un canal spécifique. Notez que toute requête API qui récupère cette partie de la 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 réseau multichaîne décide d'accepter ou de refuser la chaîne, ou dans un délai de deux semaines à compter de sa date d'émission.

• La propriété invideoPromotion.items[].id.type de la ressource channel accepte désormais la valeur recentUpload, ce qui indique que l'élément en promotion est la dernière vidéo mise en ligne par une chaîne spécifique.

  Par défaut, la chaîne est identique à celle pour laquelle vous avez défini les données de la promotion dans des vidéos. Cependant, vous pouvez promouvoir la dernière vidéo mise en ligne depuis une autre chaîne en définissant la valeur de la nouvelle propriété invideoPromotion.items[].id.recentlyUploadedBy sur l'ID de la 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ère qui s'affichent sur les pages des chaînes dans les applications de télévision.

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

  • Pour une ressource video, la valeur upcoming indique que la vidéo est en cours de diffusion en direct, tandis que la valeur active indique qu'elle est en cours.
  • Pour une ressource channel, la valeur upcoming indique que la diffusion d'une chaîne est en cours, alors que la valeur acive indique qu'une diffusion en direct est en cours sur la chaîne.

• 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 la chaîne YouTube vers laquelle renvoie l'image en filigrane, la propriété targetChannelId spécifie désormais cette valeur. 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 est déjà compatible avec plusieurs autres méthodes.

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

• La nouvelle propriété contentDetails.contentRating.mibacRating identifie la vidéo attribuée par le Ministero dei Beni e delle Attivita Culturali e del Turismo en Italie.

• L'API accepte désormais 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 avis 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 pendant la lecture des vidéos d'une chaîne spécifique. Vous pouvez également spécifier une chaîne cible vers laquelle l'image redirigera, ainsi que des codes temporels qui déterminent quand le filigrane s'affiche pendant la lecture des vidéos et leur durée d'affichage.

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

  La documentation sur les erreurs décrit les messages d'erreur acceptés par l'API 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 par tous.

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

• La méthode videos.list est désormais compatible avec 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 correspond à un code de pays ISO 3166-1 alpha-2.

• error documentation décrit la nouvelle erreur de requête courante suivante, qui pourrait 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 possède les propriétés nouvelles et mises à jour suivantes:

  • L'API permet désormais de spécifier un site Web en tant qu'article sponsorisé. 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.

    Il peut s'agir de sites Web associés, de sites marchands ou de réseaux sociaux. Consultez les instructions du centre d'aide YouTube pour les sites Web associés et les sites marchands pour en savoir plus sur l'activation des liens pour votre contenu.

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

  • Les propriétés liées aux paramètres de durée d'affichage des éléments 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 synchronisation pour chaque article sponsorisé dans la liste invideoPromotion.items[].

    • Le nouvel objet invideoPromotion.defaultTiming spécifie les paramètres de minutage par défaut de votre promotion. Ces paramètres déterminent à quel moment un produit promu s'affiche pendant la lecture de l'une des vidéos de votre chaîne. Vous pouvez remplacer le délai par défaut pour tout article sponsorisé donné à l'aide de l'objet invideoPromotion.items[].timing.

    • La nouvelle propriété invideoPromotion.items[].timing.durationMs indique la durée d'affichage (en millisecondes) de la promotion. L'objet invideoPromotion.defaultTiming contient également un champ durationMs qui spécifie la durée d'affichage par défaut de l'élément sponsorisé.

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

• La méthode subscriptions.list accepte désormais 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 sa fonctionnalité 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 pourrait se produire pour toute méthode d'API compatible avec le paramètre de requête mine:

  Type d'erreur	Détails de l'erreur	Description
  badRequest	invalidMine	Impossible d'utiliser le paramètre mine dans les requêtes pour lesquelles 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 chaîne 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 de quotas du guide Premiers pas avec l'API YouTube Data a été mise à jour afin de refléter la modification du coût d'un envoi de vidéo 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 bien visible 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 à six caractères, telle que #2793e6.

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

• La méthode videos.list est compatible avec de nouveaux paramètres permettant de récupérer un graphique 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, ce qui 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 la 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 particulière.

• La nouvelle propriété topicDetails.relevantTopicIds[] de la ressource video fournit une liste d'ID de sujets Freebase pertinents pour la vidéo ou son contenu. Les sujets associés peuvent être mentionnés dans la vidéo ou apparaître dans celle-ci.

• 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 reçues par une vidéo selon 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 indiquant que la vidéo n'a pas été classée. Remarque : Pour les classifications MPAA, une classification "sans classification" est souvent utilisée afin d'identifier les versions non coupées de films pour lesquelles la version coupé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é la vidéo comme présentant un contenu inapproprié pour des utilisateurs de moins de 18 ans. Si la propriété est absente ou si la valeur de la propriété est vide, cela signifie que le contenu n'a pas été soumis à une limite d'âge.

• Le paramètre mySubscribers de la méthode channels.list est obsolète. 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 acceptent désormais le paramètre onBehalfOfContentOwner. Ce paramètre indique que l'utilisateur authentifié agit au nom du propriétaire de 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 répertorie également 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 d'API particulière. Il 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 d'API particulière. Il 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 cet autre compte est clôturé.
  forbidden	authenticatedUserAccountSuspended	Cette erreur n'est pas spécifique à une méthode d'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 ce dernier a été suspendu.
  forbidden	authenticatedUserNotChannel	Cette erreur n'est pas spécifique à une méthode d'API particulière. Il indique que le serveur d'API ne peut pas identifier le canal associé à 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 d'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 d'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 d'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 mettre à jour est introuvable. Vérifiez la valeur de la propriété id dans le corps de la requête pour vous assurer qu'elle 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 des résultats pertinents pour le 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és.

• Les ressources d'une 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 concernant leurs propres playlists. Les utilisateurs autorisés peuvent également définir des tags de playlist lorsqu'ils appellent la méthode playlists.insert ou playlists.update.

• Le paramètre onBehalfOfContentOwner, qui était auparavant compatible avec les méthodes channels.list et search.list, est désormais également compatible avec les méthodes videos.insert, videos.update et videos.delete. Sachez 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 indiqué par le paramètre onBehalfOfContentOwner.

  Le paramètre indique que les identifiants d'autorisation de la demande identifient un utilisateur du CMS YouTube qui agit au nom du propriétaire de 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 différentes chaînes YouTube. Ce paramètre permet à ces partenaires de s'authentifier une fois et d'accéder à toutes les données de leurs vidéos et de leur chaîne, sans avoir à fournir d'identifiants pour chaque chaîne.

  Concernant cette version, le paramètre permet désormais à un partenaire du réseau de contenu d'insérer, de mettre à jour ou de supprimer des vidéos sur l'une des chaînes YouTube dont il est le 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 d'API particulière. Il 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 qu'elle n'est pas correctement autorisée.

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

• Le nouveau guide Utiliser les ID de canal explique comment l'API utilise les ID de canal. Il peut être particulièrement utile aux développeurs qui effectuent une migration à partir de la version précédente de l'API et dont les applications demandent du contenu pour l'utilisateur default ou s'appuient sur la notion d'un nom d'utilisateur unique pour chaque chaîne YouTube, 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 image de bannière qui pourra ensuite être utilisée comme image de bannière pour un canal à 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 que vous pouvez modifier lorsque vous appelez la méthode.

• La documentation de 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 des méthodes channelBanners.insert et subscriptions.list. Il répertorie également plusieurs nouvelles erreurs pour la méthode channels.update.

14 mai 2013

Cette mise à jour inclut les changements suivants :

• Les pages indépendantes affichent désormais des exemples de code pour Java, .NET, PHP et Ruby.

• La page qui répertorie des 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 expérimentaux de l'API. 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 canal sont désormais compatibles avec l'objet inVideoPromotion, qui encapsule les informations sur une campagne promotionnelle associée au canal. Une chaîne peut utiliser une campagne promotionnelle intégrée à une vidéo pour afficher les miniatures d'une vidéo sponsorisée 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 dans une requête channels.list.

• La nouvelle méthode channels.update permet de mettre à jour les données des campagnes promotionnelles sur les vidéos d'une chaîne. Notez que la méthode ne prend en charge que les mises à jour de la partie invideoPromotion de la ressource channel et n'accepte pas encore les mises à jour des 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 chaîne identifient un utilisateur déjà associé à un nom d'utilisateur YouTube ou à un compte Google+. Un utilisateur qui dispose de l'un de ces liens a déjà une identité YouTube publique, ce qui est nécessaire pour effectuer plusieurs actions, comme mettre en ligne des vidéos.

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

• L'API est désormais compatible avec la méthode videos.getRating, qui récupère les notes que l'utilisateur authentifié a attribuées à 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 pour lesquelles l'utilisateur authentifié a obtenu la note like ou dislike.

  Les paramètres myRating et id sont maintenant tous deux considérés comme des paramètres de filtre, ce qui 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 de la vidéo, 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 accepter la pagination. Toutefois, notez que les paramètres de pagination ne sont compatibles qu'avec les requêtes utilisant le paramètre myRating. (Les informations et paramètres de pagination ne sont pas compatibles avec 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 contient 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 des propriétés nextPageToken et prevPageToken, chacune fournissant un jeton pouvant être utilisé pour récupérer une page spécifique de l'ensemble de résultats.

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

  • autoLevels : définissez cette valeur sur true pour que YouTube améliore automatiquement la luminosité et la couleur de la vidéo.
  • stabilize : définissez cette valeur sur true pour que YouTube ajuste la vidéo en supprimant les tremblements de la caméra.

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

  • playlistItem : la propriété indique le nom de la chaîne qui a ajouté l'élément de la playlist.
  • playlist : propriété indiquant le nom de la chaîne qui a créé la playlist.
  • subscription : la propriété indique le nom de la chaîne à laquelle vous êtes 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 abandonné.

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

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

• Les requêtes API contenant un paramètre inattendu renvoient désormais une erreur badRequest. Le motif de l'erreur est unexpectedParameter.

• L'erreur renvoyée par la méthode playlistItems.insert alors que la playlist contient déjà le nombre maximal d'éléments autorisés a été mise à jour. L'erreur est maintenant signalée en tant qu'erreur forbidden, et son motif est playlistContainsMaximumNumberOfVideos.

19 avril 2013

Cette mise à jour inclut les changements suivants :

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

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

• Les images miniatures sont désormais identifiées dans la documentation de l'API en tant que ressources distinctes. La nouvelle méthode thumbnails.set vous permet de mettre en ligne une miniature personnalisée sur YouTube et de la définir pour une vidéo.

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

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

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

• 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 la playlist. La propriété status.privacyStatus identifie l'état de confidentialité de l'élément de la playlist.

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

  • La propriété status.publicStatsViewable indique si les statistiques étendues relatives aux vidéos sur la page de lecture sont visibles publiquement. Par défaut, ces statistiques sont visibles. Les statistiques, comme le nombre de vues et les avis sur une vidéo, restent visibles publiquement, 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 regroupe les classifications de la vidéo selon différents systèmes de classification. La liste ci-dessous identifie les systèmes de classification compatibles et fournit un lien vers la propriété associée à chaque système de classification. Les définitions de 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
    Australie	Conseil de classification australien (Australian Classification Board)	contentDetails.contentRating.acbRating
    Brésil	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	contentDetails.contentRating.fmocRating
    Allemagne	Freiwillige Selbstkontrolle der Filmwirtschaft (FSK)	contentDetails.contentRating.fskRating
    Grande-Bretagne	British Board of Film Classification (BBFC)	contentDetails.contentRating.bbfcRating
    Inde	Certification du Conseil central du film (CBFC)	contentDetails.contentRating.cbfcRating
    Japon	映倫管理委員苯 (EIRIN)	contentDetails.contentRating.eirinRating
    Corée	영상물등苯위苯회 (KMRB)	contentDetails.contentRating.kmrbRating
    Mexique	Direction générale de la radio, de la télévision et de la cinématographie (RTC)	contentDetails.contentRating.rtcRating
    Nouvelle-Zélande	Classification des films et des littératures	contentDetails.contentRating.oflcRating
    Russie	Registre national du film de la Fédération de Russie	contentDetails.contentRating.russiaRating
    Espagne	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 refléter le fait 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 accepte désormais les fonctionnalités suivantes:

  • Le nouveau paramètre forMine limite la recherche aux vidéos de l'utilisateur authentifié.

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

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

• La méthode videos.insert accepte plusieurs nouvelles erreurs, répertorié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 specifies invalid recording details.
  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 requête 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é indique le nom du canal responsable de l'activité.
  • search : la propriété indique le nom du canal associé à la ressource identifiée par le résultat de recherche.
  • video : propriété indiquant le nom de la chaîne qui a mis en ligne la vidéo.

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

  • Le paramètre channelType vous permet de limiter la recherche de chaînes à toutes les chaînes ou de récupérer uniquement les émissions.

  • Le paramètre videoType vous permet de limiter la recherche de vidéos à 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 de façon à indiquer que l'objet ne sera renvoyé pour une vidéo que si les données de géolocalisation ou la durée d'enregistrement ont été définis.

• 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 de l'API sont compatibles avec les nouveaux paramètres destinés exclusivement aux partenaires de contenu YouTube. Les partenaires de contenu YouTube incluent les studios de cinéma et de télévision, les maisons de disques et les autres créateurs de contenu qui mettent leur contenu à 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 de 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 différentes chaînes YouTube. Ce paramètre permet à ces partenaires de s'authentifier une fois et d'accéder à toutes les données de leurs vidéos et de leur chaîne, sans avoir à fournir d'identifiants 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, compatible avec la méthode channels.list, indique à l'API de renvoyer toutes les chaînes appartenant au propriétaire de contenu spécifiées 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 la recherche pour n'inclure que les ressources appartenant au propriétaire de contenu spécifié par le paramètre onBehalfOfContentOwner.

25 février 2013

Cette mise à jour inclut les changements suivants :

• L'API accepte plusieurs nouvelles pièces et propriétés pour les ressources video:

  • Les nouvelles parties fileDetails, processingDetails et suggestions fournissent des informations sur les vidéos mises en ligne aux propriétaires. Ces données sont très utiles pour les applications qui permettent la mise en ligne de vidéos. Elles comprennent les éléments suivants:

    • état du traitement et progression
    • Erreurs ou autres problèmes rencontrés lors du traitement d'une vidéo
    • disponibilité des vignettes
    • suggestions pour améliorer la qualité des vidéos ou des métadonnées
    • Informations sur le fichier d'origine mis en ligne sur YouTube

    Toutes ces parties ne peuvent être récupérées que par le propriétaire de la vidéo. La liste ci-dessous décrit brièvement les nouvelles parties, et la documentation sur les ressources video définit toutes les propriétés qu'elles contiennent.

    • L'objet fileDetails contient des informations sur le fichier vidéo mis en ligne sur YouTube, y compris la résolution, la durée, les codecs audio et vidéo, les débits de diffusion, 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 n'ait fini de traiter la vidéo. Cette section indique également si différents types de données ou de contenus, tels que des détails sur un fichier ou des miniatures, sont disponibles pour la vidéo.

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

    • L'objet suggestions contient des suggestions qui permettent d'améliorer la qualité de la vidéo ou les métadonnées de la vidéo mise en ligne.

  • 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 haute ou en haute définition.
    • caption : indique si des sous-titres sont disponibles pour la vidéo.
    • licensedContent : indique si la vidéo inclut du contenu qui a été 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 ajoutent 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 : permet de spécifier 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 parties nouvellement ajoutées décrites ci-dessus, ainsi que la partie recordingDetails, qui a été omise par inadvertance.

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

• Chaque objet image miniature spécifie désormais la largeur et la hauteur de l'image. Les images 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 qui représente 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 error répertorie les erreurs que l'API peut renvoyer. La page contient des erreurs générales, qui peuvent se produire pour plusieurs méthodes d'API différentes, ainsi que des erreurs spécifiques à des méthodes.

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. Un algorithme identifie les sujets qui ont une forte présence sur le site YouTube et génère automatiquement des chaînes pour ces sujets.

• Les paramètres search.list suivants ont été mis à jour:

  • 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 le délai spécifié.
  publishedBefore	datetime	Renvoie les ressources créées avant l'heure spécifiée.
  regionCode	string	Affiche les ressources pour le pays spécifié.
  videoCategoryId	string	Filtrez les résultats de recherche vidéo 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 vidéo 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 de l'API sont compatibles avec les 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 l'élément de façon unique dans la playlist.
  activity	contentDetails.channelItem	object	Objet contenant des informations sur une ressource ajoutée à un canal. Cette propriété n'est présente que si snippet.type est défini sur channelItem.
  activity	contentDetails.channelItem.resourceId	object	Objet identifiant la ressource ajoutée au canal Comme les autres propriétés resourceId, il contient une propriété kind qui spécifie le type de ressource, comme la vidéo ou la playlist. Il contient également exactement une des propriétés (videoId, playlistId, etc.) qui spécifie l'ID qui identifie cette ressource de manière unique.
  channel	status	object	Cet objet encapsule des informations sur le niveau 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 des informations que vous utiliseriez pour lire la playlist dans un lecteur intégré.
  playlist	player.embedHtml	string	Un tag <iframe> qui intègre un lecteur vidéo qui lit la playlist.
  video	recordingDetails	object	Cet objet encapsule des informations permettant d'identifier ou de décrire 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 par rapport à la Terre, en mètres.
  video	recordingDetails.locationDescription	string	Description du lieu d'enregistrement de la vidéo.
  video	recordingDetails.recordingDate	datetime	Date et heure d'enregistrement de la vidéo. 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 mises à jour en fonction de valeurs dans le corps de la requête. Le tableau ci-dessous répertorie ces méthodes, ainsi que les propriétés obligatoires ou modifiables.

  Remarque:Il est possible que la documentation pour d'autres méthodes répertorie déjà les propriétés obligatoires et modifiables.

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

• L'API ne signale plus l'erreur playlistAlreadyExists si vous essayez de créer ou de mettre à jour une playlist ayant le même titre qu'une playlist qui existe déjà sur la même chaîne.

• Plusieurs méthodes d'API sont compatibles avec les nouveaux types d'erreurs. Le tableau ci-dessous identifie la méthode et les erreurs nouvellement 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.