Historique des révisions

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

30 octobre 2024

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

Voici quelques exemples de contenus A/S:

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

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

30 avril 2024

Remarque:Ceci est une annonce d'abandon.

Cette mise à jour inclut les changements suivants :

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

13 mars 2024

Remarque:Ceci est une annonce d'abandon.

Cette mise à jour inclut les changements suivants :

Le paramètre sync pour les méthodes captions.insert et captions.update est obsolète. YouTube ne prendra plus en charge ce paramètre à partir du 12 avril 2024.

En raison de ce changement, les développeurs doivent inclure des informations de synchronisation lors de l'insertion ou de la mise à jour de pistes de sous-titres, sinon l'importation échouera.

12 mars 2024

Cette mise à jour inclut les changements suivants :

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

7 mars 2024

Remarque:Ceci est une annonce d'abandon.

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

31 janvier 2024

Cette mise à jour inclut les changements suivants :

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

9 novembre 2023

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

12 septembre 2023

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

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

Une notification d'abandon a été ajoutée à tous les documents qui font référence à la méthode comments.markAsSpam.

22 août 2023

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

18 août 2023

La définition du liveStreamingDetails.concurrentViewers de la ressource video a été modifiée pour indiquer que le nombre de spectateurs simultanés renvoyés par l'API YouTube Data peut différer de celui qui a été traité et supprimé contre les spams, disponibles dans YouTube Analytics. Pour en savoir plus sur les métriques des diffusions en direct, consultez le Centre d'aide YouTube.

7 août 2023

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

28 juin 2023

La méthode thumbnails.set prend désormais en charge l'erreur uploadRateLimitExceeded, qui indique que la chaîne a mis en ligne trop de miniatures au cours des dernières 24 heures et doit réessayer plus tard.

12 juin 2023

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

Le paramètre relatedToVideoId de la méthode search.list est obsolète. YouTube ne prendra plus en charge ce paramètre à partir du 7 août 2023.

À ce stade, une notification d'abandon a été ajoutée à la documentation de la méthode search.list. Ce paramètre sera entièrement supprimé de la documentation search.list à compter du 7 août 2023.

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

22 août 2022

Correction des annotations de type pour les champs video.statistics en chaîne à partir de long non signé.

5 août 2022

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

D'ici le 1er décembre 2022, les méthodes captions.list, captions.update, captions.download et captions.delete seront compatibles avec les anciens et les nouveaux ID de piste de sous-titres. Cependant, à compter du 1er décembre 2022, YouTube n'acceptera plus les anciens ID de piste de sous-titres. À ce stade, 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, vous devez prévoir de remplacer complètement toutes les données des pistes de sous-titres stockées d'ici le 1er décembre 2022. Cela signifie que pour toute vidéo pour laquelle vous stockez des données de piste de sous-titres, vous devez supprimer les données actuellement stockées, puis appeler la méthode captions.list pour récupérer l'ensemble actuel de pistes de sous-titres pour la vidéo et stocker les données dans la réponse de l'API comme vous le feriez normalement.

12 juillet 2022

Les conditions d'utilisation des services d'API YouTube ont été mises à jour. Pour en savoir plus, 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 maximale des fichiers pour les vidéos importées est passée de 128 Go à 256 Go.

8 avril 2022

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

15 décembre 2021

Comme annoncé le 18 novembre 2021, parallèlement aux modifications visant à rendre privé le nombre de "Je n'aime pas" pour les vidéos 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, consultez le blog officiel de YouTube.

18 novembre 2021

En plus des modifications visant à rendre privé le nombre de "Je n'aime pas" pour une vidéo sur l'ensemble de la plate-forme YouTube, la propriété statistics.dislikeCount de la ressource video sera rendue privée à compter du 13 décembre 2021. Cela signifie que la propriété ne sera incluse dans une réponse d'API du point de terminaison videos.list que si la requête 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 ont tout de même besoin de ce nombre pour leur client API peuvent demander à être ajoutés à une liste d'autorisation pour bénéficier d'une exception. Pour demander une exemption, vous devez remplir ce formulaire de demande.

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

2 juillet 2021

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

Le point de terminaison commentThreads.update est obsolète et n'est plus accepté. Ce point de terminaison dupliqué la fonctionnalité disponible via d'autres points de terminaison d'API. À la place, vous pouvez appeler la méthode 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 de YouTube doivent effectuer un audit de conformité de l'API pour obtenir un quota supérieur au quota par défaut de 10 000 unités. À ce jour, le processus d'audit de conformité et les demandes d'allocations d'unités de quota supplémentaires ont été effectués par les développeurs qui ont rempli et envoyé le formulaire Services d'API YouTube : audit et augmentation de quota.

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 d'audit des développeurs: les développeurs qui ont déjà réussi un audit de conformité des API peuvent remplir et envoyer ce formulaire plus court pour demander une extension de leur quota.
  • Formulaire d'appel : les développeurs dont les projets d'API ont échoué à un audit de conformité (ou dont la demande d'augmentation de quota a été refusée) peuvent remplir et envoyer ce formulaire.
  • Formulaire de changement de contrôle: les développeurs ou toute partie gérant un client API au nom d'un développeur qui subit un changement de direction (par exemple, par l'achat ou la vente d'actions, une fusion ou une autre forme de transaction d'entreprise) associé à un projet d'API doivent remplir et envoyer ce formulaire. Cela permet à l'équipe API de YouTube de mettre à jour nos enregistrements, d'auditer la conformité du cas d'utilisation du nouveau projet d'API et de valider l'allocation de quota actuelle du développeur.

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

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

12 mai 2021

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

Cette mise à jour concerne les modifications suivantes de l'API:

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

    Avant cette mise à jour, l'API créait toujours une playlist si un client API tentait d'ajouter une vidéo à une playlist de favoris qui n'existe pas. À l'avenir, la playlist ne sera pas créée dans ce cas, et l'API renverra une erreur. Les tentatives de modification des playlists de favoris en ajoutant, en modifiant ou en supprimant des éléments sont également toutes obsolètes, conformément aux annonces précédentes, et peuvent commencer à renvoyer des erreurs à tout moment.

  • Les propriétés de ressource channel suivantes sont obsolètes. Ces propriétés ne sont déjà plus prises en charge dans l'interface utilisateur de YouTube Studio et sur YouTube. Par conséquent, elles 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 la ressource channel, et leurs définitions ont été supprimées de la liste des propriétés de la ressource. En outre, les erreurs associées à ces propriétés ont été supprimées de la documentation spécifique aux méthodes.

  • Les propriétés de ressource channelSection suivantes sont obsolètes. Ces propriétés ne sont déjà pas compatibles avec l'interface utilisateur de YouTube Studio ni sur YouTube. Par conséquent, elles 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[]

    Conjointement à ce changement, le paramètre hl de la méthode channelSection.list est également obsolète, car les fonctionnalités qu'elle prend en charge ne sont pas compatibles.

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

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

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

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

9 février 2021

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

28 janvier 2021

Cette mise à jour inclut les changements suivants :

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

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

  • Les erreurs watchHistoryNotAccessible et watchLaterNotAccessible de la méthode playlistItems.list ont été supprimées de la documentation. Bien que l'historique des vidéos regardées et les listes "À regarder plus tard" des utilisateurs ne soient pas accessibles via l'API, ces erreurs particulières 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 que l'utilisateur n'ait interagi avec le lecteur pour indiquer une intention de lecture. Vous pouvez limiter les données partagées avec YouTube avant qu'un utilisateur n'interagisse avec le lecteur en définissant la lecture automatique sur "false".
  • La nouvelle Section III.E.4.j concerne la vérification de l'état "Conçu pour les enfants" des contenus avant de les intégrer à vos sites et applications. Vous êtes responsable de savoir quand les vidéos que vous insérez dans votre client API sont conçues pour les enfants et de traiter les données collectées à partir du lecteur intégré en conséquence. Par conséquent, vous devez vérifier l'état du contenu à l'aide du service de l'API YouTube Data avant de l'intégrer à votre client API via des lecteurs YouTube intégrés.

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

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 s'effectue sans interaction de l'utilisateur avec le lecteur. Les données de lecture sont donc collectées et partagées lors du chargement de la page.

8 octobre 2020

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

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

9 septembre 2020

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

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

  • Les ressources, méthodes, paramètres et propriétés de ressources d'API suivants sont immédiatement obsolètes et cesseront de fonctionner à compter de la date de cette annonce :
    • Les propriétés de ressource channel suivantes :
      • Propriété statistics.commentCount
      • L'objet brandingSettings.image et toutes ses propriétés enfants
      • La liste brandingSettings.hints et toutes ses propriétés enfants
    • Paramètre de filtre categoryId de la méthode channels.list
    • 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, ni la propriété nextPageToken pour les requêtes.
  • Les propriétés contentDetails.relatedPlaylists.watchLater et contentDetails.relatedPlaylists.watchHistory de la ressource channel ont été annoncées comme obsolètes le 11 août 2016. La prise en charge de ces playlists par les méthodes playlistItems.insert et playlistItems.delete est désormais entièrement 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, qui a été 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és comme obsolètes le 27 novembre 2017, ont été supprimés de la documentation.

