Historique des révisions

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

13 mars 2024

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

Cette mise à jour inclut les changements suivants :

Abandon du paramètre sync pour les méthodes captions.insert et captions.update. YouTube ne prendra plus en charge ce paramètre à compter du 12 avril 2024.

En raison de ce changement, les développeurs doivent inclure des informations temporelles lorsqu'ils insèrent ou mettent à jour des pistes de sous-titres, sans quoi l'importation échouera.

12 mars 2024

Cette mise à jour inclut les changements suivants :

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

7 mars 2024

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

La propriété de ressource channel brandingSettings.channel.moderateComments est obsolète. YouTube ne prendra plus en charge ce paramètre à compter 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 de l'abandon.

La méthode comments.markAsSpam est obsolète depuis plusieurs années. Cette méthode n'est pas disponible sur YouTube et n'est plus acceptée via l'API.

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

22 août 2023

La méthode search.list accepte désormais le paramètre videoPaidProductPlacement. Ce paramètre vous permet de filtrer les résultats de recherche pour n'inclure que les vidéos que le créateur a indiquées comme contenant une communication commerciale.

18 août 2023

La définition du liveStreamingDetails.concurrentViewers de la ressource video a été mise à jour pour indiquer que le nombre de spectateurs simultanés renvoyés par l'API YouTube Data peut être différent du nombre de spectateurs simultanés traités et supprimés des spams disponibles dans YouTube Analytics. Vous trouverez plus d'informations sur les métriques liées aux diffusions en direct dans 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 s'y rapportant ont été supprimées de la documentation de l'API.

28 juin 2023

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

12 juin 2023

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

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

Pour l'instant, un avis d'abandon a été ajouté à la documentation de la méthode search.list. Ce paramètre sera complètement supprimé de la documentation search.list le 7 août 2023 ou après cette date.

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

22 août 2022

Correction des annotations de type pour les champs video.statistics par une chaîne d'une longueur non signée.

5 août 2022

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

D'ici le 1er décembre 2022, les méthodes captions.list, captions.update, captions.download et captions.delete prendront en charge les anciens et les nouveaux ID de piste de sous-titres. Cependant, à partir du 1er décembre 2022, YouTube n'acceptera plus les anciens ID de piste de sous-titres. À ce stade, l'appel de l'une de ces méthodes d'API avec un ancien ID de piste de sous-titres entraînera une erreur captionNotFound.

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

12 juillet 2022

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

27 avril 2022

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

15 décembre 2021

Comme annoncé le 18 novembre 2021, en plus des modifications apportées pour rendre privé le nombre de "Je n'aime pas" sur les vidéos sur l'ensemble de la plate-forme YouTube, la propriété statistics.dislikeCount de la ressource video est désormais privée.

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

18 novembre 2021

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

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

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

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

2 juillet 2021

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

Le point de terminaison commentThreads.update est obsolète et n'est plus accepté. Ce point de terminaison a dupliqué une fonctionnalité disponible via d'autres points de terminaison de l'API. À la place, vous pouvez appeler la méthode comments.update.

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

1er juillet 2021

Tous les développeurs qui utilisent les services d'API de YouTube doivent effectuer un audit de conformité des API afin d'obtenir un quota supérieur au quota par défaut de 10 000 unités. À ce jour, le processus d'audit de conformité et les demandes d'allocations d'unités de quota supplémentaires ont été effectués par les développeurs qui remplissent et envoient le formulaire d'audit et d'extension de quota des services d'API YouTube.

Afin de clarifier ces processus et de mieux répondre aux besoins des développeurs utilisant nos services d'API, nous ajoutons trois nouveaux formulaires ainsi qu'un guide pour les remplir:

  • Formulaire de demande d'examen de conformité pour les développeurs: les développeurs qui ont déjà réussi un audit de conformité des API peuvent remplir et envoyer ce formulaire, plus court, pour demander une extension de quota allouée.
  • Formulaire d'appel: les développeurs dont les projets API n'ont pas été soumis à un audit de conformité (ou n'ont pas reçu d'augmentation d'unité de quota) peuvent remplir et envoyer ce formulaire.
  • Formulaire de changement de contrôle: les développeurs, ou toute partie gérant un client API au nom d'un développeur, qui font l'objet d'un changement de direction (par exemple, via l'achat ou la vente d'actions, une fusion ou une autre forme de transaction d'entreprise) associés à un projet d'API, doivent remplir et envoyer ce formulaire. Cela permet à l'équipe API de YouTube de mettre à jour nos dossiers, de vérifier la conformité des cas d'utilisation du nouveau projet d'API et de valider l'allocation actuelle des quotas au développeur.

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

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

12 mai 2021

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

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

  • La propriété contentDetails.relatedPlaylists.favorites de la ressource channel est obsolète. La fonctionnalité "Vidéos préférées" est déjà 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 de favoris inexistante. Dans ce cas, la playlist ne sera pas créée et l'API renverra une erreur. Les tentatives de modification des playlists favorites en ajoutant, en modifiant ou en supprimant des éléments sont également obsolètes, conformément aux annonces précédentes, et peuvent renvoyer des erreurs à tout moment.

  • Les propriétés de ressource channel suivantes sont obsolètes. Ces propriétés ne sont déjà pas disponibles dans l'interface utilisateur de YouTube Studio ni sur YouTube. Par conséquent, elles ne sont plus prises 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 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 aux méthodes.

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

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

    Toutes les propriétés ont été supprimées de la représentation de 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 aux méthodes.

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

    • likedPlaylists
    • likes
    • postedPlaylists
    • postedVideos
    • recentActivity
    • recentPosts
  • La propriété snippet.tags[] de la ressource playlist est obsolète. Cette propriété n'est déjà pas acceptée sur YouTube. Par conséquent, elle n'est plus acceptée via l'API.

9 février 2021

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

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 particulière. Par exemple, un utilisateur ne peut pas supprimer une vidéo de sa playlist de vidéos mises en ligne, ni supprimer la playlist elle-même.

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

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

15 octobre 2020

Deux nouvelles sections ont été ajoutées au Règlement pour les développeurs:

  • La nouvelle Section III.E.4.i fournit des informations supplémentaires sur les données collectées et envoyées via le lecteur YouTube intégré. Vous êtes responsable des données utilisateur que vous nous envoyez via un lecteur YouTube intégré avant que l'utilisateur n'ait interagi avec le lecteur pour indiquer son intention de lecture. Vous pouvez limiter les données partagées avec YouTube avant qu'un utilisateur n'interagisse avec le lecteur en définissant la lecture automatique sur "false".
  • La nouvelle Section III.E.4.j concerne la vérification de l'état d'un contenu conçu pour les enfants avant de l'intégrer à vos sites et applications. Vous êtes tenu de savoir si les vidéos que vous intégrez 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. Vous devez donc vérifier l'état du contenu à l'aide de l'API YouTube Data avant de l'intégrer à votre client API via des lecteurs intégrés YouTube.

