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 contiennent 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 croire qu'une personne réelle dit ou fait 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 contient du contenu A/S, définissez la propriété status.containsSyntheticMedia. Cette propriété peut être définie lors de l'appel des méthodes videos.insert ou videos.update. Si elle est définie, la propriété est renvoyée dans la ressource video.

30 avril 2024

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

Cette mise à jour inclut les changements suivants :

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

13 mars 2024

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

Cette mise à jour inclut les changements suivants :

Le paramètre sync pour les méthodes captions.insert et captions.update est obsolète. YouTube ne sera plus compatible avec 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 titre est plus long.

7 mars 2024

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

La propriété de ressource channel brandingSettings.channel.moderateComments est obsolète. YouTube ne sera plus compatible avec 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 disponible sur YouTube et n'est plus prise en charge via l'API.

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

22 août 2023

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

18 août 2023

La définition de liveStreamingDetails.concurrentViewers de la ressource video a été mise à jour pour indiquer que le nombre de spectateurs simultanés renvoyé par l'API YouTube Data peut différer du nombre de spectateurs simultanés traités et déspammés disponibles via 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 est désormais compatible avec l'erreur uploadRateLimitExceeded, qui indique que la chaîne a importé trop de miniatures au cours des dernières 24 heures et qu'elle doit réessayer plus tard.

12 juin 2023

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

Le paramètre relatedToVideoId de la méthode search.list a été abandonné. YouTube ne sera plus compatible avec ce paramètre à partir du 7 août 2023.

À l'heure actuelle, 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 montrant 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. Toutefois, à compter du 1er décembre 2022, YouTube ne prendra plus en charge les anciens ID de piste de sous-titres. À ce moment-là, l'appel de l'une de ces méthodes d'API avec un ancien ID de piste de sous-titres générera une erreur captionNotFound.

Pour vous préparer à ce changement, vous devez planifier le remplacement complet de toutes les données de piste de sous-titres stockées entre maintenant et 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 des API YouTube – 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, en même temps que les modifications visant à rendre le nombre de "Je n'aime pas" sur les vidéos privées 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 même temps que les modifications visant à rendre le nombre de "Je n'aime pas" privé sur l'ensemble de la plate-forme YouTube, la propriété statistics.dislikeCount de la ressource video sera rendue privée à partir du 13 décembre 2021. Cela signifie que la propriété ne sera incluse dans une réponse d'API du point de terminaison videos.list que si la requête d'API a été authentifiée par le propriétaire de la vidéo.

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

Les développeurs qui n'affichent pas publiquement le nombre de "Je n'aime pas" et qui ont 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, 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 pris en charge. Ce point de terminaison dupliqué la fonctionnalité disponible via d'autres points de terminaison d'API. À la place, vous pouvez appeler comments.update.

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

1er juillet 2021

Tous les développeurs qui utilisent les services d'API YouTube doivent effectuer un audit de conformité des API pour obtenir plus que l'allocation de 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 pour les développeurs audités: les développeurs qui ont déjà réussi un audit de conformité de l'API peuvent remplir et envoyer ce formulaire plus court pour demander une augmentation de 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 autre partie qui gère un client API pour le compte d'un développeur et qui fait l'objet d'un changement de contrôle (par exemple, en raison d'une acquisition ou d'une vente d'actions, d'une fusion ou d'une autre forme de transaction d'entreprise) associé à un projet d'API doivent remplir et envoyer ce formulaire. Cela permet à l'équipe 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 couvre les modifications d'API suivantes:

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

    Avant cette mise à jour, l'API créait toujours une playlist si un client API tentait d'ajouter une vidéo à une playlist "Favoris" inexistante. À l'avenir, la playlist ne sera pas créée dans ce cas, et l'API renverra une erreur. Les tentatives de modification des playlists de favoris 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 ressources 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, ils ne sont plus pris en charge via l'API.

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

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

  • Les propriétés de ressources channelSection 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, ils ne sont plus pris en charge via l'API.

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

    En même temps que ce changement, le paramètre hl de la méthode channelSection.list a également été abandonné, car les fonctionnalités qu'il prend en charge ne sont plus prises en charge.

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

  • Pour la propriété snippet.type de la ressource channelSection, les valeurs suivantes sont obsolètes. Ces valeurs ne sont déjà plus acceptées sur les pages de chaînes 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à plus prise en charge sur YouTube et, par conséquent, elle n'est plus disponible 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 non 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 aux Règles 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 de toutes les données utilisateur que vous nous envoyez via un lecteur YouTube intégré avant que l'utilisateur n'ait interagi avec le lecteur pour indiquer son intention de lecture. Vous pouvez limiter les données partagées avec YouTube avant qu'un utilisateur n'interagisse avec le lecteur en définissant la lecture automatique sur "false".
  • La nouvelle section III.E.4.j concerne la vérification de l'état "Contenu conçu pour les enfants" (CPE) 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.