29 juillet 2020

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

Cette modification a pour effet que la plupart des appels d'API auront un coût de quota légèrement inférieur, tandis que certains appels d'API auront toujours le même coût. Cette modification n'augmente pas le coût des appels d'API. Dans l'ensemble, l'impact est que le quota qui vous est alloué, qui est visible dans la console Google Cloud, va un peu plus loin.

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

Cette entrée de l'historique des révisions a été publiée pour la première fois le 20 juillet 2020.

28 juillet 2020

Toutes les vidéos importées 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é avec les Conditions d'utilisation.

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

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

21 juillet 2020

[Mise à jour du 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é publiée à nouveau le 28 juillet 2020.

Hier, nous avons publié une mise à jour de la documentation concernant notre procédure de facturation des quotas. Cependant, en raison de circonstances imprévues, cette modification de quota n'a pas encore été appliquée. Par conséquent, la documentation a été rétablie pour plus de précision. Pour éviter toute confusion, l'entrée de l'historique des révisions expliquant la modification a été supprimée et sera à 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 ont été supprimés de la documentation. Leurs valeurs sont ignorées et n'ont aucune incidence sur le traitement des nouvelles vidéos.

15 juin 2020

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

Ces consignes expliquent comment YouTube applique certains aspects des conditions d'utilisation des API, mais ne remplacent pas les documents existants. Ce guide répond à certaines des questions les plus courantes que les développeurs posent lors des audits de conformité des API. Nous espérons qu'il vous aidera à mieux comprendre comment nous interprétons et appliquons nos règles afin de simplifier votre processus de développement de fonctionnalités.

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 abandonnée. Ce changement a été initialement annoncé le 17 avril 2020 et est maintenant entré en vigueur. Par conséquent, la méthode activities.insert n'est plus acceptée, et la méthode activities.list ne renvoie plus de bulletins de chaînes. 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 ne renverra plus de bulletins de chaîne. Ces modifications entreront en vigueur dans l'API le 18 mai 2020 ou après. Pour en savoir plus, consultez le Centre d'aide YouTube.

31 mars 2020

Cette mise à jour inclut les changements suivants :

  • Nouvelles ressources et méthodes

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

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

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

10 janvier 2020

L'API permet désormais d'identifier les contenus destinés aux enfants, que YouTube appelle "conçus pour les enfants". En savoir plus sur les contenus conçus pour les enfants dans le Centre d'aide YouTube

Les ressources channel et video prennent en charge deux nouvelles propriétés pour permettre aux créateurs de contenus et aux spectateurs d'identifier les contenus conçus pour les enfants :

  • La propriété selfDeclaredMadeForKids permet aux créateurs de contenu d'indiquer si une chaîne ou une vidéo est conçue pour les enfants.

    Pour les canaux, cette propriété peut être définie lors de l'appel de la méthode channels.update. Pour les vidéos, cette propriété peut être définie lors de l'appel des méthodes videos.insert ou videos.update.

    Notez que cette propriété n'est incluse dans les réponses de l'API contenant des ressources channel ou video que si le propriétaire du canal a autorisé la requête API.
  • La propriété madeForKids permet à n'importe quel utilisateur de récupérer l'état "conçu pour les enfants" d'une chaîne ou d'une vidéo. Par exemple, l'état peut être déterminé en fonction de la valeur de la propriété selfDeclaredMadeForKids. Consultez le Centre d'aide YouTube pour découvrir comment définir l'audience de votre chaîne, de vos vidéos ou de vos diffusions.

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

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 le nombre d'abonnés est indiqué sur YouTube et, par conséquent, dans les réponses de l'API. En conséquence, le nombre d'abonnés renvoyé par l'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 : Ce changement affecte cette valeur de propriété même lorsqu'un utilisateur envoie une requête autorisée pour obtenir des données sur sa propre chaîne. Les propriétaires de chaînes peuvent toujours consulter le nombre exact d'abonnés dans YouTube Studio.

Par exemple, si une chaîne compte 123 456 abonnés, la propriété statistics.subscriberCount contiendra la valeur 123000. Le tableau ci-dessous montre des exemples de nombres d'abonnés arrondis dans les réponses de l'API et abrégés 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 afin de mieux expliquer les cas d'utilisation courants de chaque méthode et de fournir des exemples de code dynamiques et de haute qualité via le widget APIs Explorer. Pour voir un exemple, consultez la documentation de la méthode channels.list. Deux nouveaux éléments décrivent désormais les méthodes API sur les pages:

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

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

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

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

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

    En raison de ce changement, les pages qui listaient auparavant les exemples de code disponibles pour Java, JavaScript, PHP et Python ont été supprimées.

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

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

9 juillet 2018

Cette mise à jour inclut les changements suivants :

  • La définition de la propriété snippet.thumbnails de la ressource channel a été mise à jour pour indiquer que lors de l'affichage de 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, qui correspond à leur format dans les réponses de l'API. Passé ce délai, des images défectueuses peuvent s'afficher dans votre application si elle tente de charger des images YouTube à partir du domaine http.

  • Remarque:Ceci est une annonce d'abandon.

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

22 juin 2018

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

27 novembre 2017

Cette mise à jour inclut les changements suivants :

  • Remarque:Ceci est une annonce d'abandon.

    YouTube ne prend plus en charge les fonctionnalités Sélection vidéo et Sélection de sites Web dans l'API via l'objet invideoPromotion de la ressource channel. Par conséquent, cet objet, y compris toutes ses propriétés enfants, est en cours d'abandon.

    Vous pouvez encore récupérer et définir des 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 renvoient une réponse positive jusqu'au 27 mai 2018 au moins, mais elles seront traitées comme des opérations sans effet, 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 indiquant, par exemple, que invalidPromotion est une partie non valide.

16 novembre 2017

Cette mise à jour inclut les changements suivants :

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

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

    • La fonction removeEmptyParameters reçoit une liste de paires clé-valeur correspondant aux paramètres de requête d'API et supprime les paramètres qui n'ont pas de valeur.
    • La fonction createResource accepte une liste de paires clé-valeur correspondant aux propriétés d'une ressource d'API. Il convertit ensuite les propriétés en un objet JSON pouvant être utilisé dans les opérations insert et update. L'exemple ci-dessous montre un ensemble de noms et de valeurs de propriétés, ainsi que l'objet JSON que le code créerait pour eux : 
      # Key-value pairs:
{'id': 'ABC123',
 'snippet.title': 'Resource title',
 'snippet.description': 'Resource description',
 'status.privacyStatus': 'private'}

# JSON object:
{
 'id': 'ABC123',
 'snippet': {
   'title': 'Resource title',
   'description': 'Resource description',
 },
 'status': {
   'privacyStatus': 'private'
 }
}

    Tous ces exemples sont conçus pour être téléchargés et exécutés en local. Pour en savoir plus, consultez les conditions préalables à l'exécution d'exemples de code complets localement 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 de 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 ce changement, l'outil fournit désormais des exemples de code complets pour les applications Python installées et les applications de serveur Web Python, qui utilisent des flux d'autorisation légèrement différents. Pour voir les exemples complets (et cette modification) :

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

    Tous ces exemples sont conçus pour être téléchargés et exécutés en local. Si vous souhaitez exécuter les exemples, consultez les instructions pour exécuter des exemples de code complets en local dans les instructions de l'outil d'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 pour préciser qu'il limite les résultats de recherche aux vidéos pouvant être visionnées dans la région spécifiée.
  • YouTube a mis à jour les logos et les icônes de marque. Les nouveaux logos "Développé avec YouTube" peuvent être téléchargés sur la page des Consignes relatives à la marque. D'autres nouveaux logos et icônes YouTube y figurent également. 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 de l'API YouTube Data est disponible pour iOS. Il explique comment utiliser l'API YouTube Data dans une application iOS simple écrite en Objective-C ou en Swift.
  • L'extrait de code interactif de l'API YouTube Data inclut désormais de la documentation expliquant certaines des fonctionnalités de l'outil :
    • Exécuter des requêtes API
    • Basculer entre les extraits de code et les exemples de code complets
    • Utiliser des fonctions standards
    • Chargement des ressources existantes (pour les méthodes de mise à jour)

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

1er juin 2017

Cette mise à jour inclut les changements suivants :

17 mai 2017

Cette mise à jour inclut les changements suivants :

  • La documentation de référence de l'API a été mise à jour pour rendre les extraits de code plus omniprésents et interactifs. Les pages qui expliquent les méthodes d'API, comme channels.list ou videos.rate, comportent désormais 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 une méthode donnée, l'outil affiche des extraits de code pour un ou plusieurs cas d'utilisation, et chaque cas d'utilisation décrit une méthode courante d'appel de 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 des exemples de code:

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

    • Basculer entre les extraits de code et les exemples complets Un extrait de code montre la partie du code qui appelle la méthode de l'API. Un exemple complet contient cet extrait, ainsi que du code récurrent pour l'autorisation et l'envoi 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é APIs Explorer sur les pages où il est disponible. (Chaque page affiche un lien qui vous permet également de charger la requête sur laquelle vous travaillez dans APIs Explorer.)

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

    • Prise en charge des requêtes API qui écrivent des données.
    • Compatibilité avec les exemples Java.
    • Code de modèle plus flexible et complet pour autoriser les utilisateurs et créer des requêtes API.

27 avril 2017

Cette mise à jour inclut les changements suivants :

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 Wikipedia qui décrivent le contenu de la chaîne. Les URL correspondent aux ID de sujet renvoyés dans la propriété topicDetails.topicIds[] de la ressource.
  • La nouvelle propriété contentDetails.videoPublishedAt de la ressource playlistItem identifie l'heure à laquelle la vidéo a été publiée sur YouTube. La ressource contient déjà la propriété snippet.publishedAt, qui identifie l'heure à laquelle l'élément a été ajouté à la playlist.
  • Comme la ressource channel, la ressource video renvoie désormais la propriété topicDetails.topicCategories[], qui contient une liste d'URL Wikipédia décrivant le contenu de la vidéo. Pour les ressources video, les URL correspondent aux ID de sujet 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 à une bande-annonce ou à un extrait de film.

27 février 2017

Comme annoncé initialement le 11 août 2016, YouTube a remplacé la liste d'ID de sujet acceptés par une liste sélectionnée. La liste complète des ID de thèmes acceptés 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 sélection a été modifiée de plusieurs façons :

  • Les sujets suivants ont été ajoutés en tant que sous-thèmes de Society :
    NomID du thème
    Entreprise/m/09s1f
    Santé/m/0kt51
    Armée/m/01h6rj
    Politique/m/05qt0
    Religion/m/06bvp
  • Le sujet Animated cartoon, qui était auparavant enfant de Entertainment, a été supprimé.
  • Le sujet Children's music, qui était auparavant un enfant de Music, a été supprimé.

Par conséquent, les sujets associés à une vidéo sont désormais toujours renvoyés dans la valeur de la propriété topicDetails.relevantTopicIds[] de la ressource video.

29 novembre 2016

Cette mise à jour inclut les changements suivants :

  • Trois petites modifications ont été apportées à la liste des ID de thèmes qui seront acceptés à 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.

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

10 novembre 2016

Cette mise à jour inclut les changements suivants :

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

    À partir du 10 février 2017, YouTube commencera à renvoyer un petit ensemble d'ID de sujet au lieu de l'ensemble d'ID beaucoup plus précis renvoyé jusqu'à présent. Notez également que nous ne pouvons garantir que les chaînes et les vidéos seront associées à des thèmes, ce qui est conforme au comportement actuel de l'API.

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

  • Remarque:Ceci est une annonce d'abandon.

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

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

  • Comme Freebase a déjà été abandonné, le guide Rechercher avec les sujets Freebase a été supprimé de la documentation. Ce guide fournissait des exemples de code montrant 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 une balise <iframe> que vous pouvez utiliser pour intégrer un lecteur qui lit la vidéo. Les nouvelles propriétés player.embedHeight et player.embedWidth identifient les dimensions du lecteur intégré. Ces propriétés ne sont renvoyées que si la requête API spécifie une valeur pour au moins l'un des paramètres maxHeight ou maxWidth. Ces deux nouveaux paramètres sont expliqués plus loin dans cette entrée de l'historique des révisions.

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

      • Le nouveau fpbRatingReasons[] indique les raisons pour lesquelles la vidéo a été classée FPB (Afrique du Sud).

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

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

      Par défaut, la hauteur de l'élément <iframe> renvoyé dans la propriété player.embedHtml est de 360 pixels. La largeur s'ajuste pour correspondre au format de la vidéo, ce qui garantit que le lecteur intégré n'affiche pas de barres noires autour de la vidéo. Par exemple, si une vidéo est au format 16:9, la largeur du lecteur sera de 640 pixels.

      Avec les nouveaux paramètres, vous pouvez spécifier que le code d'intégration doit utiliser une hauteur et/ou une largeur appropriées à la mise en page de votre application au lieu des dimensions par défaut. Le serveur d'API met à l'échelle les dimensions du lecteur de façon appropriée pour s'assurer que le lecteur intégré ne présente 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, une dimension peut toujours être inférieure à la valeur maximale autorisée pour cette dimension.

      Supposons qu'une vidéo soit au format 16:9. Par conséquent, la balise player.embedHtml contiendrait un lecteur 640x360 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 1 280 x 720.
      • Si le paramètre maxWidth est défini sur 960 et que le paramètre maxHeight n'est pas défini, l'API renvoie un lecteur 960x540.
      • Si le paramètre maxWidth est défini sur 960 et que le paramètre maxHeight est défini sur 450, l'API renvoie un lecteur de 800 x 450.

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

  • 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'une chaîne peut créer au maximum 10 rayons sans définir de données de ciblage et au maximum 100 rayons avec des données de ciblage.

      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'à l'aide de l'API. Les options de ciblage sont supprimées si vous modifiez la section de la chaîne à l'aide de 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 longueur maximale de la valeur de la propriété est de 280 caractères.

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

    • Les méthodes playlistItems.delete et playlistItems.update 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 qui permet 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 été mis à jour pour indiquer que les valeurs de paramètre 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 maximale des fichiers pour les vidéos importées est passée de 64 Go à 128 Go.

  • Erreurs nouvelles et mises à jour

    • L'API prend en charge les nouvelles erreurs suivantes:

      Type d'erreur Détail 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. L'une des raisons à l'origine de cette erreur est 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 des éléments de 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 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 la chaîne a dépassé le nombre de vidéos qu'elle peut mettre en ligne.
      forbidden (403) forbiddenEmbedSetting La méthode videos.update renvoie cette erreur pour indiquer que la requête API tente de définir un paramètre d'intégration non valide pour la vidéo. Il est possible que certaines chaînes ne soient pas autorisées à proposer des lecteurs intégrés pour les diffusions en direct. Pour en savoir plus, consultez le Centre d'aide YouTube.

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

  • Autres actualités

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

15 septembre 2016

Cette mise à jour inclut les changements suivants :

  • La mise à jour de l'historique des révisions du 11 août 2016 a décrit plusieurs modifications liées aux ID de sujet, y compris le fait que l'ensemble des ID de sujet acceptés changera à partir du 10 février 2017. La liste des thèmes qui seront acceptés sera publiée d'ici le 10 novembre 2016.

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

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

      Il s'agit d'un léger changement visant à 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 être clair, ces propriétés ne sont visibles que par un utilisateur autorisé qui récupère des données sur son 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, les ID de l'historique des vidéos regardées et de la playlist "À regarder plus tard" ne peuvent pas être récupérés via l'API.

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

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

11 août 2016

Cette mise à jour inclut les changements suivants :

  • Les nouvelles conditions d'utilisation des services d'API YouTube ("les Conditions mises à jour"), présentées en détail sur le blog YouTube Engineering and Developers, fournissent de nombreuses mises à jour des conditions d'utilisation actuelles. En plus des Conditions mises à jour, qui entreront en vigueur le 10 février 2017, cette mise à jour comprend plusieurs documents justificatifs expliquant les règles que les développeurs doivent respecter.

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

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

    • La partie topicDetails de la ressource channel identifie les thèmes associés à la chaîne.
    • La partie topicDetails de la ressource video identifie les 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 particulier.

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

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

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

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

  • Plusieurs champs et paramètres d'API ne seront plus disponibles à compter du 12 septembre 2016:

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

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

    • L'objet fileDetails.recordingLocation de la ressource video ou 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 d'une vidéo, car l'objet fileDetails parent ne peut être récupéré que par le propriétaire d'une vidéo.

13 juin 2016

Cette mise à jour inclut les changements suivants :

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

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

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

31 mai 2016

Cette mise à jour inclut les changements suivants :

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

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

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

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

  • 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 pour un coût 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. Seul le propriétaire de la vidéo peut accéder à ces parties.

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 à la méthode search.list:

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

Pour chaque cas d'utilisation, l'outil affiche les paramètres utilisés dans la requête d'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ètre 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ètre 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 de propriété valides 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:

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

  • La définition de la propriété contentDetails.relatedPlaylists.favorites de la ressource channel a été mise à jour pour indiquer que sa valeur peut contenir un ID de playlist qui fait référence à une playlist vide et qui ne peut pas être récupéré. En effet, la fonctionnalité "Vidéos favorites" est déjà obsolète. Notez que cette propriété n'est pas soumise au règlement relatif aux abandons de l'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é modifiée 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 être associée à la Google Developers Console, où vous pouvez consulter votre quota réel et son utilisation.

16 mars 2016

Cette mise à jour inclut les changements suivants :

  • Mises à jour des ressources et méthodes existantes

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

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

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

    • La réponse de l'API à une requête search.list contient désormais une propriété regionCode. Cette 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 pays ISO à deux lettres qui identifie la région. La méthode i18nRegions.list renvoie une liste des régions compatibles. La valeur par défaut est US. Si vous spécifiez une région non prise en charge, YouTube peut tout de même sélectionner une autre région plutôt que la valeur par défaut pour traiter la requête.

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

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

    • La nouvelle propriété contentDetails.contentRating.ecbmctRating de la ressource video identifie la classification d'une vidéo par le Conseil d'évaluation et de classification du ministère de la Culture et du Tourisme de 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)
        Note: R-12 ; valeur de la propriété: moctwR12
      • contentDetails.contentRating.moctwRating (Taïwan)
        Classification : R-15 ; valeur de la propriété : moctwR15

    • La propriété liveStreamingDetails.activeLiveChatId de la ressource video contient l'ID du chat en direct actif associé à la vidéo. La valeur de la propriété n'est présente que s'il s'agit d'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 est compatible avec la nouvelle valeur de propriété legal.

  • L'API prend en charge les nouvelles erreurs suivantes:

    Type d'erreur Détail de l'erreur Description
    badRequest (400) notEditable Les méthodes channelSections.insert, channelSections.update et channelSections.delete renvoient cette erreur pour indiquer que la section de chaîne spécifiée ne peut pas être créée, mise à jour 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 d'API doit spécifier une valeur pour la propriété snippet.style.
    badRequest (400) typeRequired Les méthodes channelSections.insert et channelSections.update renvoient cette erreur pour indiquer que la ressource channelSection envoyée dans la requête d'API doit spécifier une valeur pour la propriété snippet.type.
    badRequest (400) processingFailure La méthode commentThreads.list renvoie cette erreur pour indiquer que le serveur d'API n'a pas réussi à traiter la requête. Bien qu'il puisse s'agir d'une erreur temporaire, elle indique généralement que l'entrée de la requête n'est pas valide. Vérifiez la structure de la ressource commentThread dans le corps de la requête pour vous assurer qu'elle est valide.
    forbidden (403) commentsDisabled La méthode commentThreads.list renvoie cette erreur pour indiquer que les commentaires sont 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 se trouve 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 la requête après quelques heures.
    badRequest (400) invalidCategoryId La méthode videos.update renvoie cette erreur pour indiquer que la propriété snippet.categoryId de la ressource video importée spécifie un ID de catégorie non valide. Utilisez la méthode videoCategories.list pour récupérer les catégories compatibles.
    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 spécifie un titre de vidéo non valide ou vide.
    badRequest (400) invalidVideoMetadata La méthode videos.update renvoie cette erreur pour indiquer que les métadonnées de la requête ne sont pas valides. Cette erreur se produit si la requête met à jour la partie snippet d'une ressource video, mais ne définit pas de valeur pour les propriétés snippet.title et snippet.categoryId.