Le nouveau guide Finding the MadeForKids status of a video (Trouver le statut MadeForKids d'une vidéo) explique comment rechercher l'état des vidéos conçues pour les enfants à l'aide du service d'API YouTube Data.

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

8 octobre 2020

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

  • L'objet snippet.thumbnails, qui identifie les miniatures d'une chaîne, peut être vide pour les nouvelles chaînes et mettre jusqu'à un jour à s'afficher.
  • La propriété statistics.videoCount ne reflète que le nombre de vidéos publiques de la chaîne, y compris celles des propriétaires. Ce comportement est cohérent avec celui indiqué sur le site Web YouTube.
  • Les mots clés de catégorie, 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 une limite appliquée à la longueur totale de tous les mots clés. Ce comportement est le même que sur le site Web YouTube.

9 septembre 2020

Remarque:Il s'agit d'une annonce de l'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. C'est pourquoi les développeurs ne doivent plus s'appuyer sur les fonctionnalités d'API listées ci-dessous.

  • Les ressources, méthodes, paramètres et propriétés de ressource d'API suivants sont immédiatement obsolètes et cesseront de fonctionner à 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'affecte pas la propriété prevPageToken des autres requêtes channels.list, ni la propriété nextPageToken des requêtes.
  • Les propriétés contentDetails.relatedPlaylists.watchLater et contentDetails.relatedPlaylists.watchHistory de la ressource channel ont toutes deux été annoncées comme obsolètes le 11 août 2016. La compatibilité des méthodes playlistItems.insert et playlistItems.delete avec ces playlists est également désormais complètement obsolète. 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, annoncés comme obsolètes le 27 novembre 2017, ont été supprimés de la documentation.

29 juillet 2020

Nous avons simplifié le processus de facturation du quota des requêtes API en supprimant le coût supplémentaire associé au paramètre part. Avec effet immédiat, nous ne facturerons que le coût de base de la méthode appelée. Pour en savoir plus sur le quota simplifié, cliquez ici.

Avec cette modification, le coût de la plupart des appels d'API sera légèrement inférieur, tandis que le coût de certains appels d'API restera le même. Ce changement n'augmente pas le coût des appels d'API. Dans l'ensemble, l'impact probable est que votre quota alloué, comme vous pouvez le voir dans la console Google Cloud, ira un peu plus loin.

Nous recommandons vivement à tous les développeurs d'effectuer un audit de conformité pour leurs projets afin de continuer à accéder aux services d'API YouTube.

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

28 juillet 2020

Toutes les vidéos importées via le point de terminaison videos.insert à partir de projets d'API non validés créés après le 28 juillet 2020 seront limitées au mode de visionnage privé. Pour lever cette restriction, chaque projet doit faire l'objet d'un audit afin de vérifier qu'il respecte 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 contourner les restrictions en faisant appel à un client officiel ou audité.

Les projets d'API créés avant le 28 juillet 2020 ne sont actuellement pas concernés par ce changement. Toutefois, nous recommandons vivement à tous les développeurs d'effectuer un audit de conformité pour leurs projets afin de continuer à accéder 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é republiée le 28 juillet 2020.

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

7 juillet 2020

Remarque:Il s'agit d'une annonce de l'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'affectent pas 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 certaines sections spécifiques des Conditions d'utilisation et des Règles des services d'API YouTube.

Ces conseils vous expliquent comment YouTube applique certains aspects des conditions d'utilisation des API, mais ne remplacent pas les documents existants. Il répond à certaines des questions les plus courantes posées par les développeurs lors des audits de conformité des API. Nous espérons qu'elle simplifiera le processus de développement de fonctionnalités en vous aidant à comprendre comment nous interprétons et appliquons nos règles.

4 juin 2020

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

La fonctionnalité Bulletin de chaîne est désormais complètement obsolète. Cette modification, initialement annoncée le 17 avril 2020, est désormais effective. Par conséquent, la méthode activities.insert n'est plus acceptée et la méthode activities.list ne renvoie plus de bulletins de chaîne. Pour en savoir plus, consultez le Centre d'aide YouTube.

17 avril 2020

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

YouTube va abandonner la fonctionnalité de bulletin de chaîne. Par conséquent, la méthode activities.insert sera obsolète, et la méthode activities.list cessera de renvoyer des bulletins de chaîne. Ces modifications entreront en vigueur dans l'API à partir du 18 mai 2020. Pour en savoir plus, consultez le Centre d'aide YouTube.

31 mars 2020

Cette mise à jour inclut les changements suivants :

  • Nouvelles ressources et méthodes

    • La nouvelle ressource member représente le membre d'une chaîne YouTube. Un membre offre un soutien financier récurrent à un créateur et reçoit des 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 le cadre de l'API YouTube Live Streaming. La ressource sponsor est désormais obsolète, et les clients API doivent mettre à jour les appels à la méthode sponsors.list pour 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 de souscription du créateur.

10 janvier 2020

L'API vous permet désormais d'identifier les contenus destinés aux enfants que YouTube considère comme "conçus pour les enfants". Pour en savoir plus sur les contenus conçus pour les enfants, consultez le Centre d'aide YouTube.

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

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

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

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

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

Remarque:Cette modification affecte cette valeur de propriété même si un utilisateur envoie une demande autorisée de données sur sa propre chaîne. Les propriétaires de chaîne peuvent toujours voir le nombre exact d'abonnés dans YouTube Studio.

Par exemple, si une chaîne compte 123 456 abonnés, la propriété statistics.subscriberCount contient la valeur 123000. Le tableau ci-dessous montre comment le nombre d'abonnés est arrondi dans les réponses de l'API et abrégé dans d'autres interfaces utilisateur YouTube visibles par tous:

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

4 avril 2019

Cette mise à jour inclut les changements suivants :

  • La documentation de référence de l'API a été mise à jour pour mieux expliquer les cas d'utilisation courants de chaque méthode et pour fournir des exemples de code dynamiques et de haute qualité via le widget APIs Explorer. Consultez la documentation de la méthode channels.list pour obtenir un exemple. Les pages qui décrivent les méthodes API comportent désormais deux nouveaux éléments:

    • Le widget APIs Explorer vous permet de sélectionner des niveaux d'autorisation, de saisir des exemples de valeurs de paramètres et de propriétés, puis d'envoyer des requêtes API réelles et d'afficher les réponses réelles de l'API. Le widget propose également une vue plein écran présentant des exemples de code complets, mis à jour de façon dynamique pour utiliser les champs d'application et les valeurs que vous avez saisis.

    • La section Cas d'utilisation courants décrit un ou plusieurs cas d'utilisation courants de la méthode présenté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 voir plus facilement des exemples de code directement applicables au cas d'utilisation que vous essayez d'implémenter dans votre propre application.

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

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

    Parallèlement à ce changement, les pages listant précédemment des exemples de code disponibles pour Java, JavaScript, PHP et Python ont été supprimées.

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

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

9 juillet 2018

Cette mise à jour inclut les changements suivants :

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

    À partir de juillet 2018, les URL des miniatures de chaînes ne seront disponibles que dans le domaine https, qui s'affichera ainsi dans les réponses de l'API. Passé ce délai, des images non fonctionnelles pourront s'afficher dans votre application si elle tente de charger des images YouTube à partir du domaine http.

  • Remarque:Il s'agit d'une annonce de l'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 "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. Nous avons également supprimé les instructions pour les fonctionnalités qui ont depuis été abandonnées dans l'API v3, comme les vidéos favorites.

27 novembre 2017

Cette mise à jour inclut les changements suivants :

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

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

    Vous pouvez 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 une 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 sont traitées comme des opérations no-ops, ce qui signifie qu'elles n'effectueront aucune mise à jour.

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

16 novembre 2017

Cette mise à jour inclut les changements suivants :

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

    Les exemples personnalisables sont conçus pour vous offrir un point de départ spécifique à un cas d'utilisation pour une application Node.js. Cette fonctionnalité est semblable au code fourni dans le 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 utilise une liste de paires clé-valeur correspondant aux paramètres de requête de l'API et supprime les paramètres sans valeur.
    • La fonction createResource utilise une liste de paires clé/valeur correspondant aux propriétés d'une ressource d'API. Il convertit ensuite les propriétés en un objet JSON pouvant être utilisé dans les opérations insert et update. L'exemple ci-dessous montre un ensemble de noms et de valeurs de propriétés, ainsi que l'objet JSON que le code créerait pour ces propriétés :
      # 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 localement. Pour en savoir plus, consultez les conditions préalables à l'exécution d'exemples de code complets en local dans les instructions de l'outil d'extraits de code.

25 octobre 2017

Cette mise à jour inclut les changements suivants :

  • Les exemples de code Python de l'outil d'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 afficher les exemples complets (et cette modification):

    1. Accédez à l'outil d'extraits de code interactif ou à la documentation d'une méthode d'API, telle que channels.list.
    2. Cliquez sur l'onglet Python au-dessus des exemples de code.
    3. Cliquez sur le bouton d'activation au-dessus des onglets pour passer d'un extrait à un extrait complet.
    4. L'onglet devrait maintenant afficher un exemple de code complet utilisant le flux d'autorisation InstalledAppFlow. La description au-dessus de l'exemple explique cela et renvoie vers un exemple d'application de serveur Web.
    5. Cliquez sur le lien pour basculer vers 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 localement. Si vous souhaitez exécuter les exemples, consultez les instructions de l'outil d'extraits de code pour exécuter des exemples de code complets en local.

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 noter que si ce paramètre est défini sur true, le paramètre type doit être défini sur video.
  • La définition du paramètre regionCode de la méthode search.list a été mise à jour pour préciser que le paramètre limite les résultats de recherche aux vidéos pouvant être regardées dans la région spécifiée.
  • YouTube a mis à jour ses logos et icônes de branding. Vous pouvez télécharger les nouveaux logos "développés avec YouTube" sur la page des consignes relatives à la marque. D'autres logos et icônes YouTube sont également affichés sur cette page. Vous pouvez les télécharger sur le site de la marque YouTube.

24 juillet 2017

Cette mise à jour inclut les changements suivants :

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

    Remarque:L'outil est également intégré dans la documentation de référence de l'API pour les méthodes d'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, telles que 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 chaque méthode, l'outil affiche des extraits de code pour un ou plusieurs cas d'utilisation. Chaque cas d'utilisation décrit une méthode courante d'appel de cette méthode. Par exemple, vous pouvez appeler la méthode channels.list pour récupérer des données sur un canal spécifique ou sur le canal de l'utilisateur actuel.

    Vous pouvez également interagir avec des exemples de code:

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

    • Basculer entre les extraits de code et les exemples complets Un extrait de code montre la partie du code qui appelle la méthode API. Un exemple complet contient cet extrait, ainsi que du code récurrent permettant d'autoriser et d'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écuter 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 offrant toutes les 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.
    • Prise en charge des exemples Java.
    • Un code récurrent plus flexible et plus complet pour autoriser les utilisateurs et créer des requêtes API.

27 avril 2017

Cette mise à jour inclut les changements suivants :

30 mars 2017

Cette mise à jour inclut les changements suivants :

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

27 février 2017

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

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

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

En raison de cette modification, les thèmes liés à une vidéo sont désormais systématiquement renvoyés dans la valeur de la propriété topicDetails.relevantTopicIds[] de la ressource video.

29 novembre 2016

Cette mise à jour inclut les changements suivants :

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

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

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

10 novembre 2016

Cette mise à jour inclut les changements suivants :

  • Comme annoncé pour la première fois le 11 août 2016, l'abandon de Freebase et de l'API Freebase nécessite plusieurs modifications liées aux ID de thèmes. 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 en rapport avec un thème spécifique.

    À partir du 10 février 2017, YouTube commencera à renvoyer un petit ensemble d'ID de thèmes au lieu de l'ensemble beaucoup plus précis d'ID renvoyés jusqu'à présent. En outre, sachez qu'il n'est pas garanti que les chaînes et les vidéos soient associées à des thèmes, ce qui est cohérent avec le comportement actuel de l'API.

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

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

    Les propriétés suivantes seront bientôt obsolètes:

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

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

    En outre, plusieurs exemples de code liés aux ID de sujet ont été supprimés de la documentation de la méthode search.list.

2 novembre 2016

Cette mise à jour inclut les changements suivants :

  • Nouveaux paramètres et propriétés

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

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

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

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

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

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

      Par défaut, la hauteur de l'élément <iframe> renvoyé dans la propriété player.embedHtml est de 360 pixels. La largeur s'ajuste au format de la vidéo, ce qui permet de s'assurer que le lecteur intégré ne comporte pas de bandes noires encadrant la vidéo. Ainsi, si le format d'une vidéo est en 16:9, la largeur du lecteur sera de 640 pixels.

      Avec les nouveaux paramètres, vous pouvez indiquer que le code d'intégration doit utiliser une hauteur et/ou une largeur adaptées à la mise en page de votre application, au lieu des dimensions par défaut. Le serveur d'API adapte les dimensions du lecteur afin de s'assurer que le lecteur intégré ne comporte pas de bandes noires encadrant la vidéo. Notez que ces deux paramètres définissent les dimensions maximales du lecteur intégré. Par conséquent, si les deux paramètres sont spécifiés, il est possible qu'une dimension soit inférieure au nombre maximal autorisé pour celle-ci.

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

      • Si le paramètre maxHeight est défini sur 720, mais que le paramètre maxWidth n'est pas défini, l'API renvoie un lecteur de 1 280 x 720 pixels.
      • Si le paramètre maxWidth est défini sur 960, mais que le paramètre maxHeight n'est pas défini, l'API renvoie un lecteur de 960 x 540 pixels.
      • Si le paramètre maxWidth est défini sur 960, et le paramètre maxHeight sur 450, l'API renvoie un lecteur de 800 x 450 pixels.

      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 jusqu'à 10 sections sans définir de données de ciblage, et peut créer jusqu'à 100 sections 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 dans l'interface utilisateur du site YouTube.

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

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

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

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

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

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

    • La description de la méthode videos.insert a été mise à jour pour indiquer que la taille de fichier maximale pour les vidéos importées est passée de 64 Go à 128 Go.

  • Nouvelles erreurs et erreurs mises à jour

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

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

  • Autres nouveautés

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

15 septembre 2016

Cette mise à jour inclut les changements suivants :

  • La mise à jour de l'historique des révisions du 11 août 2016 portait sur plusieurs changements liés aux ID de thèmes, y compris sur le fait que l'ensemble des ID de thèmes acceptés va changer à compter du 10 février 2017. La liste des thèmes compatibles 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 à ce qu'un utilisateur YouTube déconnecté verra sur la page d'accueil.

      Il s'agit d'une légère modification destinée à offrir une meilleure expérience utilisateur que le comportement décrit dans la mise à jour de l'historique des révisions du 11 août 2016. Cette mise à jour indiquait que les requêtes utilisant le paramètre home renvoyaient une liste vide.

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

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

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

  • 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 parent fileDetails) ne pouvaient être récupérées que par le propriétaire de la vidéo.