En plus de ces modifications, un rappel a été ajouté à la documentation sur les paramètres du lecteur intégré pour expliquer que si vous activez la lecture automatique, la lecture se produira sans aucune interaction de l'utilisateur avec le lecteur. La collecte et le partage des données de lecture se produiront donc 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 images miniatures d'une chaîne, peut être vide pour les chaînes nouvellement créées et peut mettre jusqu'à une journée à se remplir.
  • 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 du canal, qui sont identifiés dans la propriété brandingSettings.channel.keywords, peuvent être tronqués s'ils dépassent la longueur maximale autorisée de 500 caractères ou s'ils contiennent des guillemets non échappés ("). Notez que la limite de 500 caractères n'est pas une limite par mot clé, mais plutôt une limite sur la longueur totale de tous les mots clés. Ce comportement est identique à celui du site Web YouTube.

9 septembre 2020

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

Cette mise à jour couvre les modifications d'API suivantes. Toutes les modifications entreront en vigueur à compter du 9 septembre 2020, date de cette annonce. Par conséquent, les développeurs ne doivent plus utiliser 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 obsolètes immédiatement et cesseront de fonctionner à partir de la date de cette annonce ou après :
    • 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'a aucune incidence sur la propriété prevPageToken pour les autres requêtes channels.list, ni sur 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. Globalement, l'impact probable est que votre quota alloué, qui s'affiche dans la console Google Cloud, sera un peu plus élevé.

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.

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 mises en ligne via le point de terminaison videos.insert à partir de projets d'API non validés créés après le 28 juillet 2020 seront limitées au mode de visionnage privé. Pour lever cette restriction, chaque projet doit faire l'objet d'un audit afin de vérifier 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 cette restriction en utilisant un client officiel ou audité.

Les projets d'API créés avant le 28 juillet 2020 ne sont pas concernés par ce changement. 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

[Mis à jour le 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, le changement de quota n'est pas encore en vigueur. 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 publiée à nouveau prochainement.

7 juillet 2020

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

Les paramètres autoLevels et stabilize de la méthode videos.insert sont désormais obsolètes et ont été supprimés de la documentation. Leurs valeurs sont ignorées et n'ont aucune incidence sur le traitement des vidéos nouvellement mises en ligne.

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 conseils vous donnent un aperçu de la façon dont YouTube applique certains aspects des conditions d'utilisation de l'API, mais ne remplacent aucun document existant. 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 que cela simplifiera votre processus de développement de fonctionnalités en vous aidant à comprendre comment nous interprétons et appliquons nos règles.

4 juin 2020

Remarque:Cette annonce fait suite à 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 prise en charge, et la méthode activities.list ne renvoie plus de bulletins de chaîne. Pour en savoir plus, consultez le Centre d'aide YouTube.

17 avril 2020

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

YouTube abandonne la fonctionnalité de bulletin de chaîne. Par conséquent, la méthode activities.insert sera obsolète et la méthode activities.list 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 financier récurrent à un créateur et bénéficie d'avantages spéciaux. Par exemple, les membres peuvent discuter lorsque le créateur active le mode réservé aux membres pour un chat.

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

    • La nouvelle ressource membershipsLevel identifie un niveau de tarification géré par le créateur qui a autorisé la requête API. La méthode membershipsLevels.list permet de récupérer la liste de tous les niveaux d'abonnement 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 contenus de spécifier si une chaîne ou une vidéo est conçue pour les enfants.

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

    Notez que cette propriété n'est incluse que dans les réponses d'API contenant des ressources channel ou video si le propriétaire de la chaîne a autorisé la requête d'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. Pour en savoir plus sur la définition de l'audience de votre chaîne, de vos vidéos ou de vos diffusions, consultez le Centre d'aide YouTube.

Nous avons également mis à jour les Conditions d'utilisation des services d'API YouTube et le Règlement pour les développeurs. Pour en savoir plus, 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 un changement dans la manière dont le nombre d'abonnés est indiqué sur YouTube et, par conséquent, dans les réponses de l'API. En raison de ce changement, les nombres d'abonnés renvoyés par le service d'API YouTube Data sont arrondis à trois chiffres significatifs pour les nombres d'abonnés supérieurs à 1 000. Cette modification affecte la propriété statistics.subscriberCount de la ressource channel.

Remarque:Ce changement affecte 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 contient 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 par tous
1 234 1230 1,23 K
12 345 12300 12,3 k
123 456 123000 123 K
1 234 567 1230000 1,23 M
12 345 678 12300000 12,3 M
123,456,789 123000000 123 M

4 avril 2019

Cette mise à jour inclut les changements suivants :

  • La documentation de référence de l'API a été mise à jour pour mieux expliquer les cas d'utilisation courants de chaque méthode et 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 sont désormais disponibles sur les pages qui décrivent les méthodes d'API:

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

    • La section Cas d'utilisation courants décrit un ou plusieurs cas d'utilisation courants de la méthode expliquée sur la page. Par exemple, vous pouvez appeler la méthode 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 APIs Explorer en plein écran avec ces valeurs déjà renseignées. Ces modifications visent à vous permettre de trouver plus facilement des exemples de code directement applicables au cas d'utilisation que vous essayez d'implémenter dans votre propre application.

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

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

    En 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 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é modifiée pour indiquer que, lorsque vous affichez des miniatures dans votre application, votre code doit utiliser les URL des images exactement telles qu'elles sont renvoyées dans les réponses de l'API. Par exemple, votre application ne doit pas utiliser le domaine http au lieu du domaine https dans une URL renvoyée dans une réponse d'API.

    À partir de juillet 2018, les URL des miniatures de chaîne ne seront disponibles que dans le domaine https, ce qui est la façon dont elles apparaissent 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:Il s'agit d'une annonce d'abandon.

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

22 juin 2018

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

27 novembre 2017

Cette mise à jour inclut les changements suivants :

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

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

    Vous pouvez toujours 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'outil interactif d'extrait de code est désormais compatible avec les exemples de code Node.js. Les exemples sont également visibles dans la documentation de presque toutes les méthodes d'API, comme la méthode channels.list.

    Les exemples personnalisables sont conçus pour vous fournir un point de départ spécifique à un cas d'utilisation pour une application Node.js. La fonctionnalité est semblable au 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. Elle 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 doit maintenant afficher un exemple de code complet qui utilise le flux d'autorisation InstalledAppFlow. La description au-dessus de l'exemple explique cela et fournit également un lien vers un exemple d'application de serveur Web.
    5. Cliquez sur le lien pour passer à l'exemple de serveur Web. Cet exemple utilise le framework d'application Web Flask et un flux d'autorisation différent.

    Tous ces exemples sont conçus pour être téléchargés et exécutés en local. Si vous souhaitez exécuter les exemples, consultez les instructions pour exécuter des exemples de code complets en local dans les instructions de l'outil d'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 ses logos et icônes de marque. Vous pouvez télécharger les nouveaux logos "développés avec YouTube" sur la page des consignes relatives à la marque. D'autres nouveaux logos et icônes YouTube sont également présentés sur cette page et peuvent être téléchargés sur le site de la marque YouTube.

24 juillet 2017

Cette mise à jour inclut les changements suivants :

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

    Remarque:L'outil est également intégré à la documentation de référence de l'API pour les méthodes de l'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 alors mis à jour de manière dynamique pour refléter les valeurs que vous fournissez.

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

    • Exécutez 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 Wikipedia 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 attribuée par la Motion Picture Association of America à 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 sujet compatibles est incluse dans les propriétés topicDetails pour les ressources channel et video, ainsi que dans le paramètre topicId de la méthode search.list.

Notez que la sélection a été modifiée de plusieurs façons:

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

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 :

  • La liste des ID de sujet compatibles à partir du 10 février 2017 a été modifiée à trois reprises:

    • 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, est é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 associées à 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 qu'il n'est pas garanti que les chaînes et les vidéos soient associées à des sujets, ce qui est conforme au comportement actuel de l'API.

    Pour que vous puissiez préparer vos clients 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:Il s'agit d'une annonce d'abandon.

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

    • Propriété topicDetails.topicIds[] de la ressource channel. Cette propriété sera prise en charge jusqu'au 10 novembre 2017.
    • Propriété topicDetails.relevantTopicIds[] de la ressource video. Cette propriété sera prise en charge 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 sujets 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 pour montrer comment une application fonctionne avec l'API Freebase.

    De plus, 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 :

  • Nouvelles propriétés et paramètres

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

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

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

      • La nouvelle fpbRatingReasons[] identifie les raisons pour lesquelles la vidéo a reçu la classification FPB (Afrique du Sud).

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

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

      Par défaut, la hauteur de l'<iframe> renvoyée dans la propriété player.embedHtml est de 360 px. 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 le format d'une vidéo est 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 de l'API ajuste les dimensions du lecteur selon les besoins pour s'assurer qu'il n'y a pas de barres noires autour de la vidéo dans le lecteur intégré. Notez que les deux paramètres spécifient les dimensions maximales du lecteur intégré. Par conséquent, si les deux paramètres sont spécifiés, une dimension peut toujours être inférieure à la valeur maximale autorisée pour cette dimension.

      Par exemple, imaginons qu'une vidéo ait un 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 le paramètre maxHeight sur 450, l'API renvoie un lecteur 800x450.

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

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

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

      De plus, la propriété targeting de la ressource channelSection a été mise à jour pour refléter le fait que les options de ciblage ne peuvent être définies qu'à l'aide de l'API. Les options de ciblage sont supprimées si 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 des requêtes playlistItems.insert ou playlistItems.update.

    • Les méthodes playlistItems.delete et playlistItems.update acceptent désormais le paramètre onBehalfOfContentOwner, qui est déjà pris en charge par 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. 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.

  • Nouvelles erreurs et mises à jour d'erreurs

    • L'API est compatible avec 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 définissez le paramètre home sur true dans une requête non autorisée.
      invalidValue (400) invalidContentDetails La méthode playlistItems.insert renvoie cette erreur pour indiquer que l'objet contentDetails de la requête n'est pas valide. Cette erreur se produit, par exemple, si le champ contentDetails.note est plus long que 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. Notez que certaines chaînes ne sont pas autorisées à proposer des lecteurs intégrés pour les diffusions en direct. Pour en savoir plus, consultez le Centre d'aide YouTube.

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

  • Autres nouveautés

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

15 septembre 2016

Cette mise à jour inclut les changements suivants :

  • La mise à jour de l'historique des révisions du 11 août 2016 a 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 sujets 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 toutes les chaînes.

      Pour être clair, ces propriétés ne sont visibles que par un utilisateur autorisé qui récupère des données sur son propre 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 requêtes visant à récupérer les détails d'une playlist (playlists.list) ou les éléments d'une playlist (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 est vrai pour les nouvelles valeurs, HL et WL, ainsi que pour tous les ID de playlist "À regarder plus tard" ou d'historique des vidéos regardées que votre client API a peut-être déjà stockés.

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

11 août 2016

Cette mise à jour inclut les changements suivants :

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

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

  • L'abandon de Freebase et de l'API Freebase entraîne plusieurs modifications liées aux ID de sujet. 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 thèmes associés à la vidéo.
    • Le paramètre topicId de la méthode search.list vous permet de rechercher des vidéos ou des chaînes 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 le plus petit ensemble de thèmes identifiés dans l'élément précédent pour récupérer les résultats de recherche par thème.

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

  • Plusieurs champs et paramètres d'API seront abandonnés à partir 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és qui s'afficherait sur la page d'accueil YouTube de cet utilisateur. Les requêtes qui utilisent ce paramètre après le 12 septembre 2016 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é à récupérer des données sur son propre chaîne. 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 requêtes visant à récupérer des éléments de playlist (playlistItems.list) dans l'une de ces playlists renvoient également une liste vide après cette date. Cela est vrai pour les nouvelles valeurs, HL et WL, ainsi que pour tous les ID de playlist "À regarder plus tard" ou d'historique de visionnage que votre client API a peut-être déjà stockés.

    • L'objet fileDetails.recordingLocation de la ressource video ou l'une de ses propriétés enfants ne seront plus renvoyés après le 12 septembre 2016. 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 aucune ressource channel.

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

Étant donné qu'aucune de ces propriétés ne sera renvoyée après l'abandon, elles ont é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 abonnés les plus récents 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, resultat de recherche, miniature et video afin d'indiquer que des tailles d'images miniatures supplémentaires sont disponibles pour certaines vidéos.

    • L'image standard mesure 640 x 480 pixels.
    • 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. Ces éléments ne sont disponibles que pour le propriétaire de la vidéo.

17 mai 2016

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

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

  • Lister les vidéos par mot clé
  • Lister les vidéos par zone géographique
  • 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. Dans ce 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 requêtes en votre nom pour que les réponses de l'API s'affichent.

28 avril 2016

Cette mise à jour inclut les changements suivants :

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

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

    • La propriété recordingDetails.location identifie l'emplacement 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 la valeur de la propriété peut contenir un ID de playlist qui fait référence à une playlist vide et qui ne peut pas être extrait. 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 d'API.

  • La définition de l'erreur ineligibleAccount, qui peut être renvoyée par les méthodes comments.insert, comments.update, commentThreads.insert ou commentThreads.update, a été mise à jour pour indiquer qu'elle 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 des quotas du guide de démarrage a été mise à jour pour inclure un lien vers la Google Developer Console, où vous pouvez consulter votre quota et votre utilisation des quotas.

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 à la chaîne. (Toutes les chaînes ne disposent pas d'URL personnalisées.) Le Centre d'aide YouTube explique les critères d'éligibilité pour obtenir une URL personnalisée et comment la configurer.

    • L'objet brandingSettings.watch de la ressource channel et toutes ses propriétés enfants 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 est désormais compatible avec le paramètre hl, qui spécifie la langue à utiliser pour le texte du libellé dans la réponse de l'API. La valeur par défaut du paramètre est en_US.

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

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

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

    • La propriété liveStreamingDetails.activeLiveChatId de la ressource video contient l'ID du chat en direct actif associé à la vidéo. La valeur de la propriété n'est présente que si la vidéo est une diffusion en direct en cours pour laquelle le chat 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 est compatible avec 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 qu'il est impossible de créer, de mettre à jour ou de supprimer la section de chaîne spécifié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 ont été désactivés pour la vidéo identifiée par le paramètre videoId.
    badRequest (400) commentTextTooLong La méthode commentThreads.insert renvoie cette erreur pour indiquer que la ressource comment insérée contient trop de caractères dans la propriété snippet.topLevelComment.snippet.textOriginal.
    invalidValue (400) videoAlreadyInAnotherSeriesPlaylist La méthode playlistItems.insert renvoie cette erreur pour indiquer que la vidéo que vous essayez d'ajouter à la playlist figure déjà dans une autre playlist de séries. Pour en savoir plus sur les playlists de séries, consultez le Centre d'aide YouTube.
    badRequest (400) subscriptionForbidden La méthode subscriptions.insert renvoie cette erreur pour indiquer que vous avez atteint le nombre maximal d'abonnements ou que vous avez créé trop d'abonnements récents. Dans ce dernier cas, vous pouvez 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écifiait 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 spécifie 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 informations d'enregistrement non valides.
    badRequest (400) invalidTags La méthode videos.update renvoie cette erreur pour indiquer que la propriété snippet.tags de la ressource video importée a spécifié une valeur non valide.
    badRequest (400) invalidTitle La méthode videos.update renvoie cette erreur pour indiquer que la propriété snippet.title de la ressource video importée spécifiait 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 titres et des descriptions localisés

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

    • Assurez-vous qu'une valeur est définie pour la propriété snippet.defaultLanguage de la ressource. Cette propriété identifie la langue des propriétés snippet.title et snippet.description de la ressource. Sa valeur peut être l'une des langues d'application compatibles 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 modifier la propriété brandingSettings.channel.defaultLanguage.

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

      L'extrait d'exemple ci-dessous définit la langue par défaut de la ressource sur l'anglais. Il ajoute également des titres et des descriptions en allemand et en espagnol localisés à 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 pour récupérer des données localisées pour une langue d'application spécifique prise en charge par le site Web YouTube. Si des informations sur la ressource localisées 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 était défini sur fr, l'objet snippet.localized contiendrait le titre et la description en anglais, car l'anglais est la langue par défaut de la ressource et les informations en français localisées ne sont pas disponibles.

      Important:Le paramètre hl n'accepte que les valeurs qui identifient les langues d'application compatibles avec le site Web 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 de l'Appalachie.

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

  • Erreurs liées aux valeurs textuelles localisées

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

    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 pour une ressource échoue, car la propriété snippet.defaultLanguage n'est pas définie pour cette ressource. Les méthodes channels.update, channelSections.insert, channelSections.update, playlists.insert, playlists.update, videos.insert et videos.update acceptent cette erreur.
    badRequest (400) localizationValidationError Cette erreur indique 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 de 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 de mise en ligne de la vidéo. Par exemple, si une vidéo est mise en ligne en tant que vidéo privée, puis rendue publique 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 de comportement de l'API.

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

      • Si vous définissez la valeur de cette propriété lorsque vous appelez la méthode videos.update, vous devez également définir la valeur de la propriété status.privacyStatus sur private, même si la vidéo est déjà privée.
      • Si la demande prévoit la publication d'une vidéo à une date antérieure, elle 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 spécifie 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 de comportement de l'API.

    • La documentation de la méthode thumbnails.set a été mise à jour pour indiquer précisément que le corps de la requête contient l'image miniature que vous mettez en ligne et associez à une vidéo. Le corps de la requête ne contient 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 de comportement de l'API.

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

  • Nouvelles erreurs et mises à jour d'erreurs

    • L'API est désormais compatible avec 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 ressource comment insérée ou mise à jour contient trop de caractères dans la propriété snippet.topLevelComment.snippet.textOriginal.
      playlistItems.insert
      playlistItems.update
      Code de réponse HTTPforbidden (403)
      MotifplaylistItemsNotAccessible
      DescriptionLa requête n'est pas correctement autorisée à insérer, mettre à jour ou supprimer l'élément de playlist spécifié.
      playlists.delete
      playlists.insert
      playlists.update
      Code de réponse HTTPbadRequest (400)
      MotifplaylistForbidden
      DescriptionCette opération est interdite ou la requête n'est pas correctement autorisée.
      search.list
      Code de réponse HTTPbadRequest (400)
      MotifinvalidLocation
      DescriptionLa valeur des paramètres location et/ou locationRadius n'est pas au bon format.
      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 et 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 sur l'abandon, cette propriété restera incluse dans les ressources video pendant au moins un an après cette annonce. Toutefois, la valeur de la propriété est désormais toujours définie sur 0.

7 août 2015

Cette mise à jour inclut les changements suivants :

  • Mises à jour des ressources et méthodes existantes

    • La définition de la propriété snippet.tags[] de la ressource video a été mise à jour pour fournir plus d'informations sur la façon dont le serveur d'API calcule la longueur de la valeur de la propriété. Notez que cette mise à jour ne reflète pas un changement 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'est plus compatible avec le paramètre shareOnGooglePlus, qui indiquait auparavant si un commentaire et les réponses à ce commentaire devaient également être publiés sur le profil Google+ de l'auteur. Si une requête envoie le paramètre, le serveur d'API l'ignore, mais gère la requête.

18 juin 2015

Cette mise à jour inclut les changements suivants :

  • Mises à jour des ressources et méthodes existantes

    • Le nouveau paramètre order de la méthode commentThreads.list spécifie l'ordre dans lequel la réponse de l'API doit lister les fils de discussion. Les fils de discussion peuvent être triés par date ou par pertinence. Par défaut, elles sont triées 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é mis en ligne à l'origine sur une chaîne associée à un partenaire de contenu YouTube, puis revendiqué par ce partenaire. Cela ne représente pas un changement dans le comportement réel de l'API.

    • Les méthodes captions.delete, captions.download, captions.insert, captions.list et captions.update 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 est désormais compatible avec les erreurs suivantes:

      Informations sur les erreurs
      videos.rate
      Code de réponse HTTPbadRequest (400)
      MotifemailNotVerified
      DescriptionL'utilisateur doit valider son adresse e-mail avant de pouvoir évaluer la vidéo.
      videos.rate
      Code de réponse HTTPbadRequest (400)
      MotifvideoPurchaseRequired
      DescriptionLes vidéos à louer ne peuvent être notées que par les utilisateurs qui les ont louées.

    • 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 tous les motifs pour lesquels des vidéos peuvent être signalées.

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

      Le guide de migration a également été mis à jour avec un exemple de signalement d'une vidéo abusive. 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 une recherche aux vidéos importées via l'application ou le site Web du développeur. Le paramètre forDeveloper peut être utilisé avec des paramètres de recherche facultatifs, comme 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 similaires, mais pas identiques, à celles des tags pour les développeurs compatibles avec l'API v2.

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

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

    • L'API prend désormais en charge le ciblage des ressources channelSection. Le ciblage de sections de chaîne permet de limiter la visibilité d'une section de contenu aux utilisateurs qui répondent à des critères particuliers.

      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 ne peut pas insérer de commentaire en réponse au commentaire de niveau supérieur 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'est plus compatible avec les erreurs invalidMetadata et videoNotFound.

16 avril 2015

Cette mise à jour inclut les changements suivants :

  • Le guide de migration a été mis à jour pour expliquer comment migrer les applications qui utilisent 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 sont compatibles avec l'API v3. Exemples :

    • Récupérer les 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 discussion YouTube, qui comprend un commentaire de premier niveau et les réponses, le cas échéant, à 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. Notez que la ressource commentThread ne contient pas nécessairement toutes les réponses à un commentaire. Vous devez utiliser la méthode comments.list pour récupérer toutes les réponses à un commentaire particulier. De plus, certaines réponses ne sont pas associées à des commentaires.

      L'API prend en charge les méthodes suivantes pour les ressources commentThread:

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

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

      L'API prend en charge les méthodes suivantes pour les ressources comment:

      • comments.list : récupérez une liste de commentaires. Utilisez cette méthode pour récupérer toutes les réponses à un commentaire spécifique.
      • comments.insert : créez une réponse à un commentaire existant.
      • comments.update : permet de modifier un commentaire.
      • comments.markAsSpam : signalez un ou plusieurs commentaires comme spam.
      • comments.setModerationStatus : définissez l'état de modération d'un ou de plusieurs commentaires. Par exemple, vous pouvez 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 : supprimez un commentaire.

    Notez que le nouveau champ d'application https://www.googleapis.com/auth/youtube.force-ssl de l'API, décrit dans l'historique des révisions du 2 avril 2015, est 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 prise en charge des notifications push par l'API 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 ;
    • met à jour le titre d'une vidéo ;
    • met à jour la description d'une vidéo ;

  • Le guide de migration a également été mis à jour pour indiquer la nouvelle 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. En fait, ces deux champs d'application sont fonctionnellement identiques, car le serveur de l'API YouTube n'est disponible que via un point de terminaison HTTPS. Par conséquent, même si le champ d'application https://www.googleapis.com/auth/youtube ne nécessite pas de connexion SSL, il n'existe en 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 listées dans d'autres onglets du guide et le sont toujours. 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 (version 3) a été mis à jour pour indiquer que l'API v3 sera compatible avec la fonctionnalité suivante de l'API v2:

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

    • Récupérer des recommandations de vidéos : l'API v3 ne récupère pas 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 en appelant la méthode activities.list et en définissant la valeur du paramètre home sur true.

      Dans la réponse de l'API, une ressource correspond à une vidéo recommandée si la valeur de la propriété snippet.type est recommendation. Dans ce cas, les propriétés contentDetails.recommendation.reason et contentDetails.recommendation.seedResourceId contiennent des informations sur 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 trouver de nouvelles vidéos sur 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 en accès payant 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'affichent pas pour les utilisateurs de YouTube, mais les propriétaires de vidéos peuvent récupérer les vidéos correspondant à un tag de développeur spécifique.

      L'API v3 propose une fonctionnalité similaire, mais pas identique. Plus précisément, un développeur pourra rechercher les vidéos mises en ligne par son application. 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. Le développeur utilise ensuite le même numéro de projet pour rechercher des vidéos.

    • Lister les vidéos par date de publication, nombre de vues ou note : dans l'API v2, le paramètre orderby vous permet de trier les vidéos d'une playlist par position, durée, date de publication, titre et plusieurs autres valeurs. Dans l'API v3, les éléments de la playlist 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 l'élément le plus récent au plus ancien en fonction des dates d'ajout des éléments.

      • importations utilisateur
      • vidéos favorites
      • 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 est compatible avec 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. Grâce à ces méthodes, vous pouvez 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à pris en charge par plusieurs autres méthodes.

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

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

    Remarque:Aucune de ces propriétés n'était soumise à la règle 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 reçu la classification 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 occupe une position spécifique dans la liste, vous devez d'abord définir le paramètre de tri de la playlist sur Manuel. Vous pouvez 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 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 la requête n'est pas correctement autorisée.
    notFound (404) channelNotFound La méthode playlists.list renvoie cette erreur si le paramètre channelId de la requête spécifie un canal introuvable.
    notFound (404) playlistNotFound La méthode playlists.list renvoie cette erreur si le paramètre id de la requête spécifie une playlist introuvable.
    notFound (404) videoNotFound La méthode videos.list renvoie cette erreur si le paramètre id de la requête spécifie une vidéo introuvable.
    badRequest (400) invalidRating La méthode videos.rate renvoie cette erreur si la requête contient une valeur inattendue pour le paramètre rating.

2 mars 2015

Cette mise à jour inclut les changements suivants :

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 dans le navigateur proposée par l'API v2. 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 mentionne plus l'importation dans 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 (version 3) 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. Par exemple, voici deux façons de trouver des vidéos mises en ligne sur la chaîne GoogleDevelopers.

    • Coût du quota: 100 unités

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

    • Coût du quota: 6 unités

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

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

8 octobre 2014

Cette mise à jour inclut les changements suivants :

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

    • La propriété status.longUploadsStatus indique si la chaîne 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é tente de diffuser des promotions à un moment de la vidéo où elles sont plus susceptibles d'être cliquées et moins susceptibles de perturber l'expérience de visionnage. Cette fonctionnalité sélectionne également une seule promotion à diffuser sur chaque vidéo.

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

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

  • La propriété contentDetails.contentRating.oflcRating de la ressource video, qui identifie la classification d'une vidéo 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 est désormais compatible avec l'erreur suivante:

    Type d'erreur Détail de l'erreur Description
    badRequest bannerAlbumFull L'album d'illustrations de la chaîne YouTube du propriétaire de la chaîne contient trop d'images. Le propriétaire de la chaîne doit accéder à http://photos.google.com, 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 est désormais compatible avec l'erreur suivante:

    Type d'erreur Détail de l'erreur Description
    badRequest subscriptionLimitExceeded L'abonné identifié par 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 si vous ne pouvez pas créer de playlist, 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 du centre de la zone pour que la vidéo puisse toujours figurer 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 mis en avant, l'API renvoie une erreur tooManyPromotedItems, associée à 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 publiées par le propriétaire de la chaîne dans son flux d'activités
    • 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 s'affiche 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. La valeur peut également utiliser l'opérateur booléen OU (|) pour rechercher des vidéos associées à l'un de plusieurs 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 une langue d'application compatible avec le site Web YouTube. La langue de l'application peut également être appelée "langue de l'interface utilisateur". Pour le site Web YouTube, une langue d'application peut être sélectionnée automatiquement en fonction des paramètres du compte Google, de la langue du navigateur ou de l'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 langues acceptées peuvent être utilisées comme valeur du paramètre hl lorsque vous appelez des méthodes d'API telles que videoCategories.list et guideCategories.list.

  • La nouvelle ressource i18nRegion identifie une zone géographique qu'un utilisateur YouTube peut sélectionner comme région de contenu préférée. La région de contenu peut également être appelée "locale de contenu". Pour le site Web YouTube, une région de contenu peut être sélectionnée automatiquement en fonction d'heuristiques telles que le domaine YouTube ou l'emplacement de l'adresse IP de l'utilisateur. L'utilisateur peut également sélectionner manuellement la région de contenu souhaitée dans 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 compatibles peuvent être utilisés comme valeur du paramètre regionCode lorsque vous appelez des méthodes d'API telles que search.list, videos.list, activities.list et videoCategories.list.

7 avril 2014

Cette mise à jour inclut les changements suivants :

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

    L'API propose des méthodes permettant de lister, 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 compatibles avec l'API spécifiquement pour ces nouvelles méthodes.

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

    De même, la définition de l'objet suggestions de la ressource video a été modifiée pour expliquer que cet objet ne sera renvoyé que si la valeur de la propriété processingDetails.tagSuggestionsAvailability ou processingDetails.editorSuggestionsAvailability de la vidéo est 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'agissait d'une erreur de documentation, car les requêtes videos.rate qui définissent ce paramètre renvoient une erreur 500.

31 mars 2014

Cette mise à jour inclut les changements suivants :

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 à la règle d'abandon.

  • 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 ressources video suivantes ont été ajoutées à la liste des valeurs pouvant être définies lors de l'insertion ou de la mise à jour d'une vidéo:

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

  • L'API est désormais compatible avec 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 essayez de mettre à jour la partie brandingSettings d'un canal et de modifier la valeur de la propriété brandingSettings.channel.title. (Notez que l'API ne renvoie pas l'erreur si vous omettez la propriété.)
    badRequest (400) invalidRecentlyUploadedBy La méthode channels.update renvoie cette erreur si la propriété invideoPromotion.items[].id.recentlyUploadedBy spécifie un ID de chaîne non valide.
    badRequest (400) invalidTimingOffset La méthode channels.update renvoie cette erreur si la partie invideoPromotion spécifie un 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 introuvable ou qui ne peut pas être utilisé comme élément mis en avant.
    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. Vous pouvez plutôt 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.) Notez également 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'illustration de votre chaîne afin qu'elle s'affiche 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 peut comporter jusqu'à 30 caractères.
    • La propriété brandingSettings.channel.featuredChannelsUrls[] peut désormais lister jusqu'à 100 chaînes.
    • Si elle est définie, la valeur de la propriété brandingSettings.channel.unsubscribedTrailer doit spécifier l'ID 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 s'affichera lorsque la promotion sera diffusée. 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 à présenter des contenus de diffusion en direct:

    La nouvelle propriété snippet.liveBroadcastContent dans les résultats de recherche indique si une ressource vidéo ou de chaîne contient 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 en cours de diffusion 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 de la vidéo. La valeur par défaut du paramètre est True, ce qui indique que les abonnés recevront une notification lorsqu'une nouvelle vidéo sera mise 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 à ses abonnés à chaque nouvelle vidéo.

  • 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 accepte désormais la valeur pg14, qui correspond à une note TV-14.

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

  • 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) : interdit aux moins de 6 ans.
    • mibacVm12 (V.M.12) : interdit aux moins de 12 ans.

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

1er octobre 2013

Cette mise à jour inclut les changements suivants :

  • Le nouvel objet auditDetails de la ressource channel contient des données sur la chaîne qu'un réseau multichaîne évaluerait pour déterminer s'il doit accepter ou refuser une chaîne particulière. 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, le canal est le même que celui pour lequel les données de promotion dans la vidéo sont définies. Toutefois, vous pouvez promouvoir la 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îne dans les applications pour téléviseur.

  • La nouvelle propriété snippet.liveBroadcastContent dans les résultats de recherche indique si une ressource vidéo ou de chaîne contient 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, une valeur de upcoming indique qu'une diffusion planifiée n'a pas encore commencé, tandis qu'une valeur de acive indique qu'une diffusion en direct est en cours.

  • Dans la ressource watermark, la propriété targetChannelId est passée d'un objet à une chaîne. Au lieu de contenir une propriété enfant qui spécifie l'ID de chaîne YouTube de la chaîne à 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 est désormais compatible avec le paramètre eventType, qui limite une recherche à la seule diffusion d'événements actifs, à venir ou terminés.

  • La nouvelle propriété contentDetails.contentRating.mibacRating identifie la classification attribuée à une vidéo par le ministère italien des Biens et des Activités culturels et du Tourisme.

  • 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 fournie 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 à laquelle l'image sera associée, ainsi que des informations de timing qui déterminent quand le filigrane s'affichera pendant la lecture des vidéos et la durée pendant laquelle il sera 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 du filigrane d'une chaîne.

    La documentation sur les erreurs décrit les messages d'erreur compatibles avec l'API, en particulier 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à acceptés pour plusieurs autres méthodes.

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

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

    Type d'erreur Détail de l'erreur Description
    forbidden insufficientPermissions Les champs d'application associés au jeton OAuth 2.0 fourni pour la requête ne sont pas suffisants 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. Pour savoir comment activer les liens dans vos contenus, consultez les instructions du centre d'aide YouTube concernant les sites Web associés et les sites marchands.

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

    • Les propriétés liées aux paramètres de timing pour l'affichage des é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 calendrier par défaut de 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 calendrier par défaut de tout élément mis en avant à l'aide de l'objet invideoPromotion.items[].timing.

      • La nouvelle propriété invideoPromotion.items[].timing.durationMs spécifie 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 Le paramètre mine ne peut pas être utilisé dans les requêtes où l'utilisateur authentifié est un partenaire YouTube. Vous devez supprimer le paramètre mine, vous authentifier en tant qu'utilisateur YouTube en supprimant le paramètre onBehalfOfContentOwner ou agir en tant 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 de 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 uniquement 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é recevra une notification. Les valeurs de propriété valides sont all et uploads.

  • La méthode videos.list prend en charge 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, ce qui signifie qu'il ne peut pas être utilisé dans la même requête que d'autres paramètres de filtre (id et myRating).
    • Le paramètre videoCategoryId identifie la catégorie de 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 spécifique.

  • 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 thèmes peuvent être mentionnés ou apparaître dans la vidéo.

  • La propriété recordingDetails.location.elevation de la ressource video a été rebaptisée recordingDetails.location.altitude, et sa propriété fileDetails.recordingLocation.location.elevation a été rebaptisé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 les contenus soumis à une limite d'âge. La valeur de la propriété sera ytAgeRestricted si YouTube a identifié que la vidéo contient du contenu inapproprié pour les utilisateurs de moins de 18 ans. Si la propriété est absente ou si sa valeur est vide, 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 toutes compatibles avec le paramètre onBehalfOfContentOwner. Ce paramètre indique que l'utilisateur authentifié agit au nom du propriétaire du contenu spécifié dans la valeur du paramètre.

  • La documentation de la méthode channels.update a été mise à jour pour 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 contient désormais la liste mise à jour des propriétés que vous pouvez définir pour l'objet invideoPromotion de la ressource channel.

  • error documentation décrit les nouvelles erreurs suivantes:

    Type d'erreur Dé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 est 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. Il indique que le serveur d'API ne parvient pas à identifier le canal associé à la requête d'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 lorsqu'ils appellent les méthodes playlists.insert ou playlists.update.

  • Le paramètre onBehalfOfContentOwner, qui était auparavant compatible avec les méthodes channels.list et search.list, 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 leurs données vidéo et de 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.

  • 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. 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 de chaîne est déjà spécifié à l'aide de la propriété id de la ressource.

  • Le nouveau guide Utiliser les ID de chaîne explique comment l'API utilise les ID de chaîne. Ce guide peut être particulièrement utile aux développeurs qui migrent depuis la version précédente de l'API et 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 les 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 sont désormais compatibles avec l'objet inVideoPromotion, qui encapsule les informations sur une campagne promotionnelle associée à la chaîne. Une chaîne peut utiliser une campagne promotionnelle dans la vidéo pour afficher des miniatures d'une vidéo promue dans le lecteur vidéo pendant la lecture des vidéos de la chaîne.

    Pour récupérer ces données, incluez invideoPromotion dans la valeur du paramètre part d'une requête channels.list.

  • La nouvelle méthode channels.update permet de mettre à jour les données des campagnes promotionnelles intégrées aux 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 qui dispose 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 de plusieurs vidéos.

  • Le nouveau paramètre myRating de la méthode videos.list vous permet de récupérer la liste des vidéos que l'utilisateur authentifié a évaluées avec une note 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 acceptés que pour les requêtes utilisant le paramètre myRating. (Les paramètres et informations de pagination ne sont pas acceptés pour les requêtes qui utilisent le paramètre id.)

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

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

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

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

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

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

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

  • Dans une ressource video, la valeur de propriété unspecified n'est plus une valeur possible pour aucune des 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 classification like ou dislike sur une vidéo, ou de supprimer une classification 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'a pas vraiment d'incidence sur les ressources existantes qui renvoient des miniatures. 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 la chaîne et des pages de lecture des vidéos.

  • 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 à la récupération des vidéos de l'utilisateur authentifié.

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

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

  • La méthode videos.insert accepte plusieurs nouvelles erreurs, 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 : la propriété spécifie le nom de la chaîne associée à la ressource identifiée par le résultat 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 une recherche de vidéos pour récupérer toutes les vidéos, ou uniquement des films ou des é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 acceptent de nouveaux paramètres destinés exclusivement aux partenaires de contenus YouTube. Les partenaires de contenus YouTube incluent des studios de cinéma et de télévision, des maisons de disques et d'autres créateurs de contenus qui mettent leurs contenus à disposition sur YouTube.

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

      Ce paramètre est destiné aux partenaires de 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 leurs données vidéo et de chaîne, sans avoir à fournir d'identifiants d'authentification pour chaque chaîne.

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

    • Le paramètre managedByMe, compatible avec la méthode channels.list, indique à l'API de renvoyer toutes les chaînes appartenant au propriétaire de contenu spécifié 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 et progression du traitement
      • erreurs ou autres problèmes rencontrés lors du traitement d'une vidéo
      • disponibilité des images miniatures
      • des suggestions pour améliorer la qualité des vidéos ou des métadonnées ;
      • informations sur le fichier d'origine mis en ligne sur YouTube ;

      Toutes ces 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 qu'elles contiennent.

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

      • L'objet processingProgress contient des informations sur la progression du traitement du fichier vidéo importé par YouTube. Les propriétés de l'objet identifient l'état actuel du traitement et estiment le temps restant avant que YouTube ait terminé de traiter la vidéo. 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 qui met 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é de la vidéo ou les métadonnées de la vidéo mise en ligne.

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

      • dimension : indique si la vidéo est disponible en 2D ou en 3D.
      • definition : indique si la vidéo est disponible en définition standard ou en haute définition.
      • caption : indique si la vidéo est sous-titrée.
      • 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 à 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 de profil Google+ associé à la chaîne. Cette valeur permet de générer un lien vers le profil Google+.

  • Chaque objet d'image miniature spécifie désormais la largeur et la hauteur de l'image. Les 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é avec le paramètre playlistId pour ne récupérer que l'élément de playlist représentant la vidéo spécifiée.

    L'API renvoie une erreur notFound si la vidéo identifiée par le paramètre 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 Erreurs répertorie les erreurs que l'API peut renvoyer. La page inclut des erreurs générales, qui peuvent se produire pour plusieurs méthodes d'API différentes, ainsi que des erreurs spécifiques à une méthode.

16 janvier 2013

Cette mise à jour inclut les changements suivants :

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

  • Une ressource activity peut désormais enregistrer une action channelItem, qui se produit lorsque YouTube ajoute une vidéo à une chaîne YouTube générée automatiquement. (YouTube identifie de manière algorithmique 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 un filtre, ce qui signifie que…
    • Le paramètre relatedToVideo a été renommé relatedToVideoId.
    • Le paramètre published a été remplacé par deux nouveaux paramètres, publishedAfter et publishedBefore, décrits ci-dessous.

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

    Nom du paramètre Valeur Description
    channelId string Renvoie les ressources créées par le canal spécifié.
    publishedAfter datetime Renvoie les ressources créées après l'heure spécifiée.
    publishedBefore datetime Renvoie les ressources créées avant l'heure spécifiée.
    regionCode string Renvoie les ressources pour le pays spécifié.
    videoCategoryId string 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 pour l'identifier de manière unique 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 channelItem.
    activity contentDetails.channelItem.resourceId object Objet qui identifie la ressource ajoutée à la chaîne. Comme les autres propriétés resourceId, elle contient une propriété kind qui spécifie le type de ressource, par exemple "vidéo" ou "playlist". Il contient également exactement une des propriétés (videoId, playlistId, etc.) qui spécifient l'ID qui identifie de manière unique cette ressource.
    channel status object Cet objet encapsule des informations sur l'état de confidentialité de la chaîne.
    channel status.privacyStatus string État de confidentialité de la chaîne. Les valeurs valides sont private et public.
    playlist contentDetails object Cet objet contient des métadonnées sur le contenu de la playlist.
    playlist contentDetails.itemCount unsigned integer Nombre de vidéos dans la playlist.
    playlist player object Cet objet contient des informations que vous utiliserez pour lire la playlist dans un lecteur intégré.
    playlist player.embedHtml string 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 les informations de géolocalisation associées à la vidéo.
    video recordingDetails.location.latitude double Latitude en degrés.
    video recordingDetails.location.longitude double Longueur en degrés.
    video recordingDetails.location.elevation double Altitude au-dessus de la Terre, en mètres.
    video recordingDetails.locationDescription string Description textuelle du lieu où la vidéo a été enregistrée.
    video recordingDetails.recordingDate datetime Date et heure auxquelles la vidéo a été enregistrée. La valeur est spécifiée au format ISO 8601 (YYYY-MM-DDThh:mm:ss.sZ).

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

    Remarque:La documentation d'autres méthodes peut déjà lister 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 renvoie plus d'erreur playlistAlreadyExists si vous essayez de create ou de mettre à jour une playlist portant le même titre qu'une playlist déjà existante dans le même canal.

  • 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 n'est pas correctement autorisée à supprimer l'élément de playlist spécifié.
    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.