18 décembre 2015

Conformément à la législation de l'Union européenne (UE), vous devez publier certaines informations à l'attention des utilisateurs finaux et obtenir leur consentement dans l'UE. Par conséquent, vous devez respecter les Règles relatives au consentement de l'utilisateur dans l'UE pour les utilisateurs finaux situés dans l'Union européenne. Nous avons ajouté une notification de cette exigence dans nos Conditions d'utilisation de l'API YouTube.

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, effectuez les deux opérations suivantes:

    • 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 de l'application compatible 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 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 localisé (et la description) de la ressource.

      L'exemple d'extrait ci-dessous définit la langue par défaut de la ressource sur l'anglais. 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 existantes des données. Par exemple, si vous avez envoyé une demande ultérieure pour ajouter des données portugaises à la vidéo de l'exemple ci-dessus, la demande doit inclure les données localisées pour l'allemand, l'espagnol et le portugais.

  • Récupérer des valeurs localisées

    L'API propose deux méthodes pour récupérer les valeurs localisées d'une ressource :

    • Ajoutez le paramètre hl à votre requête channels.list, channelSections.list, playlists.list ou videos.list afin de récupérer des données localisées pour une langue d'application spécifique acceptée par le site Web YouTube. Si les détails d'une ressource localisée sont disponibles dans cette langue, l'objet snippet.localized de la ressource contient les valeurs localisées. Toutefois, si des informations localisées ne sont pas disponibles, l'objet snippet.localized contient les informations 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 était défini sur de, la ressource contiendrait les données suivantes :

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

      Toutefois, si le paramètre hl 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 localisées en français ne sont pas disponibles.

      Important:Le paramètre hl n'accepte que les valeurs qui identifient les langues d'application acceptées par le site YouTube. Pour déterminer si le texte localisé est disponible dans d'autres langues, vous devez récupérer la partie localizations de la ressource et filtrer pour déterminer si le texte localisé existe.

      Par exemple, vous devez récupérer la liste complète des localisations pour déterminer si le texte localisé est disponible en anglais des Appalaches.

    • Lors de la récupération d'une ressource, incluez localizations dans la valeur du paramètre part pour récupérer tous les détails localisés de cette ressource. Si vous récupérez des données localisées pour une langue qui n'est pas une langue actuelle de l'application YouTube, utilisez cette méthode pour récupérer toutes les localisations, puis appliquez un filtre afin de déterminer si les données localisées souhaitées existent.

  • Erreurs liées aux valeurs textuelles localisées

    L'API prend également en charge les nouvelles erreurs suivantes pour les valeurs de texte localisé:

    Type d'erreur Détail 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 d'une ressource échoue, car la propriété snippet.defaultLanguage n'est pas définie pour cette ressource. Les méthodes channels.update, channelSections.insert, channelSections.update, playlists.insert, playlists.update, videos.insert et videos.update acceptent cette erreur.
    badRequest (400) localizationValidationError Cette erreur indique qu'une des valeurs de l'objet localizations d'une ressource n'a pas pu être validée. Par exemple, cette erreur peut se produire si l'objet contient un code de langue non valide. Les méthodes channels.update, channelSections.insert, channelSections.update, playlists.insert et playlists.update acceptent cette erreur.