11 août 2016

Cette mise à jour inclut les changements suivants :

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

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

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

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

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

    • À compter du 10 février 2017, YouTube commencera à renvoyer un petit ensemble d'ID de thèmes au lieu de l'ensemble beaucoup plus précis d'ID obtenus jusqu'à présent. Cet ensemble de thèmes disponibles permet d'identifier des catégorisations générales telles que Sports ou Basket-ball, mais pas des équipes ou des joueurs spécifiques. Nous allons annoncer la liste des thèmes pris en charge afin que vous ayez le temps de préparer votre demande à ce changement.

    • Tous les ID de sujets Freebase que vous avez déjà récupérés peuvent être utilisés pour rechercher du contenu jusqu'au 10 février 2017. Cependant, une fois ce délai écoulé, vous ne pourrez utiliser que le plus petit ensemble de sujets identifiés au niveau de l'élément précédent pour obtenir des résultats de recherche par thème.

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

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

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

    • Seul un utilisateur autorisé peut voir les propriétés contentDetails.relatedPlaylists.watchHistory et contentDetails.relatedPlaylists.watchLater de la ressource channel pour récupérer des données sur sa propre chaîne. Après le 12 septembre 2016, contentDetails.relatedPlaylists.watchHistory affichera la valeur HL, et la propriété contentDetails.relatedPlaylists.watchLater affichera une valeur de WL pour tous les canaux.

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

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

13 juin 2016

Cette mise à jour inclut les changements suivants :

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

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

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

31 mai 2016

Cette mise à jour inclut les changements suivants :

  • Le nouveau paramètre myRecentSubscribers de la méthode subscriptions.list récupère la liste des abonnés à la chaîne de l'utilisateur authentifié, dans l'ordre chronologique inverse de l'heure à laquelle 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 sur 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, résultat de recherche, vignette et vidéo pour indiquer que d'autres tailles d'image de miniature sont disponibles pour certaines vidéos.

    • L'image standard mesure 640 pixels de large et 480 pixels de haut.
    • L'image maxres mesure 1 280 pixels de large et 720 pixels de haut.
  • La définition du paramètre part de la méthode channelSection.list a été mise à jour pour indiquer que la partie targeting peut être récupérée au prix de 2 unités de quota.

  • La méthode videos.list renvoie désormais une erreur forbidden (403) lorsqu'une requête mal autorisée tente de récupérer les parties fileDetails, processingDetails ou suggestions d'une ressource video. Seul le propriétaire de la vidéo a accès à ces parties.

17 mai 2016

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

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

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

Pour chaque cas d'utilisation, l'outil affiche les paramètres utilisés dans la requête API. Vous pouvez modifier les valeurs des paramètres. Dans ce cas, l'outil met à jour les extraits de code pour refléter les valeurs 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ètres que vous avez fournies. Notez que vous devez autoriser l'outil à envoyer des requêtes en votre nom pour que les réponses de l'API s'affichent.

28 avril 2016

Cette mise à jour inclut les changements suivants :

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

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

    • La propriété recordingDetails.location indique le lieu que le propriétaire de la vidéo souhaite associer à celle-ci. Ce lieu peut être modifié, inclus dans l'index de recherche pour les vidéos publiques et visible par les utilisateurs dans le cas de 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 mis en ligne. Seul le propriétaire de la vidéo peut voir cette valeur.

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

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

20 avril 2016

Cette mise à jour inclut les changements suivants :

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

  • La section Utilisation du quota du guide de démarrage a été mise à jour pour être associée à la Google Developers Console, où vous pouvez consulter votre quota réel et votre utilisation réelle.

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 la chaîne importée est de 2 560 x 1 440 pixels. La taille minimale (2 048 x 1 152 pixels) n'a pas été modifiée.

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

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

    • La réponse de l'API à une requête search.list contient désormais une propriété regionCode. La propriété identifie le code régional utilisé pour la requête de recherche. Le code de région indique à l'API de renvoyer des 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 acceptées. La valeur par défaut est US. Si vous spécifiez une région non compatible, YouTube peut 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 prend désormais en charge le paramètre hl, qui spécifie la langue à utiliser pour le texte des libellés dans la réponse de l'API. La valeur par défaut du paramètre est en_US.

    • La nouvelle propriété contentDetails.contentRating.ecbmctRating de la ressource video indique la classification d'une vidéo fournie par l'Autorité turque d'évaluation et de classification du ministère de la Culture et du Tourisme.

      En outre, les propriétés d'API des autres systèmes de classification prennent en charge les nouvelles valeurs de propriété suivantes:

      • contentDetails.contentRating.fpbRating (Afrique du Sud)
        Note: 10 ; valeur de l'établissement: 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 indiquée que si la vidéo est une diffusion en direct pour laquelle le chat en direct est activé. Une fois la diffusion terminée et le chat en direct terminé, la propriété n'est plus renvoyée pour la vidéo.

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

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

    Type d'erreur Détails de l'erreur Description
    badRequest (400) notEditable Les méthodes channelSections.insert, channelSections.update et channelSections.delete renvoient cette erreur pour indiquer que la section de chaîne spécifiée ne peut pas être créée, mise à jour ou supprimée.
    badRequest (400) styleRequired Les méthodes channelSections.insert et channelSections.update renvoient cette erreur pour indiquer que la ressource channelSection envoyée dans la requête API doit spécifier une valeur pour la propriété snippet.style.
    badRequest (400) typeRequired Les méthodes channelSections.insert et channelSections.update renvoient cette erreur pour indiquer que la ressource channelSection envoyée dans la requête API doit spécifier une valeur pour la propriété snippet.type.
    badRequest (400) processingFailure La méthode commentThreads.list renvoie cette erreur pour indiquer que le serveur d'API n'a pas réussi à traiter la requête. Bien qu'il puisse s'agir d'une erreur temporaire, elle indique généralement que l'entrée de la requête n'est pas valide. Vérifiez la structure de la ressource commentThread dans le corps de la requête pour vous assurer qu'elle est valide.
    forbidden (403) commentsDisabled La méthode commentThreads.list renvoie cette erreur pour indiquer que les commentaires sont désactivés dans 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 en cours d'insertion contient trop de caractères dans la propriété snippet.topLevelComment.snippet.textOriginal.
    invalidValue (400) videoAlreadyInAnotherSeriesPlaylist La méthode playlistItems.insert renvoie cette erreur pour indiquer que la vidéo que vous essayez d'ajouter à la playlist se trouve déjà dans une autre playlist de séries. Pour en savoir plus sur les playlists de séries, consultez le Centre d'aide YouTube.
    badRequest (400) subscriptionForbidden La méthode subscriptions.insert renvoie cette erreur pour indiquer que vous avez atteint le nombre maximal d'abonnements ou que vous avez créé un trop grand nombre d'abonnements récents. Dans ce dernier cas, vous pouvez réessayer d'envoyer la requête après quelques heures.
    badRequest (400) invalidCategoryId La méthode videos.update renvoie cette erreur pour indiquer que la propriété snippet.categoryId de la ressource video importée a spécifié un ID de catégorie non valide. Utilisez la méthode videoCategories.list pour récupérer les catégories acceptées.
    badRequest (400) invalidDescription La méthode videos.update renvoie cette erreur pour indiquer que la propriété snippet.description de la ressource video importée a spécifié une valeur non valide.
    badRequest (400) invalidPublishAt La méthode videos.update renvoie cette erreur pour indiquer que la propriété status.publishAt de la ressource video importée a spécifié une heure de publication 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 a spécifié des détails d'enregistrement non valides.
    badRequest (400) invalidTags La méthode videos.update renvoie cette erreur pour indiquer que la propriété snippet.tags de la ressource video importée a spécifié une valeur non valide.
    badRequest (400) invalidTitle La méthode videos.update renvoie cette erreur pour indiquer que la propriété snippet.title de la ressource video importée a spécifié un titre de vidéo non valide ou vide.
    badRequest (400) invalidVideoMetadata La méthode videos.update renvoie cette erreur pour indiquer que les métadonnées de la requête ne sont pas valides. Cette erreur se produit si la requête met à jour la partie snippet d'une ressource video, mais ne définit 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), les utilisateurs finaux de l'UE doivent divulguer certaines informations et obtenir leur autorisation. Par conséquent, si vous êtes un utilisateur final de l'Union européenne, vous devez respecter les Règles relatives au consentement de l'utilisateur dans l'UE. Nous avons ajouté une notification à ce sujet dans les Conditions d'utilisation de l'API YouTube.