4 novembre 2015

Cette mise à jour inclut les changements suivants :

  • Mises à jour des ressources et méthodes existantes

    • Le paramètre order de la méthode search.list a été mis à jour pour indiquer que si vous triez les diffusions en direct par viewCount, les résultats de l'API sont triés 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 ce paramètre est défini, les seuls autres paramètres acceptés sont part, maxResults, pageToken, regionCode, relevanceLanguage, safeSearch, type (qui doit être défini sur video) et fields. Cette mise à jour ne reflète pas un changement dans le comportement de l'API.

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

      Ce changement ne reflète pas un changement au niveau du comportement de l'API.

    • La définition de la propriété status.publishAt de la ressource video a été mise à jour pour prendre en compte les éléments suivants:

      • 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 planifie la publication d'une vidéo à un moment précis, la vidéo est publiée immédiatement. Par conséquent, l'effet de la définition de la propriété status.publishAt sur une date et une heure passées est le même que celui de la modification de la valeur privacyStatus de la vidéo de private à public.

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

    • La définition de brandingSettings.channel.keywords de la ressource channel a été mise à jour pour refléter correctement que la valeur de la propriété contient une liste de chaînes séparées par des espaces et non une liste séparée par des virgules, comme indiqué précédemment. Cette mise à jour ne reflète pas un changement dans le 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 pas de ressource thumbnail. Auparavant, la documentation indiquait que vous ne devez pas fournir de corps de requête lorsque vous appelez cette méthode. Cette mise à jour ne reflète pas un changement au niveau du comportement de l'API.

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

  • Nouvelles erreurs et mises à jour d'erreurs

    • L'API prend désormais en charge les erreurs suivantes:

      Informations sur les erreurs
      activities.insert
      Code de réponse HTTPbadRequest (400)
      MotifinvalidMetadata
      DescriptionLa propriété kind ne correspond pas au type d'ID fourni.
      commentThreads.update
      comments.insert
      comments.update
      Code de réponse HTTPbadRequest (400)
      MotifcommentTextTooLong
      DescriptionLa propriété snippet.topLevelComment.snippet.textOriginal de la ressource comment en cours d'insertion ou de mise à jour contient trop de caractères.
      playlistItems.insert
      playlistItems.update
      Code de réponse HTTPforbidden (403)
      MotifplaylistItemsNotAccessible
      DescriptionLa demande n'est pas 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 HTTPbadRequest (400)
      MotifplaylistForbidden
      DescriptionCette opération est interdite ou la demande n'est pas correctement autorisée.
      search.list
      Code de réponse HTTPbadRequest (400)
      MotifinvalidLocation
      DescriptionLe format de la valeur des paramètres location et/ou locationRadius n'est pas valide.
      search.list
      Code de réponse HTTPbadRequest (400)
      MotifinvalidRelevanceLanguage
      DescriptionLa valeur du paramètre relevanceLanguage n'est pas au bon format.
      subscriptions.insert
      Code de réponse HTTPbadRequest (400)
      MotifsubscriptionForbidden
      DescriptionCette erreur se produit lorsque l'une des conditions suivantes est remplie :
      • L'abonnement que vous essayez de créer existe déjà
      • Vous avez déjà atteint le nombre maximal d'abonnements
      • Vous essayez de vous abonner à votre propre chaîne, ce qui n'est pas autorisé.
      • Vous avez créé trop d'abonnements récemment. Vous devez attendre quelques heures avant de réessayer.
      videos.update
      Code de réponse HTTPbadRequest (400)
      MotifinvalidDefaultBroadcastPrivacySetting
      DescriptionLa requête tente de définir un paramètre de confidentialité non valide pour la diffusion par défaut.

28 août 2015

Cette mise à jour inclut les changements suivants :

  • Mises à jour des ressources et méthodes existantes

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

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

7 août 2015

Cette mise à jour inclut les changements suivants :

  • Mises à jour des ressources et méthodes existantes

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

      Plus précisément, la définition explique désormais que si une balise contient un espace, le serveur d'API gère la valeur de la balise comme si elle était placée entre guillemets, et les guillemets sont pris en compte dans la limite de caractères. Par conséquent, pour les limites de caractères, la balise Foo-Baz contient sept caractères, mais 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 ses réponses doivent également être publiés sur le profil Google+ de l'auteur. Si une requête envoie le paramètre, le serveur d'API l'ignore, mais traite sinon la demande.

18 juin 2015

Cette mise à jour inclut les changements suivants :

  • Mises à jour des ressources et méthodes existantes

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

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

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

    • Les méthodes captions.delete, captions.download, captions.insert, captions.list et captions.update 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 qui permet d'accéder au champ d'application https://www.googleapis.com/auth/youtubepartner.

  • Nouvelles erreurs et mises à jour d'erreurs

    • L'API prend désormais en charge les erreurs suivantes:

      Informations sur les erreurs
      videos.rate
      Code de réponse HTTPbadRequest (400)
      MotifemailNotVerified
      DescriptionL'utilisateur doit confirmer son adresse e-mail avant d'évaluer la vidéo.
      videos.rate
      Code de réponse HTTPbadRequest (400)
      MotifvideoPurchaseRequired
      DescriptionSeuls les utilisateurs qui louent une vidéo en location peuvent le faire.

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

27 avril 2015

Cette mise à jour inclut les changements suivants :

  • Nouvelles ressources et méthodes

    • La nouvelle ressource videoAbuseReportReason contient des informations sur la raison pour laquelle une vidéo est signalée pour contenir du 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 contenant du contenu abusif. Le corps de la requête contient un objet JSON qui spécifie la vidéo signalée et le motif pour lequel la vidéo est considérée comme présentant 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 a également été mis à jour avec 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 censée prendre en charge. Ces fonctionnalités sont également toutes expliquées dans le guide de migration.

  • Mises à jour des ressources et méthodes existantes

    • Le nouveau paramètre de filtre forDeveloper de la méthode search.list limite la recherche aux vidéos importées via l'application ou le site Web du développeur. Le paramètre forDeveloper peut être utilisé conjointement avec des paramètres de recherche facultatifs tels que le paramètre q.

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

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

      Cette nouvelle fonctionnalité offre des fonctionnalités semblables, mais pas identiques, à celles des balises pour les développeurs compatibles avec la version 2 de l'API.

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

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

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

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

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

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

  • Nouvelles erreurs et mises à jour d'erreurs

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

      Type d'erreur Détail de l'erreur Description
      badRequest (400) targetInvalidCountry Les méthodes channelSections.insert et channelSections.update renvoient cette erreur si la ressource channelSection insérée contenait une valeur non valide pour la propriété targeting.countries[].
      badRequest (400) targetInvalidLanguage Les méthodes channelSections.insert et channelSections.update renvoient cette erreur si la ressource channelSection insérée contenait une valeur non valide pour la propriété targeting.languages[].
      badRequest (400) targetInvalidRegion Les méthodes channelSections.insert et channelSections.update renvoient cette erreur si la ressource channelSection insérée contenait une valeur non valide pour la propriété targeting.regions[].
      badRequest (400) operationNotSupported La méthode comments.insert renvoie cette erreur si l'utilisateur de l'API n'est pas en mesure d'insérer un commentaire en réponse au commentaire de premier niveau identifié par la propriété snippet.parentId. Dans une ressource commentThread, la propriété snippet.canReply indique si le 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 chaîne non valide.
      badRequest (400) subscriptionForbidden La méthode subscriptions.insert renvoie cette erreur si l'utilisateur de l'API tente de s'abonner à sa propre chaîne.

    • La méthode captions.update n'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 qui utilisent toujours la fonctionnalité de commentaires de l'API v2.

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

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

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

9 avril 2015

Cette mise à jour inclut les changements suivants :

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

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

      Le commentaire de niveau supérieur 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. De plus, certaines réponses ne sont pas associées à des commentaires.

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

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

    • Une ressource comment contient des informations sur un seul commentaire YouTube. Une ressource comment peut représenter un commentaire sur une vidéo ou une chaîne. Il peut également s'agir d'un commentaire général ou d'une réponse à un commentaire général.

      L'API prend en charge 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 spécifique.
      • comments.insert : créez une réponse à un commentaire existant.
      • comments.update : permet de modifier un commentaire.
      • comments.markAsSpam : permet de signaler un ou plusieurs commentaires comme spam.
      • comments.setModerationStatus : définit l'état de modération d'un ou de plusieurs commentaires. Par exemple, vous pouvez rendre un commentaire public ou le refuser comme inapproprié. La requête API doit être autorisée par le propriétaire de la chaîne ou de la vidéo associée aux commentaires.
      • comments.delete : 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 sur le Web. Votre serveur de rappel PubSubHubBub peut recevoir des notifications de flux Atom lorsqu'une chaîne effectue l'une des actions suivantes :

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

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

  • 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 qui acceptait auparavant le champ d'application https://www.googleapis.com/auth/youtube.

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

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

  • La méthode subscriptions.insert n'est plus compatible avec l'erreur subscriptionLimitExceeded, qui indiquait auparavant que l'abonné identifié avec la requête avait dépassé la limite de 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 propose des méthodes permettant de lister, insérer, mettre à jour, télécharger et supprimer des pistes de sous-titres.

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

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

    Ce nouveau champ d'application accorde les mêmes droits d'accès que le champ d'application https://www.googleapis.com/auth/youtube. D'un point de vue fonctionnel, ces deux champs d'application sont 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 intitulé Nouveautés de l'API v3, qui liste les fonctionnalités compatibles avec l'API v3 et non avec l'API v2. Les mêmes fonctionnalités étaient auparavant proposées 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 intégrées aux vidéos d'une chaîne est également disponible dans l'onglet Chaînes (profils).

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

  • 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 sont pas compatibles avec l'API v3:

    • Récupérer des recommandations de vidéos : l'API v3 ne récupère pas une liste contenant uniquement les vidéos recommandées pour l'utilisateur actuel de l'API. Toutefois, vous pouvez utiliser l'API v3 pour trouver des vidéos recommandées. Pour ce faire, appelez la méthode activities.list et définissez 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 la raison pour laquelle la vidéo a été recommandée. Notez que rien ne garantit que la réponse contiendra un nombre précis de vidéos recommandées.

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

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

      Dans la réponse de l'API, une ressource correspond à une nouvelle vidéo d'abonnement si la valeur de la propriété snippet.type est upload. Notez que rien ne garantit que la réponse contiendra un nombre précis de nouvelles vidéos réservées aux abonnés.

    • Compatibilité avec les flux RSS

    • Notifications push pour les mises à jour de flux : l'API v2 acceptait les notifications push à l'aide du protocole Simple Update Protocol (SUP) ou de PubSubHubbub pour surveiller les flux d'activité des utilisateurs YouTube. Vous receviez des notifications lorsque vous vous abonniez à une chaîne, et lorsque des vidéos étaient notées, partagées, ajoutées aux favoris, commentées ou mises en ligne.

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

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

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

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

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

      Il existe quelques exceptions. Une nouvelle mise en ligne, une vidéo favorite, une vidéo likée ou une vidéo récemment regardée est automatiquement ajoutée en tant que premier élément (snippet.position=0) pour les types de playlists suivants. Ainsi, chacune de ces listes est triée de façon efficace, du plus récent au plus ancien, en fonction de l'heure à laquelle les éléments ont été ajoutés à la liste.

      • vidéos mises en ligne par les 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 dernier dans cette liste. Elle est donc triée de l'élément le plus ancien au plus récent.

    • Traitement par lot : l'API v3 prend en charge l'un des cas d'utilisation du traitement par lot que l'API v2 prenait en charge. Les méthodes channels.list, channelSections.list, guideCategories.list, playlistItems.list, playlists.list, subscriptions.list, videoCategories.list et videos.list de l'API v3 acceptent toutes un paramètre id, qui permet de spécifier une liste d'ID (ID de vidéo, ID de chaîne, etc.) séparés par une virgule. Ces méthodes vous permettent de récupérer une liste de plusieurs ressources avec une seule requête.

    Avec 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 de l'API (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 ont été abandonnées:

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

    Remarque : Aucune de ces propriétés n'était soumise à la politique d'abandon des API.

  • La nouvelle propriété contentDetails.contentRating.contentDetails.contentRating.djctqRatingReasons de la ressource video identifie les raisons pour lesquelles la vidéo a été classée DJCQT (Brésil).

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

    Type d'erreur Détail 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 de tri manuel. Par exemple, les éléments d'une playlist peuvent être triés par date ou par popularité. Pour résoudre cette erreur, supprimez l'élément snippet.position de la ressource envoyée dans le corps de la requête. Si vous souhaitez que l'élément de la playlist ait une position spécifique dans la liste, vous devez d'abord définir l'ordre d'affichage de la playlist sur Manuel. Vous pouvez ajuster ce paramètre dans le Gestionnaire de vidéos YouTube.
    forbidden (403) channelClosed La méthode playlists.list renvoie cette erreur si le paramètre channelId de la requête spécifie 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 avec la requête ou si celle-ci 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 spécifique.

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

  • Le guide de migration de l'API YouTube Data (v3) a également été mis à jour pour indiquer l'abandon des champs spéciaux relatifs aux flux et aux métadonnées fournis par la version 2 de l'API pour décrire des films, des bandes-annonces, des émissions télévisées, des saisons et des épisodes de séries télévisées.

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

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

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