19 novembre 2015

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

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

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

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

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

      L'exemple d'extrait ci-dessous définit l'anglais comme langue par défaut de la ressource. Il ajoute également des descriptions et des titres 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 ensuite demandé l'ajout de données en portugais à 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 accepte deux méthodes pour récupérer des valeurs localisées pour une ressource:

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

      Par exemple, supposons qu'une requête videos.list récupère les données de la vidéo décrite ci-dessus, avec des données localisées en allemand et en espagnol. Si le paramètre hl est défini sur de, la ressource contient 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 détails localisés en français ne sont pas disponibles.

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

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

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

  • Erreurs liées aux valeurs de texte localisé

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

    Type d'erreur Détails de l'erreur Description
    badRequest (400) defaultLanguageNotSetError Cette erreur indique qu'une requête qui tente d'insérer ou de mettre à jour l'objet localizations d'une ressource échoue, car la propriété snippet.defaultLanguage n'est pas définie pour cette ressource. Les méthodes channels.update, channelSections.insert, channelSections.update, playlists.insert, playlists.update, videos.insert et videos.update acceptent cette erreur.
    badRequest (400) localizationValidationError Cette erreur indique que la validation de l'une des valeurs de l'objet localizations d'une ressource a échoué. Par exemple, cette erreur peut se produire si l'objet contient un code de langue incorrect. 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 des diffusions, alors que celles-ci sont toujours en cours.

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

    • La définition de la propriété snippet.publishedAt de la ressource video a été mise à jour pour indiquer que la valeur de la propriété, qui spécifie la date et l'heure de publication de la vidéo, peut être différente de l'heure de mise en ligne. 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é indique l'heure à laquelle elle a été rendue publique. La nouvelle définition explique également comment cette valeur est renseignée pour les vidéos privées et non répertoriées.

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

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

      • Si vous définissez la valeur de cette propriété lorsque vous appelez la méthode videos.update, vous devez également définir la valeur de la propriété status.privacyStatus sur private, même si la vidéo est déjà privée.
      • Si la demande planifie la publication d'une vidéo par le passé, elle est publiée immédiatement. Par conséquent, le fait de définir la propriété status.publishAt sur une date et une heure dans le passé est le même que de faire passer l'privacyStatus de la vidéo de private à public.
    • La propriété contentDetails.contentRating.cncRating de la ressource video spécifie la note de la vidéo fournie 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 du paramètre brandingSettings.channel.keywords de la ressource channel a été mise à jour pour indiquer correctement que la valeur de la propriété contient une liste de chaînes séparées par des espaces et non une liste d'éléments séparés par une virgule, comme indiqué précédemment. Cette mise à jour ne reflète pas un changement de comportement de l'API.

    • La documentation de la méthode thumbnails.set a été mise à jour pour indiquer précisément que le corps de la requête contient l'image miniature que vous importez et associez à une vidéo. Le corps de la requête ne contient pas de ressource thumbnail. Auparavant, la documentation indiquait qu'il ne fallait 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 tenir compte du fait que la méthode activities.list n'inclut actuellement aucune ressource liée aux nouveaux commentaires sur une vidéo. Les champs snippet.type et contentDetails.comment de la ressource ont également été mis à jour.

  • Nouvelles erreurs et erreurs mises à jour

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

      Informations sur l'erreur
      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 en cours d'insertion ou de 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 demande n'est pas autorisée à insérer, mettre à jour ou supprimer l'élément de playlist spécifié.
      playlists.delete
      playlists.insert
      playlists.update
      Code de réponse HTTPbadRequest (400)
      MotifplaylistForbidden
      DescriptionCette opération est interdite ou la requête n'est pas correctement autorisée.
      search.list
      Code de réponse HTTPbadRequest (400)
      MotifinvalidLocation
      DescriptionLe format des valeurs des paramètres location et/ou locationRadius n'est pas valide.
      search.list
      Code de réponse HTTPbadRequest (400)
      MotifinvalidRelevanceLanguage
      DescriptionLe format de la valeur du paramètre relevanceLanguage est incorrect.
      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 autorisé
      • Vous essayez de vous abonner à votre propre chaîne, mais ce n'est pas possible.
      • Vous avez créé trop d'abonnements récemment et devez attendre quelques heures avant de réessayer d'envoyer la demande.
      videos.update
      Code de réponse HTTPbadRequest (400)
      MotifinvalidDefaultBroadcastPrivacySetting
      DescriptionLa requête tente de définir un paramètre de confidentialité non valide pour la diffusion par défaut.

28 août 2015

Cette mise à jour inclut les changements suivants :

  • Mises à jour des ressources et méthodes existantes

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

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

7 août 2015

Cette mise à jour inclut les changements suivants :

  • Mises à jour des ressources et méthodes existantes

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

      Plus précisément, la définition explique maintenant que si un tag contient un espace, le serveur d'API traite la valeur du tag comme si elle était entre guillemets, lesquels sont comptabilisés dans le nombre maximal de caractères. Ainsi, dans le cadre de la limitation du nombre de caractères, le tag Foo-Baz contient sept caractères, mais le tag Foo-Baz en contient neuf.

    • La méthode commentThreads.insert n'accepte plus le paramètre shareOnGooglePlus, qui indiquait précédemment si un commentaire et ses réponses 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 le gère autrement.

18 juin 2015

Cette mise à jour inclut les changements suivants :

  • Mises à jour des ressources et méthodes existantes

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

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

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

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

  • Nouvelles erreurs et erreurs mises à jour

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

      Informations sur l'erreur
      videos.rate
      Code de réponse HTTPbadRequest (400)
      MotifemailNotVerified
      DescriptionL'utilisateur doit valider son adresse e-mail avant de donner son avis sur la vidéo.
      videos.rate
      Code de réponse HTTPbadRequest (400)
      MotifvideoPurchaseRequired
      DescriptionLes vidéos en location ne peuvent être évalué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 les raisons pour lesquelles une vidéo peut être signalée comme présentant du contenu abusif. La méthode videoAbuseReportReasons.list vous permet de récupérer la liste de toutes les raisons pour lesquelles des vidéos peuvent être signalées.

    • La nouvelle méthode videos.reportAbuse permet de signaler une vidéo comportant du contenu abusif. Le corps de la demande contient un objet JSON qui précise la vidéo signalée et la raison pour laquelle elle est considérée comme présentant du contenu abusif. Pour obtenir des raisons valables, vous pouvez utiliser la méthode videoAbuseReportReason.list décrite ci-dessus.

      Le guide de migration contient également un exemple permettant de signaler une vidéo abusive. Avec ce changement, la version 3 de l'API est désormais compatible avec toutes les fonctionnalités de la version 2 qui devraient lui être prises en charge. Ces fonctionnalités sont également expliquées dans le guide de migration.

  • Mises à jour des ressources et méthodes existantes

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

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

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

      Cette nouvelle fonctionnalité est semblable, bien que pas identique, aux balises de développeur compatibles avec la version 2 de l'API.

    • 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 pour 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 d'une section de chaîne permet de restreindre la visibilité d'une section de contenu aux utilisateurs répondant à certains critères.

      L'API propose trois options de ciblage. Pour être visible, un utilisateur doit remplir tous les paramètres de ciblage pour qu'une section de chaîne soit visible.

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

    • La documentation de la méthode channelSections.delete, playlistItems.delete, playlists.delete, subscriptions.delete et videos.delete a été corrigée pour refléter le fait que, lorsque l'opération réussit, ces méthodes renvoient toutes un code de réponse HTTP 204 (No Content).

  • Nouvelles erreurs et erreurs mises à jour

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

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

    Il décrit également plusieurs fonctionnalités de commentaires non compatibles avec la version 2 de l'API, mais qui sont compatibles avec la version 3 de l'API. Par exemple :

    • Récupérer des commentaires à propos d'une chaîne
    • Récupérer 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.
    • Mettre à jour 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 tenir compte du fait que les notifications ne sont envoyées qu'au hub Google PubSubHubBub, et non au hub Superfeedr, comme indiqué précédemment.