11 novembre 2014

Cette mise à jour inclut les changements suivants :

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

    Important:Dans de nombreux cas, vous pouvez utiliser d'autres méthodes d'API pour récupérer des informations à un coût de quota inférieur. Prenons l'exemple des deux méthodes suivantes pour 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 playlist des vidéos mises en ligne par 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 de propriété valides sont les suivantes :

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

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

    • La propriété invideoPromotion.useSmartTiming indique si la campagne promotionnelle du canal utilise la fonctionnalité "Timing intelligent". Cette fonctionnalité s'efforce de diffuser des publicités à un moment de la vidéo où les utilisateurs sont plus susceptibles de cliquer dessus et moins susceptibles de perturber l'expérience de visionnage. Cette fonctionnalité sélectionne également une seule promotion à afficher sur chaque vidéo.

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

    Si vous essayez de mettre à jour la partie snippet d'une ressource video 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 par l'Office of Film and Literature Classification (OFLC) de Nouvelle-Zélande, est désormais compatible avec deux nouvelles classifications : oflcRp13 et oflcRp16. Ils correspondent respectivement aux notes RP13 et RP16.

  • La méthode channelBanners.insert prend désormais en charge l'erreur suivante:

    Type d'erreur Détail de l'erreur Description
    badRequest bannerAlbumFull L'album d'illustrations 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 à http://photos.google.com, accéder à la page des albums, puis supprimer certaines images de cet album.

12 septembre 2014

Cette mise à jour inclut les changements suivants :

13 août 2014

Cette mise à jour inclut les changements suivants :

  • La méthode subscriptions.insert prend désormais en charge l'erreur suivante:

    Type d'erreur Détail de l'erreur Description
    badRequest subscriptionLimitExceeded L'abonné identifié avec la requête a dépassé la limite de débit de l'abonnement. Vous pourrez essayer d'autres abonnements 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 est officiellement obsolète depuis le 4 mars 2014. Ce guide a pour but de vous aider à migrer les applications qui utilisent encore l'API v2 vers la version la plus récente de l'API.

8 juillet 2014

Cette mise à jour inclut les changements suivants :

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

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

18 juin 2014

Cette mise à jour inclut les changements suivants :

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 des résultats en fonction de la zone géographique. 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 à laquelle le lieu associé à une vidéo peut se trouver à partir du centre de la zone pour que la vidéo soit toujours incluse dans les résultats de recherche.

13 mai 2014

Cette mise à jour inclut les changements suivants :

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

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

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

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

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

  • La définition du paramètre q pour la méthode search.list a été modifiée 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. Vous pouvez également utiliser l'opérateur booléen OR (|) pour rechercher des vidéos associées à l'un des différents termes de recherche.

  • La définition de la propriété pageInfo.totalResults renvoyée dans une réponse d'API à un appel search.list a été mise à jour pour indiquer que la valeur est une approximation et qu'elle ne représente pas nécessairement une valeur exacte. De plus, la valeur maximale est de 1 000 000. N'utilisez pas 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 à ces méthodes.

2 mai 2014

Cette mise à jour inclut les changements suivants :

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

    L'API propose une méthode permettant de lister les langues d'application compatibles. Les langages compatibles peuvent être utilisés comme valeur du paramètre hl lors de l'appel de méthodes d'API telles que videoCategories.list et guideCategories.list.

  • La nouvelle ressource i18nRegion identifie une zone géographique qu'un utilisateur YouTube peut sélectionner comme région de contenu préférée. La région de contenu peut également être appelée "locale de contenu". Pour le site Web YouTube, une région de contenu peut être automatiquement sélectionnée grâce à des méthodes heuristiques comme le domaine YouTube ou l'adresse IP de l'utilisateur. De plus, un utilisateur peut également sélectionner manuellement la région de contenu souhaitée depuis le pied de page du site YouTube.

    L'API propose une méthode permettant de lister les régions de contenu compatibles. Les codes régionaux acceptés peuvent être utilisés comme valeur du paramètre regionCode lors de l'appel de méthodes d'API telles que search.list, videos.list, activities.list et videoCategories.list.

7 avril 2014

Cette mise à jour inclut les changements suivants :

  • La nouvelle ressource channelSection contient des informations sur un ensemble de vidéos qu'une chaîne a choisi de mettre en avant. Par exemple, une section peut présenter les dernières vidéos d'une chaîne, 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 une liste de sections de chaîne pour la chaîne de l'utilisateur authentifié en spécifiant un ID de chaîne particulier ou une liste d'ID de section de chaîne uniques.

    La documentation sur les erreurs a également été mise à jour pour décrire les messages d'erreur pris en charge 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 n'est 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 n'est 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é modifiée pour indiquer qu'il 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, car les requêtes videos.rate qui définissent ce paramètre renvoient une erreur 500.

31 mars 2014

Cette mise à jour inclut les changements suivants :

13 mars 2014

Cette mise à jour inclut les changements suivants :

  • L'API est désormais compatible avec la partie contentOwnerDetails pour les ressources channel. Cette nouvelle section contient des données sur la chaîne pertinentes pour les partenaires YouTube qui y sont 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 du propriétaire de contenu et de la chaîne. Notez que cette nouvelle partie n'est pas soumise au règlement relatif aux abandons.

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

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

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

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

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

  • L'API prend désormais en charge les erreurs suivantes:

    Type d'erreur Détail 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 tentez 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 chaîne 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 spécifie un nombre d'éléments mis en avant supérieur au nombre autorisé.
    forbidden (403) promotedVideoNotAllowed La méthode channels.update renvoie cette erreur si la propriété invideoPromotion.items[].id.videoId spécifie un ID vidéo qui est introuvable ou qui ne peut pas être utilisé en tant qu'élément promu.
    forbidden (403) websiteLinkNotAllowed La méthode channels.update renvoie cette erreur si la propriété invideoPromotion.items[].id.websiteUrl spécifie une URL non autorisée.
    required (400) requiredTimingType La méthode channels.update renvoie cette erreur si une requête ne spécifie pas de paramètres de synchronisation par défaut pour le moment où YouTube doit afficher un élément sponsorisé.
    required (400) requiredTiming La méthode channels.update doit spécifier un objet invideoPromotion.items[].timing pour chaque article mis en avant.
    required (400) requiredWebsiteUrl La méthode channels.update doit spécifier une propriété invideoPromotion.items[].id.websiteUrl pour chaque élément mis en avant.
    badRequest (400) invalidPublishAt La méthode videos.insert renvoie cette erreur si les métadonnées de la requête spécifient une heure de publication planifiée non valide.

4 mars 2014