9 avril 2015

Cette mise à jour inclut les changements suivants :

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

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

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

      L'API est compatible avec les méthodes suivantes pour les ressources commentThread:

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

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

      L'API est compatible avec les méthodes suivantes pour les ressources comment:

      • comments.list : récupère une liste de commentaires. Utilisez cette méthode pour récupérer toutes les réponses à un commentaire particulier.
      • comments.insert : permet de créer une réponse à un commentaire existant.
      • comments.update : permet de modifier un commentaire.
      • comments.markAsSpam : permet de signaler un ou plusieurs commentaires comme spam.
      • comments.setModerationStatus : permet de définir l'état de modération d'un ou de plusieurs commentaires. Par exemple, effacez un commentaire pour l'afficher publiquement ou refusez un commentaire comme inadapté à l'affichage. 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 : supprimer 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 que l'API accepte désormais les notifications push via PubSubHubBub, un protocole de publication et d'abonnement de serveur à serveur pour les ressources accessibles sur le Web. Votre serveur de rappel PubSubHubBub peut recevoir des notifications de flux Atom lorsqu'un canal effectue l'une des activités suivantes:

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

  • Le guide de migration a également été mis à jour pour tenir compte de la prise en charge des notifications push. Toutefois, la version 2 de l'API prenant en charge de nombreux autres types de notifications push non compatibles avec la version 3, la mention de la compatibilité avec PubSubHubBub reste indiquée dans la section Obsolète de ce guide.

  • Le nouveau champ d'application https://www.googleapis.com/auth/youtube.force-ssl de l'API est désormais un champ d'application valide pour toute méthode d'API qui prenait auparavant en charge le champ d'application https://www.googleapis.com/auth/youtube.

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

    Type d'erreur Détails de l'erreur Description
    badRequest (400) invalidRating La méthode videos.rate renvoie cette erreur si la requête contient une valeur inattendue pour le paramètre rating.
  • La méthode subscriptions.insert n'est plus compatible avec l'erreur subscriptionLimitExceeded, qui indiquait précédemment que l'abonné identifié à la requête avait dépassé la limite du nombre d'abonnements.

2 avril 2015

Cette mise à jour inclut les changements suivants :

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

    L'API est compatible avec les méthodes permettant de lister, 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 encore la fonctionnalité de sous-titrage dans la version 2 de l'API.

  • Le nouveau champ d'application https://www.googleapis.com/auth/youtube.force-ssl de l'API nécessite une communication avec le serveur d'API via une connexion SSL.

    Ce nouveau champ d'application accorde le même accès que le champ d'application https://www.googleapis.com/auth/youtube. D'un point de vue fonctionnel, ces deux champs d'application sont identiques, car le serveur d'API YouTube n'est disponible que via un point de terminaison HTTPS. Par conséquent, même si le champ d'application https://www.googleapis.com/auth/youtube ne nécessite pas de connexion SSL, il n'existe en réalité aucun autre moyen d'envoyer une requête API.

    Le nouveau champ d'application est requis pour les appels à toutes les méthodes de la ressource caption.

11 mars 2015

Cette mise à jour inclut les changements suivants :

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

  • Le guide de migration de l'API YouTube Data (v3) a été mis à jour pour indiquer que la version 3 de l'API est compatible avec les fonctionnalités suivantes 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 la version 2 de l'API ne seront pas compatibles avec la version 3:

    • Récupérer les recommandations de vidéos : la version 3 de l'API ne récupère pas de liste contenant uniquement les vidéos recommandées pour l'utilisateur actuel de l'API. Toutefois, vous pouvez utiliser la version 3 de l'API 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 expliquant pourquoi la vidéo a été recommandée. Notez que nous ne pouvons pas garantir que la réponse contiendra un nombre spécifique de vidéos recommandées.

    • Récupérer des suggestions de canaux

    • Récupérer de nouvelles vidéos d'abonnement : la version 3 de l'API ne récupère pas de liste contenant uniquement les vidéos récemment mises en ligne sur des chaînes auxquelles l'utilisateur de l'API est abonné. Toutefois, vous pouvez utiliser la version 3 de l'API pour rechercher 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 d'abonnement si la valeur de la propriété snippet.type est upload. Notez que nous ne pouvons pas garantir que la réponse contiendra un nombre spécifique de nouvelles vidéos disponibles sur abonnement.

    • Compatibilité avec les flux RSS

    • Notifications push pour les mises à jour de flux : la version 2 de l'API prend en charge les notifications push, à l'aide du protocole SUP (Simple Update Protocol) ou de PubSubHubbub, pour surveiller les flux d'activité des utilisateurs de YouTube. Des notifications ont été envoyées pour les nouveaux abonnements à des chaînes et pour les vidéos notées, partagées, marquées comme favorites, commentées ou mises en ligne.

      L'API v3 prendra en charge les notifications push à l'aide du protocole PubSubHubbub, mais celles-ci ne couvriront que les mises en ligne de vidéos et les mises à jour des titres ou descriptions des vidéos.

    • Emplacement de la chaîne : la version 2 de l'API utilisait la balise <yt:location> pour identifier la situation géographique de l'utilisateur, telle que saisie dans le profil public YouTube de la chaîne. Certains développeurs utilisaient ce champ pour associer un canal à un pays en particulier, mais ses données n'ont pas pu être utilisées de façon cohérente à cette fin.

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

      La version 3 de l'API fournira une fonctionnalité similaire, mais pas identique. Plus précisément, un développeur pourra rechercher des vidéos mises en ligne par sa propre 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 Play 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 la version 2 de l'API, 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 la version 3 de l'API, les éléments de la playlist sont généralement triés par position dans l'ordre croissant, et les autres options de tri ne sont pas disponibles.

      Il existe quelques exceptions. Une nouvelle vidéo mise en ligne, une vidéo favorite, une vidéo "J'aime" ou une vidéo visionnée récemment est automatiquement ajoutée en tant que premier élément (snippet.position=0) pour les types de playlists suivants. Chacune de ces listes est donc triée de l'élément le plus récent au plus ancien, en fonction de l'heure à laquelle les éléments ont été ajoutés à la liste.

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

      Notez toutefois qu'un nouvel élément ajouté à la playlist "À regarder plus tard" est le dernier élément de la liste, de sorte qu'elle est triée du plus ancien au plus récent.

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

    Grâce à ces modifications, le guide identifie 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 prennent désormais en charge le paramètre onBehalfOfContentOwner, qui est déjà compatible avec plusieurs autres méthodes.

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

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

    Remarque:Aucune de ces propriétés n'était soumise au règlement relatif aux abandons de l'API.

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

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

    Type d'erreur Détails de l'erreur Description
    notFound (404) channelNotFound La méthode channels.update renvoie cette erreur si le paramètre id de la requête spécifie un canal introuvable.
    badRequest (400) manualSortRequiredinvalidValue Les méthodes playlistItems.insert et playlistItems.update renvoient cette erreur si la requête tente de définir la position de l'élément de la playlist, mais que la playlist n'utilise pas le tri manuel. Par exemple, les éléments d'une playlist peuvent être triés par date ou par popularité. Vous pouvez corriger cette erreur en supprimant l'élément snippet.position de la ressource envoyée dans le corps de la requête. Si vous 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 d'ordre de lecture sur Manuel. Vous pouvez modifier ce paramètre dans le Gestionnaire de vidéos YouTube.
    forbidden (403) channelClosed La méthode playlists.list renvoie cette erreur si le paramètre channelId de la requête spécifie un canal qui a été fermé.
    forbidden (403) channelSuspended La méthode playlists.list renvoie cette erreur si le paramètre channelId de la requête spécifie un canal suspendu.
    forbidden (403) playlistForbidden La méthode playlists.list renvoie cette erreur si le paramètre id de la requête n'est pas compatible avec la requête ou si celle-ci n'est pas autorisée correctement.
    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 la version 3 pour mettre en ligne des vidéos via JavaScript. Pour en savoir plus, consultez la section Mettre en ligne une vidéo. Cette fonctionnalité est comparable à la fonctionnalité d'importation via le navigateur compatible avec la version 2 de l'API. Notez que cette modification du guide de migration ne reflète pas une modification réelle de l'API, mais la disponibilité d'un nouvel exemple de code permettant d'importer des vidéos avec JavaScript côté client.

    Étant donné qu'il était possible d'importer des vidéos à l'aide de la bibliothèque cliente JavaScript et de CORS, le guide de migration ne mentionne plus la fonctionnalité d'importation via un navigateur qui pourrait être abandonnée dans la version 3 de l'API.

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