Cette mise à jour inclut les changements suivants :

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 clairement 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. À la place, vous pouvez définir une valeur pour zéro ou un paramètre de filtre.

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

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

  • La taille minimale des images de bannière de chaîne importées a été réduite à 2 048 x 1 152 pixels. (Auparavant, la taille minimale était de 2 120 x 1 192 pixels.) En outre, notez que la documentation de la ressource channel spécifie les tailles maximales de toutes les images de bannière diffusées à partir de l'API. Par exemple, la taille maximale de l'image brandingSettings.image.bannerTvImageUrl pour les applications télévisées 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'affichage de votre illustration de chaîne 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 comporter plus de 1 000 caractères.
    • La propriété brandingSettings.channel.featuredChannelsTitle ne doit pas comporter plus de 30 caractères.
    • La propriété brandingSettings.channel.featuredChannelsUrls[] peut désormais répertorier jusqu'à 100 canaux.
    • Si elle est définie, la valeur de la propriété brandingSettings.channel.unsubscribedTrailer doit spécifier l'ID de la 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 est affiché lors de la diffusion de la promotion. Il ne peut être défini que si la requête API qui définit la valeur de la propriété est effectuée au nom du propriétaire du contenu à l'aide du paramètre onBehalfOfContentOwner.

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

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

  • Les nouvelles propriétés contentDetails.contentRating.catvRating et contentDetails.contentRating.catvfrRating identifient les classifications attribuées à une vidéo selon le système canadien de classification des programmes télévisés et le système de classification de la Régie du cinéma, qui est utilisé au Québec, respectivement.

  • La nouvelle propriété snippet.assignable de la ressource videoCategory indique si des vidéos mises à jour ou des vidéos nouvellement 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 :

24 octobre 2013

Cette mise à jour inclut les changements suivants :

  • L'API inclut deux fonctionnalités supplémentaires conçues pour vous aider à trouver et à mettre en avant du contenu diffusé en direct:

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

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

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

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

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

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

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

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

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

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

  • La propriété contentDetails.contentRating.tvpgRating de la ressource video prend désormais en charge la valeur pg14, ce 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 classifications supplémentaires :

    • mibacVap (VAP) : les enfants doivent être accompagnés d'un adulte.
    • mibacVm6 (V.M.6) : réservé aux personnes de 6 ans et plus.
    • mibacVm12 (V.M.12) : réservé aux personnes de 12 ans et plus.

  • 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. Vous ne pouvez définir ce champ que si la requête API qui définit la valeur est effectuée au nom du propriétaire du contenu. Pour en savoir plus, consultez le paramètre onBehalfOfContentOwner.

1er octobre 2013

Cette mise à jour inclut les changements suivants :

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

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

    Par défaut, la chaîne est la même que celle pour laquelle les données de promotion dans des vidéos sont définies. Toutefois, vous pouvez promouvoir la vidéo la plus récente mise en ligne sur une autre chaîne en définissant la valeur de la nouvelle propriété invideoPromotion.items[].id.recentlyUploadedBy sur l'ID de cette chaîne.

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

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

    • Pour une ressource video, une valeur upcoming indique que la vidéo est une diffusion en direct qui n'a pas encore commencé, tandis qu'une valeur active indique qu'il s'agit d'une diffusion en direct en cours.
    • Pour une ressource channel, la valeur upcoming indique qu'une diffusion programmée de la chaîne n'a pas encore commencé, tandis 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 chaîne YouTube de la chaîne à laquelle l'image du filigrane est associée, la propriété targetChannelId spécifie désormais cette valeur elle-même. Par conséquent, la propriété targetChannelId.value de la ressource a été supprimée.

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

  • La méthode search.list prend désormais en charge le paramètre eventType, qui limite la recherche aux événements de diffusion actifs, à venir ou terminés.

  • La nouvelle propriété contentDetails.contentRating.mibacRating indique la classification attribuée à une vidéo par le Ministero dei Beni e delle Attivita cultureli e del Turismo.

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

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

27 août 2013

Cette mise à jour inclut les changements suivants :

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

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

    La documentation sur les erreurs décrit les messages d'erreur compatibles avec 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 les internautes.

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

  • La méthode videos.list 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 est un code pays ISO 3166-1 alpha-2.

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

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

15 août 2013

Cette mise à jour inclut les changements suivants :

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

    • L'API permet désormais de spécifier un site Web en tant qu'élément mis en avant. 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 liens vers des sites Web associés, des sites marchands ou des sites de réseaux sociaux. Consultez les instructions du centre d'aide YouTube pour les sites Web associés et les sites marchands afin d'en savoir plus sur l'activation des liens pour vos contenus.

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

    • Les propriétés liées aux paramètres de codes temporels pour l'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 temps pour chaque élément promu de la liste invideoPromotion.items[].

      • Le nouvel objet invideoPromotion.defaultTiming spécifie les paramètres de délai par défaut pour votre promotion. Ces paramètres définissent quand un article sponsorisé 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 un élément promu à l'aide de l'objet invideoPromotion.items[].timing.

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

    • 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 est désormais compatible avec les paramètres onBehalfOfContentOwner et onBehalfOfContentOwnerChannel. Ces deux paramètres sont déjà acceptés pour 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:

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

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

    Type d'erreur Détail de l'erreur Description
    badRequest invalidMine Vous ne pouvez pas utiliser le paramètre mine dans les demandes 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 qu'une des chaînes du partenaire en fournissant le paramètre onBehalfOfContentOwnerChannel, le cas échéant, pour la méthode appelée.

8 août 2013

Cette mise à jour inclut les changements suivants :

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 proéminente 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, par exemple #2793e6.

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

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

    • Le paramètre chart identifie le graphique que vous souhaitez récupérer. Actuellement, la seule valeur acceptée est mostPopular. Notez que le paramètre chart est un paramètre de filtre. Il ne peut donc pas être utilisé dans la même demande que d'autres paramètres de filtrage (id et myRating).
    • Le paramètre videoCategoryId identifie la catégorie de vidéos 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 de ces sujets peuvent être mentionnés dans la vidéo ou y apparaître.

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

  • L'objet contentDetails.contentRating de la ressource video spécifie les classifications attribuées à une vidéo 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 de classification qui indique que la vidéo n'a pas été classée. Notez que pour les classifications MPAA, la classification "non classé" est souvent utilisée pour identifier les versions non coupées de films dont 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 les utilisateurs de moins de 18 ans. Si la propriété est absente ou si sa valeur est vide, le contenu n'a pas été identifié comme soumis à une limite d'âge.

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

  • Les méthodes channelBanners.insert, channels.update, videos.getRating et videos.rate sont désormais compatibles avec le paramètre onBehalfOfContentOwner. Ce paramètre indique que l'utilisateur authentifié agit pour le compte 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 indiquer qu'elle peut être utilisée pour mettre à jour l'objet brandingSettings de la ressource channel et ses propriétés enfants. La documentation présente également la liste mise à jour des propriétés que vous pouvez définir pour l'objet invideoPromotion de la ressource channel.

  • Le error documentation décrit les nouvelles erreurs suivantes:

    Type d'erreur Détail de l'erreur Description
    forbidden accountDelegationForbidden Cette erreur n'est pas spécifique à une méthode API particulière. Indique que l'utilisateur authentifié n'est pas autorisé à agir au nom du compte Google spécifié.
    forbidden authenticatedUserAccountClosed Cette erreur n'est pas spécifique à une méthode API particulière. 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 a été clôturé.
    forbidden authenticatedUserAccountSuspended Cette erreur n'est pas spécifique à une méthode API particulière. Il indique que le compte YouTube de l'utilisateur authentifié est suspendu. Si l'utilisateur agit au nom d'un autre compte Google, cette erreur indique que cet autre compte est suspendu.
    forbidden authenticatedUserNotChannel Cette erreur n'est pas spécifique à une méthode API particulière. Elle 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 API particulière. L'utilisateur du CMS n'est pas autorisé à agir au nom du propriétaire de contenu spécifié.
    notFound contentOwnerAccountNotFound Cette erreur n'est pas spécifique à une méthode API particulière. Le compte de propriétaire de contenu spécifié est introuvable.
    badRequest invalidPart Cette erreur n'est pas spécifique à une méthode API particulière. Le paramètre part de la requête spécifie les 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 indisponible.
    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 de playlist contiennent désormais la propriété snippet.tags. La propriété ne sera renvoyée qu'aux utilisateurs autorisés qui récupèrent des données sur leurs propres playlists. Les utilisateurs autorisés peuvent également définir des tags de playlist lors de l'appel des méthodes 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. Notez que lorsque ce paramètre est utilisé dans un appel à la méthode videos.insert, la requête doit également spécifier une valeur pour le nouveau paramètre onBehalfOfContentOwnerChannel, qui identifie la chaîne à laquelle la vidéo sera ajoutée. La chaîne doit être associée au propriétaire de contenu spécifié par le paramètre onBehalfOfContentOwner.

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

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

    Plus précisément, ce paramètre permet désormais à un partenaire de contenu d'insérer, de mettre à jour ou de supprimer des vidéos sur n'importe quelle chaîne YouTube qu'il possède.

  • Le error documentation décrit les nouvelles erreurs suivantes:

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

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

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

22 mai 2013

Cette mise à jour inclut les changements suivants :

14 mai 2013

Cette mise à jour inclut les changements suivants :

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

  • La page qui liste des exemples de code Python inclut désormais des exemples d'ajout d'un abonnement, de création d'une playlist et de mise à jour d'une vidéo.

10 mai 2013

Cette mise à jour inclut les changements suivants :

8 mai 2013

Cette mise à jour inclut les changements suivants :

  • Les ressources de chaîne acceptent désormais l'objet inVideoPromotion, qui encapsule les informations sur une campagne promotionnelle associée à la chaîne. Une chaîne peut utiliser une campagne promotionnelle dans des vidéos pour afficher les miniatures d'une vidéo sponsorisée dans le lecteur vidéo pendant les lectures 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 d'une campagne promotionnelle dans des vidéos d'une chaîne. Notez que la méthode n'accepte que les mises à jour de la partie invideoPromotion de la ressource channel et n'est pas encore compatible avec les mises à jour d'autres parties de cette ressource.

2 mai 2013

Cette mise à jour inclut les changements suivants :

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

  • Les ressources d'abonnement sont désormais compatibles avec la partie subscriberSnippet. Cet objet 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 attribuées par l'utilisateur authentifié à une liste d'une ou plusieurs vidéos.

  • Le nouveau paramètre myRating de la méthode videos.list vous permet de récupérer une liste de vidéos notées par l'utilisateur authentifié (like ou dislike).

    Le paramètre myRating et le paramètre id sont désormais 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 d'une 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 prendre en charge la pagination. Notez toutefois que les paramètres de pagination ne sont compatibles qu'avec les requêtes utilisant le paramètre myRating. (Les paramètres et informations de pagination ne sont pas acceptés pour les requêtes qui utilisent le paramètre id.)

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

    • La ressource youtube#videoListResponse, qui est renvoyée en réponse à une requête videos.list, contient désormais l'objet pageInfo, qui 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 de paramètre sur true pour que YouTube améliore automatiquement la luminosité et la couleur de la vidéo.
    • stabilize : définissez cette valeur de paramètre sur true pour que YouTube ajuste la vidéo en supprimant les tremblements causés par les mouvements de la caméra.

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

    • playlistItem : cette propriété indique le nom de la chaîne sur laquelle l'élément de la playlist a été ajouté.
    • playlist : cette propriété indique le nom de la chaîne sur laquelle la playlist a été créée.
    • subscription : la propriété spécifie le nom de la chaîne à laquelle vous êtes abonné.

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

  • 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é vise à 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 une valeur possible pour les propriétés suivantes:

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

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

19 avril 2013

Cette mise à jour inclut les changements suivants :

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

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

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

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

    Notez que cette modification n'affecte pas vraiment les ressources existantes qui renvoient des vignettes. Les images miniatures sont renvoyées dans ces ressources de la même manière que précédemment, mais la documentation indique désormais les noms des différentes tailles de miniatures que l'API peut renvoyer.

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

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

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

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

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

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

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

    • Le paramètre order permet désormais de trier les résultats par ordre alphabétique en fonction du titre (order=title) ou du 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, qui sont listées dans le tableau ci-dessous :

    Type d'erreur Détail 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 compatibles.
    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é spécifie le nom de la chaîne responsable de l'activité.
    • search : cette propriété indique le nom du canal associé à la ressource identifiée dans les résultats de recherche.
    • video : cette propriété spécifie 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 une recherche de chaînes pour récupérer toutes les chaînes ou uniquement des émissions.

    • Le paramètre videoType vous permet de limiter la recherche de vidéos à toutes les vidéos, ou uniquement aux films ou uniquement aux épisodes d'émissions.

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

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

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

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

      Les méthodes channels.list, search.list, videos.delete, videos.list et videos.update acceptent toutes 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, compatible avec la méthode search.list, indique à l'API de limiter les résultats de recherche aux seules ressources appartenant au propriétaire du contenu spécifié par le paramètre onBehalfOfContentOwner.

25 février 2013

Cette mise à jour inclut les changements suivants :

  • L'API prend en charge plusieurs nouvelles parties et propriétés pour les ressources video :

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

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

      Toutes ces informations 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 de la ressource video définit toutes les propriétés que chaque partie contient.

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

      • L'objet processingProgress contient des informations sur la progression du traitement du fichier vidéo mis en ligne par YouTube. Les propriétés de l'objet identifient l'état actuel du traitement et estiment le temps restant avant la fin du traitement de la vidéo par YouTube. Cette partie indique également si différents types de données ou de contenus, tels que les détails du fichier ou les images 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 du traitement du fichier vidéo mis en ligne par YouTube.

      • L'objet suggestions contient des suggestions qui identifient les possibilités d'améliorer la qualité 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 3D.
      • definition : indique si la vidéo est disponible en définition standard ou haute définition.
      • caption : indique si des sous-titres sont disponibles pour la vidéo.
      • licensedContent : indique si la vidéo contient du contenu revendiqué par un partenaire de contenu YouTube.

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

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

  • La définition du paramètre part a été mise à jour pour les méthodes videos.list, videos.insert et videos.update afin de lister les nouvelles parties ajoutées décrites ci-dessus, ainsi que la partie recordingDetails, qui avait é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 de vignette 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 récupérer uniquement l'élément de la 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 ne figure pas 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 inclut des erreurs générales, qui peuvent se produire pour plusieurs méthodes d'API différentes, ainsi que des erreurs spécifiques à une méthode.

16 janvier 2013

Cette mise à jour inclut les changements suivants :

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

  • Une ressource activity peut désormais signaler une action channelItem, qui se produit lorsqu'YouTube ajoute une vidéo à une chaîne YouTube générée automatiquement. (YouTube identifie algorithmiquement les sujets qui sont populaires sur le site Web de 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 Renvoie les ressources pour le pays spécifié.
    videoCategoryId string Filtrez les résultats de recherche vidéo pour n'afficher que les vidéos associées à la catégorie de vidéos spécifiée.
    videoEmbeddable string Filtrez les résultats de recherche vidéo pour n'afficher 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 encodables en iFrame.
    videoSyndicated string Filtrez les résultats de recherche vidéo pour n'afficher que les vidéos pouvant être lues en dehors de YouTube.com. Définissez la valeur du paramètre sur true pour ne récupérer que les vidéos syndiquées.

  • Plusieurs ressources 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 la playlist attribué par YouTube comme identifiant unique de l'élément dans la playlist.
    activity contentDetails.channelItem object Objet contenant des informations sur une ressource ajoutée à une chaîne. Cette propriété n'est présente que si snippet.type est défini sur channelItem.
    activity contentDetails.channelItem.resourceId object Objet qui identifie la ressource qui a été ajoutée au canal. Comme les autres propriétés resourceId, elle contient une propriété kind qui spécifie le type de ressource, par exemple "vidéo" ou "playlist". Il contient également une seule 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 les informations sur le niveau de confidentialité de la chaîne.
    channel status.privacyStatus string Le niveau de confidentialité de la chaîne Les valeurs valides sont private et public.
    playlist contentDetails object Cet objet contient des métadonnées sur le contenu de la playlist.
    playlist contentDetails.itemCount unsigned integer Nombre de vidéos dans la playlist.
    playlist player object Cet objet contient les informations que vous pouvez utiliser pour lire la playlist dans un lecteur intégré.
    playlist player.embedHtml string Une balise <iframe> qui intègre un lecteur vidéo qui lit la playlist.
    video recordingDetails object Cet objet encapsule des informations qui identifient ou décrivent le lieu et l'heure à laquelle la vidéo a été enregistrée.
    video recordingDetails.location object Cet objet contient des informations de géolocalisation associées à la vidéo.
    video recordingDetails.location.latitude double Latitude en degrés.
    video recordingDetails.location.longitude double Longueur en degrés.
    video recordingDetails.location.elevation double Altitude au-dessus de la Terre, en mètres.
    video recordingDetails.locationDescription string Description textuelle du lieu où la vidéo a été enregistrée.
    video recordingDetails.recordingDate datetime Date et heure 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 qui sont mises à jour en fonction des valeurs du corps de la requête. Le tableau ci-dessous liste ces méthodes, ainsi que les propriétés obligatoires ou modifiables.

    Remarque:Il est possible que la documentation relative aux 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 d'erreur playlistAlreadyExists si vous essayez de create ou de mettre à jour une playlist dont le titre est identique à celui d'une playlist déjà présente sur la même chaîne.

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

    Méthode Type d'erreur Détail 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 de suppression de l'élément de playlist spécifié n'est pas autorisée.
    videoCategories.list notFound videoCategoryNotFound La catégorie de vidéos identifiée par le paramètre id est introuvable. Utilisez la méthode videoCategories.list pour récupérer une liste de valeurs valides.