11 novembre 2014

Cette mise à jour inclut les changements suivants :

  • Le coût du quota d'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 à moindre coût. Examinons par exemple les deux méthodes ci-dessous pour trouver des vidéos mises en ligne sur la chaîne GoogleDevelopers.

    • Coût du quota: 100 unités

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

    • Coût du quota: 6 unités

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

      Appelez ensuite la méthode playlistItems.list 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 cette fonctionnalité doit d'abord être activée.
      • disallowed : la chaîne n'est pas autorisée à mettre en ligne des vidéos de plus de 15 minutes.

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

    • La propriété invideoPromotion.useSmartTiming indique si la campagne promotionnelle de la chaîne utilise la "chronologie intelligente". Cette fonctionnalité essaie d'afficher les publicités à un moment de la vidéo où les internautes sont plus enclins à cliquer dessus et moins susceptibles de perturber l'expérience de visionnage. Cette fonctionnalité sélectionne une seule publicité à 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 de l'Office of Film and Literature Classification en Nouvelle-Zélande, accepte désormais deux nouvelles classifications: oflcRp13 et oflcRp16. Elles correspondent respectivement aux notes RP13 et RP16.

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

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

12 septembre 2014

Cette mise à jour inclut les changements suivants :

13 août 2014

Cette mise à jour inclut les changements suivants :

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

    Type d'erreur Détails de l'erreur Description
    badRequest subscriptionLimitExceeded L'abonné identifié dans la requête a dépassé la limite du nombre d'abonnements. Vous pourrez essayer d'autres abonnements dans quelques heures.

12 août 2014

Cette mise à jour inclut les changements suivants :

  • Un nouveau guide, intitulé Migration de votre application vers l'API YouTube Data (v3), explique comment utiliser l'API YouTube Data (v3) pour exploiter les fonctionnalités disponibles dans l'API YouTube Data (v2). L'ancienne API est officiellement obsolète depuis le 4 mars 2014. L'objectif de ce guide est de vous aider à migrer les applications qui utilisent encore la version 2 de l'API vers la version la plus récente.

8 juillet 2014

Cette mise à jour inclut les changements suivants :

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

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

18 juin 2014

Cette mise à jour inclut les changements suivants :

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

    N'oubliez pas que les coûts des quotas peuvent changer sans avertissement préalable.

  • La ressource video est désormais compatible avec 43 nouveaux systèmes de classification du contenu, qui identifient les classifications que les vidéos reçoivent de diverses agences nationales de classification. {35,454,444,{35,45 Italie, Suisse, 34{/1,,{35, Italie, Singapour,14,{35,48,15}15 ,it

28 mai 2014

Cette mise à jour inclut les changements suivants :

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

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

    • Le paramètre locationRadius spécifie la distance maximale entre le lieu associé à une vidéo et le centre de la zone pour que la vidéo soit quand même incluse dans les résultats de recherche.

13 mai 2014

Cette mise à jour inclut les changements suivants :

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

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

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

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

  • La définition de la propriété position.cornerPosition de la ressource watermark a été mise à jour pour indiquer que le filigrane apparaît toujours dans l'angle supérieur droit du lecteur.

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

  • La définition de la propriété pageInfo.totalResults renvoyée dans une réponse d'API à un appel search.list a été mise à jour pour indiquer que la valeur est approximative et peut ne pas représenter une valeur exacte. La valeur maximale est également de 1 000 000. Vous ne devez pas utiliser cette valeur pour créer des liens de pagination. Utilisez plutôt les valeurs de propriété 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 refléter le fait que l'API renvoie un code de réponse HTTP 204 pour les requêtes réussies vers ces méthodes.

2 mai 2014

Cette mise à jour inclut les changements suivants :

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

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

  • La nouvelle ressource i18nRegion identifie la zone géographique qu'un utilisateur YouTube peut sélectionner comme région de contenu préférée. La région du contenu peut également être désignée par l'expression "Paramètres régionaux du contenu". Pour le site Web YouTube, une région de contenu peut être automatiquement sélectionnée en fonction d'heuristiques comme le domaine YouTube ou 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 accepte une méthode permettant de lister les régions de contenu compatibles. Les codes régionaux acceptés peuvent être utilisés comme valeur du paramètre regionCode lors de l'appel de méthodes d'API telles que search.list, videos.list, activities.list et videoCategories.list.

7 avril 2014

Cette mise à jour inclut les changements suivants :

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

    L'API est compatible avec les méthodes permettant de lister, insérer, mettre à jour ou supprimer des sections de canaux. Vous pouvez récupérer la liste des sections de la chaîne de l'utilisateur authentifié en spécifiant un ID de chaîne spécifique ou une liste d'ID de section 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é mise à jour pour expliquer que cet objet ne sera renvoyé que si la propriété processingDetails.fileDetailsAvailability de la vidéo a la valeur available.

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

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

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

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

31 mars 2014

Cette mise à jour inclut les changements suivants :

13 mars 2014

Cette mise à jour inclut les changements suivants :

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

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

    Ressource Propriété Durée maximale
    channel invideoPromotion.items[].customMessage 40 caractères
    video snippet.title 100 caractères
    video snippet.description 5 000 octets
    video snippet.tags 500 caractères. Notez que la valeur de la propriété est une liste et que les virgules entre les éléments de la liste sont comptabilisées dans la limite.
  • La propriété brandingSettings.watch.featuredPlaylistId de la ressource channel est obsolète. L'API renverra une erreur si vous tentez de définir sa valeur.

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

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

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

    Type d'erreur Détails de l'erreur Description
    badRequest (400) invalidCriteria La méthode channels.list renvoie cette erreur si la requête spécifie des paramètres de filtre qui ne peuvent pas être utilisés conjointement.
    badRequest (400) channelTitleUpdateForbidden La méthode channels.update renvoie cette erreur si vous essayez de mettre à jour la partie brandingSettings d'un canal et de modifier la valeur de la propriété brandingSettings.channel.title. Notez que l'API ne renvoie pas 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 plus d'articles que le nombre autorisé.
    forbidden (403) promotedVideoNotAllowed La méthode channels.update renvoie cette erreur si la propriété invideoPromotion.items[].id.videoId spécifie un ID vidéo introuvable ou qui ne peut pas être utilisé comme élément promu.
    forbidden (403) websiteLinkNotAllowed La méthode channels.update renvoie cette erreur si la propriété invideoPromotion.items[].id.websiteUrl spécifie une URL non autorisée.
    required (400) requiredTimingType La méthode channels.update renvoie cette erreur si une requête ne spécifie pas de paramètres de codes temporels par défaut pour l'affichage d'un article mis en avant par YouTube.
    required (400) requiredTiming La méthode channels.update doit spécifier un objet invideoPromotion.items[].timing pour chaque article promu.
    required (400) requiredWebsiteUrl La méthode channels.update doit spécifier une propriété invideoPromotion.items[].id.websiteUrl pour chaque article dont vous faites la promotion.
    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 qu'il n'est pas nécessaire de spécifier une valeur pour un seul paramètre de filtre lorsque vous envoyez une requête de recherche. À la place, vous pouvez définir une valeur pour zéro paramètre de filtre ou pour un paramètre de filtrage.

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

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

  • La taille minimale des images de bannière de chaîne importées a été réduite à 2 048 x 1 152 pixels. (Auparavant, la taille minimale était de 2 120 x 1 192 pixels.) En outre, notez que la documentation de la ressource channel spécifie les tailles maximales de toutes les images de bannière diffusées à partir de l'API. Par exemple, la taille maximale de l'image brandingSettings.image.bannerTvImageUrl pour les applications TV est de 2 120 x 1 192 px, mais l'image réelle peut mesurer 2 048 x 1 152 px. Le Centre d'aide YouTube fournit des conseils supplémentaires pour optimiser l'affichage de votre illustration de chaîne sur différents types d'appareils.

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

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

  • La méthode channels.update prend désormais en charge les mises à jour de la propriété invideoPromotion.items[].promotedByContentOwner. Cet établissement indique si le nom du propriétaire du contenu sera affiché lors de l'affichage de la promotion. Elle ne peut être définie que si la requête API qui définit la valeur de la propriété est effectuée au nom du propriétaire de contenu à l'aide du paramètre onBehalfOfContentOwner.

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

  • La propriété contentDetails.contentRating.acbRating peut désormais spécifier une classification 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 indiquent la classification qu'une vidéo a reçue selon le Système de classification de la télévision canadienne et le système de classification de la régie du cinéma de langue française, utilisé au Québec, respectivement.

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

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

24 octobre 2013

Cette mise à jour inclut les changements suivants :

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

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

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

      • upcoming : la vidéo est une diffusion en direct qui n'a pas encore commencé.
      • active : la vidéo est une diffusion en direct.
      • none : la vidéo n'est ni une diffusion en direct à venir, ni active. Il s'agira de la valeur de la propriété des 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 le contenu diffusé en direct ont été publiées le 1er octobre 2013 : le paramètre eventType de la méthode search.list et la propriété snippet.liveBroadcastContent du résultat de recherche.

  • La méthode videos.insert est désormais compatible avec le paramètre notifySubscribers, qui indique si YouTube doit envoyer une notification concernant la nouvelle vidéo aux utilisateurs qui s'abonnent à la chaîne de la vidéo. La valeur par défaut de ce paramètre est True. Elle indique que les abonnés seront informés des nouvelles vidéos mises en ligne. Toutefois, un propriétaire de chaîne qui met en ligne de nombreuses vidéos peut préférer définir la valeur False pour éviter d'envoyer une notification aux 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. En outre, la liste a été modifiée afin d'identifier les propriétés brandingSettings modifiables. Ces propriétés brandingSettings étaient déjà modifiables. Le changement apporté à la documentation ne reflète donc pas un changement apporté aux fonctionnalités existantes de l'API.

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

  • La méthode playlists.insert prend désormais en charge 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, ce qui correspond à une note TV-14.

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

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

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

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

1er octobre 2013

Cette mise à jour inclut les changements suivants :

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

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

    Par défaut, la chaîne est identique à celle pour laquelle les données de la promotion dans des vidéos sont définies. Toutefois, vous pouvez promouvoir la dernière vidéo 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 la chaîne.

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

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

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

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

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

  • La méthode search.list prend désormais en charge le paramètre eventType, qui limite une recherche pour qu'elle ne renvoie que les événements de diffusion actifs, à venir ou terminés.

  • La nouvelle propriété contentDetails.contentRating.mibacRating identifie la classification qu'une vidéo a reçue du Ministero dei Beni e delle Attivita Culturali e del Turismo.

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

    Type d'erreur Détails de l'erreur Description
    badRequest invalidImage La méthode thumbnails.set renvoie cette erreur si le contenu de l'image fourni n'est pas valide.
    forbidden videoRatingDisabled La méthode videos.rate renvoie cette erreur si le propriétaire de la vidéo évaluée a désactivé les avis sur 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 donnée. Vous pouvez également spécifier un canal cible vers lequel l'image sera associée, ainsi que des informations temporelles qui déterminent le moment où le filigrane apparaît lors de la lecture de la vidéo et sa durée de visibilité.

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

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

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

  • La méthode playlists.list accepte désormais les paramètres onBehalfOfContentOwner et onBehalfOfContentOwnerChannel. Ces deux paramètres sont déjà pris en charge 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étails de l'erreur Description
    forbidden insufficientPermissions Les champs d'application associés au jeton OAuth 2.0 fourni pour la requête sont insuffisants pour accéder aux données demandées.

15 août 2013

Cette mise à jour inclut les changements suivants :

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

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

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

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

    • Les propriétés liées aux paramètres de codes temporels permettant d'afficher les articles sponsorisés lors de 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 temporelles pour chaque article promu dans la liste invideoPromotion.items[].

      • Le nouvel objet invideoPromotion.defaultTiming définit les paramètres temporels par défaut de votre promotion. Ces paramètres permettent de définir à quel moment l'article que vous promouvez s'affiche pendant la lecture de l'une des vidéos de votre chaîne. Vous pouvez remplacer les paramètres de synchronisation par défaut pour n'importe quel article promu à l'aide de l'objet invideoPromotion.items[].timing.

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

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

  • La méthode subscriptions.list accepte désormais les paramètres onBehalfOfContentOwner et onBehalfOfContentOwnerChannel. Ces deux paramètres sont déjà pris en charge 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 pour la méthode playlistItems.insert a également été supprimé, car la fonctionnalité présentée 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étails de l'erreur Description
    badRequest invalidMine Le paramètre mine ne peut pas être utilisé dans les demandes pour lesquelles l'utilisateur authentifié est un partenaire YouTube. Vous devez soit supprimer le paramètre mine, vous authentifier en tant qu'utilisateur YouTube en supprimant le paramètre onBehalfOfContentOwner, soit agir en tant que chaîne du partenaire en fournissant le paramètre onBehalfOfContentOwnerChannel s'il est disponible pour la méthode appelée.

8 août 2013

Cette mise à jour inclut les changements suivants :

30 juillet 2013

Cette mise à jour inclut les changements suivants :

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

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

  • Vous pouvez désormais indiquer si un abonnement s'applique à l'ensemble des activités d'une chaîne ou uniquement aux nouvelles mises en ligne. La nouvelle propriété contentDetails.activityType de la ressource subscription identifie les types d'activités pour lesquels l'abonné sera averti. Les valeurs de propriété valides sont all et uploads.

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

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

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

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

  • L'objet contentDetails.contentRating de la ressource video spécifie les classifications qu'une vidéo a reçues en fonction de différents systèmes de classification, y compris les classifications MPAA, TVPG, etc. Pour chaque système de classification, l'API accepte désormais une valeur indiquant que la vidéo n'a pas été évaluée. Remarque : Dans les classifications MPAA, la mention "non évalué" est fréquemment utilisée pour identifier les versions non montées des films pour lesquelles la version coupée du film a reçu une classification officielle.

  • La nouvelle propriété contentDetails.contentRating.ytRating de la ressource video identifie le contenu soumis à une limite d'âge. La valeur de la propriété est ytAgeRestricted si YouTube a identifié le contenu de la vidéo comme inapproprié pour les utilisateurs de moins de 18 ans. Si la propriété est absente ou si sa valeur est vide, cela signifie que le contenu n'a pas été 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 acceptent désormais le paramètre onBehalfOfContentOwner. Ce paramètre indique que l'utilisateur authentifié agit pour le compte du propriétaire de contenu spécifié dans la valeur du paramètre.

  • La documentation de la méthode channels.update a été mise à jour pour tenir compte du fait qu'elle peut être utilisée pour mettre à jour l'objet brandingSettings de la ressource channel et ses propriétés enfants. La documentation présente également la liste mise à jour des propriétés que vous pouvez définir pour l'objet invideoPromotion de la ressource channel.

  • error documentation décrit les nouvelles erreurs suivantes:

    Type d'erreur Détails de l'erreur Description
    forbidden accountDelegationForbidden Cette erreur n'est pas spécifique à une méthode API particulière. Elle indique que l'utilisateur authentifié n'est pas autorisé à agir au nom du compte Google spécifié.
    forbidden authenticatedUserAccountClosed Cette erreur n'est pas spécifique à une méthode API particulière. 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 peut pas identifier le canal associé à la requête API. Si la requête est autorisée et utilise le paramètre onBehalfOfContentOwner, vous devez également définir le paramètre onBehalfOfContentOwnerChannel.
    forbidden cmsUserAccountNotFound Cette erreur n'est pas spécifique à une méthode API particulière. L'utilisateur du CMS n'est pas autorisé à agir au nom du propriétaire de contenu spécifié.
    notFound contentOwnerAccountNotFound Cette erreur n'est pas spécifique à une méthode API particulière. Impossible de trouver le compte de propriétaire de contenu spécifié.
    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 non disponible.
    notFound videoNotFound La méthode videos.update renvoie cette erreur pour indiquer que la vidéo que vous essayez de mettre à jour est introuvable. Vérifiez que la valeur de la propriété id est correcte dans le corps de la requête.

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 prend désormais en charge 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é.

  • 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éraient des données concernant 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 pris en charge pour les méthodes videos.insert, videos.update et videos.delete. Notez que lorsque ce paramètre est utilisé dans un appel de 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.

    Le paramètre indique que les identifiants d'autorisation de la demande identifient un utilisateur du CMS YouTube agissant pour le compte du propriétaire de contenu spécifié dans la valeur du paramètre. Le compte CMS avec lequel l'utilisateur s'authentifie doit être associé au propriétaire de contenu YouTube spécifié.

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

    Concernant cette version, 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 dont il est le propriétaire.

  • error documentation décrit les nouvelles erreurs suivantes:

    Type d'erreur Détails de l'erreur Description
    forbidden insufficientCapabilities Cette erreur n'est pas spécifique à une méthode API particulière. Elle indique que l'utilisateur du CMS qui appelle l'API ne dispose pas des autorisations nécessaires pour effectuer l'opération demandée. Cette erreur est associée à l'utilisation du paramètre onBehalfOfContentOwner, qui est compatible avec plusieurs méthodes d'API.
    unauthorized authorizationRequired La méthode activities.list renvoie cette erreur lorsque la requête utilise le paramètre home, mais n'est pas correctement autorisée.
  • Dans la ressource channels, la propriété invideoPromotion.channelId a été supprimée, car l'ID du canal est déjà spécifié à l'aide de la propriété id de la ressource.

  • Le nouveau guide Utiliser des ID de canal explique comment l'API utilise les ID de canal. Il peut être particulièrement utile pour les 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 estiment que chaque chaîne YouTube possède un nom d'utilisateur unique, ce qui n'est plus le cas.

22 mai 2013

Cette mise à jour inclut les changements suivants :

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 répertorie les exemples de code Python inclut désormais des exemples permettant d'ajouter un abonnement, de créer une playlist et de mettre à jour 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 canal acceptent désormais l'objet inVideoPromotion, qui encapsule les informations sur une campagne promotionnelle associée à la chaîne. Une chaîne peut utiliser une campagne promotionnelle dans les vidéos pour afficher la miniature d'une vidéo sponsorisée dans le lecteur vidéo lors de la lecture des vidéos de la chaîne.

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

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

2 mai 2013

Cette mise à jour inclut les changements suivants :

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

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

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

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

    Les paramètres myRating et id sont désormais tous deux considérés comme des paramètres de filtre, ce qui signifie qu'une requête API doit spécifier un seul 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 les informations de classification des vidéos, mais qui ne sont pas autorisées à le faire.

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

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

    • 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 détails tels que le nombre total de résultats et le nombre de résultats inclus dans l'ensemble de résultats actuel. La ressource youtube#videoListResponse peut également inclure les propriétés nextPageToken et prevPageToken, chacune d'elles fournissant un jeton pouvant être utilisé pour récupérer une page spécifique dans l'ensemble de résultats.

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

    • autoLevels : définissez cette valeur de paramètre sur true pour indiquer à YouTube d'améliorer automatiquement l'éclairage et la couleur de la vidéo.
    • stabilize : définissez cette valeur de paramètre sur true pour indiquer à YouTube d'ajuster la vidéo en supprimant les tremblements liés aux mouvements de la caméra.

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

    • playlistItem : la propriété spécifie le nom de la chaîne sur laquelle l'élément a été ajouté à la playlist.
    • playlist : la propriété spécifie le nom de la chaîne sur laquelle la playlist a été créée.
    • subscription : la propriété spécifie le nom de la chaîne à laquelle 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 demande 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 les propriétés suivantes:

  • Les requêtes API contenant un paramètre inattendu renvoient désormais une erreur badRequest. Le motif signalé 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 en tant qu'erreur forbidden. Son motif est playlistContainsMaximumNumberOfVideos.

19 avril 2013

Cette mise à jour inclut les changements suivants :

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

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

  • Dans la documentation de l'API, les images miniatures sont désormais identifiées comme une ressource distincte. La nouvelle méthode thumbnails.set vous permet d'importer une miniature de 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 répertorier les erreurs que l'API peut renvoyer en réponse à un appel de méthode thumbnails.set.

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

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

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

    • Le nouvel objet status encapsule les informations d'état sur 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 tenir compte du fait que la propriété snippet.resourceId doit être spécifiée dans la ressource envoyée en tant que corps de la requête.

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

    • Le nouveau paramètre forMine limite une recherche afin de ne récupérer que les vidéos de l'utilisateur authentifié.

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

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

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

    Type d'erreur Détails de l'erreur Description
    badRequest invalidCategoryId La propriété snippet.categoryId spécifie un ID de catégorie non valide. Utilisez la méthode videoCategories.list pour récupérer les catégories acceptées.
    badRequest invalidRecordingDetails metadata specifies invalid recording details.
    badRequest invalidVideoGameRating Les métadonnées de la requête spécifient une classification de jeu vidéo non valide.
    badRequest invalidVideoMetadata Les métadonnées de la requête ne sont pas valides.
  • Le paramètre onBehalfOfContentOwner a été supprimé de la liste des paramètres acceptés pour les méthodes videos.update et videos.delete.

12 mars 2013

Cette mise à jour inclut les changements suivants :

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

    • activity : la propriété spécifie le nom du canal responsable de l'activité.
    • search : la propriété spécifie le nom du canal associé à la ressource identifiée par le résultat de recherche.
    • video : la propriété spécifie le nom de la chaîne sur laquelle la vidéo a été mise en ligne.

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

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

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

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

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

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

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

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

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

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

    • Le paramètre forContentOwner, compatible avec la méthode search.list, indique à l'API de limiter les résultats de recherche pour qu'ils n'incluent que les ressources appartenant au propriétaire de contenu spécifié par le paramètre onBehalfOfContentOwner.

25 février 2013

Cette mise à jour inclut les changements suivants :

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

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

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

      Seul le propriétaire de la vidéo peut récupérer ces parties. 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 de chaque partie.

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

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

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

      • L'objet suggestions contient des suggestions qui identifient des possibilités d'amélioration de la qualité ou des 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 à l'aide de requêtes non authentifiées.

      • dimension : indique si la vidéo est disponible en 2D ou en 3D.
      • definition : indique si la vidéo est disponible en définition standard ou haute définition.
      • caption : indique si des sous-titres sont disponibles pour la vidéo.
      • licensedContent : indique si la vidéo comporte 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 lors de l'insertion ou de la mise à jour d'une vidéo. Ces propriétés peuvent également être récupérées à l'aide de requêtes non authentifiées.

      • embeddable : indique si la vidéo peut être intégrée sur un autre site Web.
      • license : 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 répertorier les nouvelles parties 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 peut être utilisée pour générer un lien vers le profil Google+.

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

  • playlistItems.list accepte désormais le paramètre videoId, que vous pouvez utiliser avec le paramètre playlistId pour ne récupérer que l'élément de la playlist qui représente la vidéo spécifiée.

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

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

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

30 janvier 2013

Cette mise à jour inclut les changements suivants :

  • La nouvelle page error répertorie les erreurs que l'API peut renvoyer. Cette 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 aux méthodes.

16 janvier 2013

Cette mise à jour inclut les changements suivants :

  • Des exemples de code sont désormais disponibles pour les méthodes et les langages répertoriés ci-dessous:

  • Une ressource activity peut désormais signaler une action channelItem, qui se produit lorsque YouTube ajoute une vidéo à une chaîne YouTube générée automatiquement. YouTube utilise un algorithme qui identifie les sujets qui bénéficient d'une forte présence sur le site Web YouTube et génère automatiquement des chaînes pour ces sujets.

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

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

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

    Nom du paramètre Valeur Description
    channelId string Affiche les ressources créées par le canal spécifié.
    publishedAfter datetime Affiche les ressources créées après l'heure spécifiée.
    publishedBefore datetime Affiche les ressources créées avant l'heure spécifiée.
    regionCode string Affiche les ressources pour le pays spécifié.
    videoCategoryId string Filtrez les résultats de recherche de vidéos pour n'inclure que les vidéos associées à la catégorie de vidéo spécifiée.
    videoEmbeddable string Filtrez les résultats de recherche de vidéos pour n'inclure que les vidéos pouvant être lues dans un lecteur intégré sur une page Web. Définissez la valeur du paramètre sur true pour ne récupérer que les vidéos intégrables.
    videoSyndicated string Filtrez les résultats de recherche de vidéos pour n'inclure que les vidéos qui peuvent ê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 d'API prennent en charge de nouvelles propriétés. Le tableau ci-dessous identifie les ressources et leurs nouvelles propriétés:

    Ressource Nom de propriété Valeur Description
    activity contentDetails.playlistItem.playlistItemId string ID de l'élément de la playlist attribué par YouTube pour l'identifier de façon unique.
    activity contentDetails.channelItem object Objet contenant des informations sur une ressource ajoutée à un canal. Cette propriété n'est présente que si snippet.type est défini sur channelItem.
    activity contentDetails.channelItem.resourceId object Objet qui identifie la ressource qui a été ajoutée au canal. Comme les autres propriétés resourceId, elle contient une propriété kind qui spécifie le type de ressource (vidéo ou playlist, par exemple). Il contient également exactement l'une des propriétés (videoId, playlistId, etc.) qui spécifie l'identifiant permettant d'identifier la ressource de manière unique.
    channel status object Cet objet encapsule les informations sur l'état de confidentialité du canal.
    channel status.privacyStatus string État de confidentialité de la chaîne. Les valeurs valides sont private et public.
    playlist contentDetails object Cet objet contient des métadonnées sur le contenu de la playlist.
    playlist contentDetails.itemCount unsigned integer Nombre de vidéos dans la playlist.
    playlist player object Cet objet contient les informations dont vous avez besoin pour lire la playlist dans un lecteur intégré.
    playlist player.embedHtml string Une balise <iframe> qui intègre un lecteur vidéo qui lit la playlist.
    video recordingDetails object Cet objet encapsule les informations qui identifient ou décrivent le lieu et l'heure où 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 Texte descriptif du lieu où la vidéo a été enregistrée.
    video recordingDetails.recordingDate datetime Date et heure d'enregistrement de la vidéo. La valeur est spécifiée au format ISO 8601 (YYYY-MM-DDThh:mm:ss.sZ).
  • La documentation de plusieurs méthodes d'API identifie désormais les propriétés qui doivent être spécifiées dans le corps de la requête ou celles qui sont mises à jour en fonction des valeurs qu'il contient. Le tableau ci-dessous liste ces méthodes, ainsi que les propriétés obligatoires ou modifiables.

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

    Méthode Propriétés
    activities.insert Propriétés obligatoires:
    • snippet.description
    Propriétés modifiables:
    • snippet.description
    • contentDetails.bulletin.resourceId
    playlists.update Propriétés obligatoires:
    • id
    playlistItems.update Propriétés obligatoires:
    • id
    videos.update Propriétés obligatoires:
    • id
  • L'API ne signale plus une erreur playlistAlreadyExists si vous essayez de créer ou de mettre à jour une playlist dont le titre est identique à celui d'une playlist existante sur la même chaîne.

  • Plusieurs méthodes d'API prennent en charge de nouveaux types d'erreurs. Le tableau ci-dessous identifie la méthode et les nouvelles erreurs prises en charge:

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