Historique des révisions

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

30 avril 2024

Remarque:Le présent message est une annonce d'abandon.

Cette mise à jour inclut les changements suivants :

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

13 mars 2024

Remarque:Le présent message est une annonce d'abandon.

Cette mise à jour inclut les changements suivants :

Le paramètre sync de captions.insert et captions.update méthodes est obsolète. YouTube n'acceptera plus les au 12 avril 2024.

En conséquence de ce changement, les développeurs doivent inclure des informations temporelles lorsqu'ils insèrent ou la mise à jour des pistes de sous-titres, sinon l'importation échouera.

12 mars 2024

Cette mise à jour inclut les changements suivants :

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

7 mars 2024

Remarque:Le présent message est une annonce d'abandon.

Propriété de la ressource channel Abandon de brandingSettings.channel.moderateComments. YouTube va s'arrêter compatible avec ce paramètre à compter du 7 mars 2024.

31 janvier 2024

Cette mise à jour inclut les changements suivants :

Le nouveau 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és, car la ressource videoId n'est pas renvoyée via un appel d'API.

12 septembre 2023

Remarque:Le présent message est une annonce d'abandon.

La méthode comments.markAsSpam est obsolète depuis plusieurs années. Cette méthode n'est déjà pas compatible avec YouTube et n'est pas via l'API.

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

22 août 2023

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

18 août 2023

La définition de la ressource video liveStreamingDetails.concurrentViewers a été mis à jour pour indiquer que le nombre de spectateurs simultanés renvoyés par l'API YouTube Data peut diffère du nombre de spectateurs simultanés traités et supprimé contre les spams, disponible sur YouTube Analytics. La Centre d'aide YouTube fournit plus d'informations sur les métriques des diffusions en direct.

7 août 2023

Comme annoncé le 12 juin 2023, les Méthode search.list Le paramètre relatedToVideoId est obsolète. Ce paramètre n'est plus et les références au paramètre ont été supprimées de la documentation de l'API.

28 juin 2023

La méthode thumbnails.set est désormais compatible avec le uploadRateLimitExceeded, ce qui indique que la chaîne a mis en ligne trop de vidéos miniatures au cours des dernières 24 heures. Veuillez réessayer plus tard.

12 juin 2023

Remarque:Le présent message est une annonce d'abandon.

La méthode search.list Le paramètre relatedToVideoId est obsolète. YouTube n'acceptera plus les au 7 août 2023.

À l'heure actuelle, une notification d'abandon a été ajoutée à la méthode search.list dans la documentation Google Cloud. Ce paramètre sera complètement supprimé de la documentation search.list à compter du 7 août 2023.

Par ailleurs, nous vous avons présenté un exemple montrant comment récupérer des vidéos similaires. supprimé du guide d'implémentation de l'API.

22 août 2022

Correction des annotations de type pour video.statistics en chaîne à partir d'une longueur non signée.

5 août 2022

Dans le cadre de cette modification, YouTube a modifié la façon dont les ID de sous-titres sont générés. attribuer de nouveaux ID de sous-titres à toutes les pistes de sous-titres ; Cette modification peut entraîner une incompatibilité ascendante pour les applications qui stockent caption_id, mais pas affecter les applications qui ne stockent pas Valeurs caption_id.

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

Pour vous préparer à ce changement, vous devez prévoir de remplacer complètement toutes les données des pistes de sous-titres stockées. entre aujourd'hui et le 1er décembre 2022. Cela signifie que, pour toute vidéo pour laquelle vous stockez une piste de sous-titres, vous devez supprimer les données actuellement stockées, puis appeler la méthode captions.list pour récupérer ensemble actuel de pistes de sous-titres pour la vidéo et stockez 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. Veuillez consultez les Conditions d'utilisation des services d'API YouTube – Révision pour en savoir plus.

27 avril 2022

La description de la méthode videos.insert a été mise à jour pour indiquer que la taille de fichier maximale autorisée pour les vidéos mises en ligne est passée de 128 Go à 256 Go.

8 avril 2022

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

15 décembre 2021

Comme annoncé le 18 novembre 2021, en plus des modifications pour indiquer que vous n'aimez pas la vidéo en privé sur l'ensemble de la plate-forme YouTube, la ressource video statistics.dislikeCount est désormais privée.

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

18 novembre 2021

En parallèle des changements apportés au rendre privé le nombre de "Je n'aime pas" sur une vidéo sur l'ensemble de la plate-forme YouTube, la ressource video statistics.dislikeCount est rendue privée à partir du 13 décembre 2021. Autrement dit, la propriété être inclus dans une réponse d'API à partir du point de terminaison videos.list si la requête API était authentifiés par le propriétaire de la vidéo.

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

Développeurs qui n'affichent pas publiquement le nombre de "Je n'aime pas" et ont besoin de connaître le nombre de "Je n'aime pas" Le client API peut demander à être ajouté à une liste d'autorisation pour bénéficier d'une exception. Pour demander une exonération, vous devez doit effectuer cette formulaire de demande.

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

2 juillet 2021

Remarque:Le présent message est une annonce d'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 comments.update

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

1er juillet 2021

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

Chaque nouveau formulaire nous indiquera comment vous prévoyez d'utiliser l'API de YouTube et nous permettra de mieux vous aider.

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

12 mai 2021

Remarque:Le présent message est une annonce d'abandon.

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

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

    Avant cette mise à jour, l'API créait quand même une playlist si un client API essayait de ajouter une vidéo à une playlist de favoris qui n'existe pas. À l'avenir, la playlist ne sera plus créé dans ce cas, et l'API renverra une erreur. 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 peut commencer à renvoyer des erreurs à tout moment.

  • La ressource channel suivante sont obsolètes. Ces propriétés ne sont déjà pas compatibles avec l'interface utilisateur de YouTube Studio et sur YouTube. Par conséquent, elles ne sont plus compatibles avec l'API.

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

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

  • La ressource channelSection suivante sont obsolètes. Ces propriétés ne sont déjà pas compatibles avec l'interface utilisateur de YouTube Studio et sur YouTube. Par conséquent, elles ne sont plus compatibles avec l'API.

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

    Parallèlement à cette modification, la méthode channelSection.list Le paramètre hl a également sont obsolètes, car les fonctionnalités qu'il prend en charge ne sont pas prises en charge.

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

  • Pour l'attribut de la ressource channelSection snippet.type, les valeurs suivantes sont obsolètes. Ces valeurs ne sont déjà pas acceptées sur YouTube pages de chaînes et, par conséquent, elles ne sont plus prises en charge par l'API.

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

  • La ressource playlist La propriété snippet.tags[] est obsolète. Cette propriété n'est déjà pas prise en charge sur YouTube. Par conséquent, elle n'est plus prise en charge 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 :

  • playlistItems.delete playlistItems.insert, playlistItems.list, playlistItems.update, playlists.delete, playlists.list et Méthodes playlists.update compatibles avec toutes une nouvelle erreur playlistOperationUnsupported. L'erreur se produit lorsqu'une requête tente de effectuer une opération qui n'est pas autorisée pour une playlist donnée. Par exemple, un utilisateur ne peut pas supprimer une vidéo de sa playlist de vidéos mises en ligne ou supprimer la playlist elle-même.

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

  • La méthode playlistItems.list watchHistoryNotAccessible et watchLaterNotAccessible erreurs présentent supprimé de la documentation. Bien que les données l'historique des vidéos regardées et les listes "À regarder plus tard" inaccessibles via l'API, ces erreurs spécifiques ne sont pas renvoyées par l'API.

15 octobre 2020

Deux nouvelles sections ont été ajoutées à la page Règles :

  • La nouvelle Section III.E.4.i fournit des informations supplémentaires sur les données collectées et envoyées via le lecteur intégré YouTube. Toi est responsable des données utilisateur que vous nous envoyez via un lecteur intégré YouTube avant la L'utilisateur a 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 s'applique s'assurer qu'un contenu est conçu pour les enfants avant de l'intégrer à vos sites applications. Il est de votre responsabilité de savoir quand les vidéos que vous intégrez à vos clients API sont créées pour les enfants et de traiter en conséquence les données collectées dans le lecteur intégré. À ce titre, vous devez Vérifier l'état des contenus à l'aide de l'API YouTube Data avant de les intégrer à votre API Client via un lecteur intégré YouTube.

Nouvelle section Trouver l'état MadeForKids d'une vidéo explique comment déterminer si une vidéo est conçue pour les enfants à l'aide du Service de l'API YouTube Data.

Parallèlement à ces changements, un rappel a été ajouté à la section Documentation sur les paramètres du lecteur intégré Si vous activez la lecture automatique, la lecture se fait sans interaction de l'utilisateur avec le lecteur. lecture la collecte et le partage des données ont donc lieu au chargement de la page.

8 octobre 2020

Cette mise à jour concerne trois petits changements Ressource channel:

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

9 septembre 2020

Remarque:Le présent message est une annonce d'abandon.

Cette mise à jour concerne les modifications suivantes de l'API. Toutes les modifications prendront effet le ou après le 9 septembre 2020, date de cette annonce. C'est pourquoi les développeurs ne doivent plus à l'aide de l'une des fonctionnalités d'API listées ci-dessous.

  • Les ressources, méthodes, paramètres et propriétés de ressources de l'API suivants sont obsolètes immédiatement et cesseront de fonctionner à compter de la date de cette annonce: <ph type="x-smartling-placeholder">
      </ph>
    • La ressource channel suivante propriétés: <ph type="x-smartling-placeholder">
        </ph>
      • 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
    • La méthode channels.list Paramètre de filtre categoryId
    • La ressource guideCategories et l'guideCategories.list méthode
  • Réponses de l'API Numéro de méthode channels.list ne contiennent plus prevPageToken si la requête API définit Paramètre managedByMe à true. Cette modification n'affecte pas la propriété prevPageToken pour les autres requêtes channels.list, et n'affecte pas nextPageToken pour toutes les requêtes.
  • Le nom (contentDetails.relatedPlaylists.watchLater) de la ressource channel et contentDetails.relatedPlaylists.watchHistory propriétés ont toutes les deux été annoncées. comme obsolète le 11 août 2016. La Compatibilité des méthodes playlistItems.insert et playlistItems.delete pour ces playlists sont désormais complètement obsolètes, et les deux propriétés ont été supprimées de la documentation.
  • Le paramètre mySubscribers de la méthode channels.list, qui était annoncé comme obsolète le 30 juillet 2013, a été supprimés de la documentation. Utilisez les 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 tous ses enfants qui ont été annoncées comme obsolètes le 27 novembre 2017, ont été supprimés de la documentation.

29 juillet 2020

Nous avons simplifié notre processus de facturation des quotas pour les requêtes API en supprimant les options supplémentaires Coût associé au paramètre part Avec effet immédiat, nous ne facturerons le coût de base de la méthode appelée. Pour en savoir plus sur la version simplifiée ici.

Avec ce changement, la plupart des appels d'API auront un coût de quota légèrement inférieur, tandis que le même coût sera toujours appliqué à certains appels d'API. Ce changement n'augmente pas le coût des API appels. Globalement, cela aura un impact sur le quota qui vous est alloué, comme vous pouvez le voir dans la la console Google Cloud, iront un peu plus loin.

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

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

28 juillet 2020

Toutes les vidéos mises en ligne via videos.insert des projets d'API non validés créés après le 28 juillet 2020 sera limité au mode d'affichage privé. Pour lever cette restriction, chaque projet faire l'objet d'un audit pour vérifier le respect des Conditions d'utilisation.

Les créateurs qui mettent en ligne leurs vidéos à l'aide d'un client API non validé recevront un e-mail leur expliquant sa vidéo est verrouillée en mode privé et qu'il peut éviter la restriction en faisant appel à un ou audité.

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

21 juillet 2020

[Mise à jour du 28 juillet 2020.] La mise à jour de la documentation référencée dans cette révision entrée d'historique a été à nouveau publiée le 28 juillet 2020.

Hier, nous avons publié une mise à jour de la documentation concernant notre processus de facturation des quotas. Cependant, en raison de circonstances imprévues, cette modification de quota n'a pas encore été appliquée. Par conséquent, a été rétablie pour des raisons d'exactitude. Pour éviter toute confusion, la révision une entrée d'historique expliquant la modification a été supprimée et sera de nouveau publiée dans un avenir proche.

7 juillet 2020

Remarque:Le présent message est une annonce d'abandon.

La méthode videos.insert Abandon des paramètres autoLevels et stabilize, ont été supprimés de la documentation. Leurs valeurs sont ignorées et n'affectent pas le mode de traitement des nouvelles vidéos mises en ligne.

15 juin 2020

La nouvelle fonctionnalité Respecter les règles du programme pour les développeurs YouTube de Google fournit des conseils et des exemples pour vous aider à vous assurer que vos clients API respectent à des parties spécifiques des services d'API YouTube ; Conditions d'utilisation et Règles (conditions d'utilisation des API).

Ces conseils expliquent comment YouTube applique certains aspects des conditions d'utilisation des API, ne remplacer aucun document existant. Ce guide répond à certaines des questions les plus fréquentes que les développeurs posent lors des audits de conformité des API. Nous espérons que cela vous aidera à développer en vous aidant à comprendre comment nous interprétons et appliquons nos règles.

4 juin 2020

Remarque:Ceci est une mise à jour d'une annonce d'abandon précédente.

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

17 avril 2020

Remarque:Le présent message est une annonce d'abandon.

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

31 mars 2020

Cette mise à jour inclut les changements suivants :

  • Nouvelles ressources et méthodes

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

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

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

10 janvier 2020

L'API permet désormais d'identifier les contenus destinés aux enfants, ce que YouTube appelle "conçu pour les enfants". En savoir plus sur "conçu pour les enfants" de vidéos dans le centre d'aide YouTube.

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

  • La propriété selfDeclaredMadeForKids permet aux créateurs de contenu de spécifier si un channel ou 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. Concernant les vidéos, cette propriété peut être définie lors de l'appel videos.insert ou videos.update.

    Notez que cette propriété n'est incluse que dans les réponses de l'API contenant channel ou video ressources si le propriétaire du canal a autorisé la requête API.
  • La propriété madeForKids permet à n'importe quel utilisateur de récupérer un contenu conçu pour les enfants. état d'une chaîne ou vidéo. Par exemple, l'état peut être déterminé en fonction de la valeur de la propriété selfDeclaredMadeForKids. Consultez le Centre d'aide YouTube. des informations sur la définition de 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. Veuillez consultez les Conditions d'utilisation des services d'API YouTube – Révision pour en savoir plus. Les modifications apportées aux conditions d'utilisation des services d'API YouTube et Le règlement pour les développeurs entrera en vigueur le 10 janvier 2020 (heure du Pacifique).

10 septembre 2019

La documentation de référence de l'API a été mise à jour pour refléter le changement de la façon dont les abonnés sont indiqués sur YouTube et, par conséquent, dans les réponses de l'API. Grâce à ce changement, le nombre d'abonnés renvoyé par l'API YouTube Data est arrondi à la valeur inférieure pour les abonnés ayant plus de 1 000 abonnés. Cette modification affecte channel ressource statistics.subscriberCount .

Remarque:Ce changement affecte la valeur de cette propriété même dans les cas où un utilisateur envoie une demande autorisée de données sur son propre canal. Les propriétaires de la chaîne peuvent toujours consulter le nombre 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 les 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 afin de mieux expliquer les cas d'utilisation courants de chaque méthode et de fournir des exemples de code dynamiques et de haute qualité via le widget APIs Explorer. Consultez la documentation de la méthode channels.list pour obtenir un exemple. Deux nouveaux éléments décrivent désormais les méthodes API sur les pages:

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

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

      Vous pouvez utiliser les liens de cette section pour renseigner APIs Explorer avec des exemples de valeurs pour votre cas d'utilisation ou pour ouvrir l'explorateur d'API en plein écran avec ces valeurs déjà renseignées. Ces modifications ont pour but de 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 d'exemples de code a également été mis à jour avec une nouvelle interface utilisateur offrant les mêmes fonctionnalités que celles décrites ci-dessus. Cet outil vous permet d'explorer les cas d'utilisation de différentes méthodes, de charger des valeurs dans 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, nous avons supprimé les pages qui renvoyaient auparavant des exemples de code disponibles pour Java, JavaScript, PHP et Python.

  • Les guides de démarrage rapide pour Java, JavaScript, PHP et Python ont été mis à jour. Les guides révisés expliquent comment exécuter un exemple avec une clé API et un autre avec un ID client OAuth 2.0 à l'aide d'exemples de code 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 de miniatures de chaînes ne seront disponibles que dans le domaine https, qui correspond au format utilisé dans les réponses de l'API. Passé ce délai, des images corrompues peuvent s'afficher dans votre application si celle-ci tente de charger des images YouTube à partir du domaine http.

  • Remarque:Le présent message est une annonce d'abandon.

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

22 juin 2018

Le guide d'implémentation, auparavant appelé le guide d'implémentation et de migration a été mis à jour pour supprimer les instructions de migration du de l'API v2 à l'API v3. En outre, les instructions ont également été supprimées pour les fonctionnalités depuis la version 3 de l'API, comme vos vidéos préférées.

27 novembre 2017

Cette mise à jour inclut les changements suivants :

  • Remarque:Le présent message est une annonce d'abandon.

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

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

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

    Depuis le 27 mai 2018, il est possible que ces requêtes renvoient des messages d'erreur indiquant, par exemple, que invalidPromotion n'est pas une pièce valide.

16 novembre 2017

Cette mise à jour inclut les changements suivants :

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

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

    • La fonction removeEmptyParameters prend une liste de paires clé-valeur correspondant aux paramètres de requête 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 en local. 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'extrait de code.

25 octobre 2017

Cette mise à jour inclut les changements suivants :

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

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

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

    Tous ces exemples sont conçus pour être téléchargés et exécutés en local. Si vous souhaitez exécuter ces exemples, consultez les instructions de l'outil d'extrait de code pour savoir comment 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 indiquer que si ce paramètre est défini sur true, le paramètre type doit être défini sur video.
  • Nous avons modifié la définition du paramètre regionCode de la méthode search.list afin de préciser qu'il limite les résultats de recherche aux vidéos pouvant être regardées dans la région spécifiée.
  • YouTube a mis à jour les logos et les icônes de marque. Nouveau : "Développé avec YouTube" logos peuvent être téléchargés sur la page Consignes relatives à la marque. D'autres nouveaux logos et icônes YouTube y figurent également. Vous pouvez les télécharger sur le site de la marque YouTube.

24 juillet 2017

Cette mise à jour inclut les changements suivants :

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

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

1er juin 2017

Cette mise à jour inclut les changements suivants :

17 mai 2017

Cette mise à jour inclut les changements suivants :

  • La documentation de référence de l'API a été mise à jour afin de rendre les extraits de code plus omniprésents et interactifs. Les pages qui expliquent les méthodes d'API, comme channels.list ou videos.rate, proposent 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 donnée, l'outil affiche des extraits de code pour un ou plusieurs cas d'utilisation, chacun décrivant une méthode courante pour appeler cette méthode. Par exemple, vous pouvez appeler la méthode channels.list pour récupérer des données sur une chaîne spécifique ou sur la chaîne de l'utilisateur actuel.

    Vous pouvez également interagir avec des exemples de code:

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

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

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

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

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

    • Prise en charge des requêtes API qui écrivent des données.
    • Compatibilité avec les exemples Java.
    • Code 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 sujet renvoyés dans la propriété topicDetails.topicIds[] de la ressource.
  • La nouvelle propriété contentDetails.videoPublishedAt de la ressource playlistItem identifie l'heure à laquelle la vidéo a été publiée sur YouTube. La ressource contient déjà la propriété snippet.publishedAt, qui identifie l'heure à laquelle l'élément a été ajouté à la playlist.
  • Comme la ressource channel, la ressource video renvoie désormais la propriété topicDetails.topicCategories[], qui contient une liste d'URL Wikipédia décrivant le contenu de la vidéo. Pour les ressources video, les URL correspondent aux ID de sujet renvoyés dans la propriété topicDetails.relevantTopicIds[] de la ressource.
  • La nouvelle propriété contentDetails.contentRating.mpaatRating de la ressource video identifie la classification que la Motion Picture Association of America a attribuée à une bande-annonce ou à un extrait de film.

27 février 2017

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

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

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

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

29 novembre 2016

Cette mise à jour inclut les changements suivants :

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

    • La catégorie Professional wrestling, qui était auparavant un enfant de la catégorie Sports, est désormais un enfant de Entertainment.
    • La catégorie TV shows, qui est un enfant de Entertainment, est nouvelle.
    • La catégorie Health, qui était auparavant 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, par exemple Tennis, sera également associée à la catégorie parente (Sports).

10 novembre 2016

Cette mise à jour inclut les changements suivants :

  • Comme annoncé le 11 août 2016, l'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 traitant d'un sujet particulier.

    À compter du 10 février 2017, YouTube affichera un petit ensemble d'ID de thèmes au lieu de l'ensemble beaucoup plus précis d'ID déjà renvoyé. Notez également qu'il n'est pas garanti que les chaînes et les vidéos soient associées à des thèmes, ce qui est conforme au comportement actuel de l'API.

    Pour que vous puissiez préparer vos clients API à ces modifications, les définitions des propriétés et paramètres d'API suivants ont été mises à jour afin de répertorier les ID de sujet 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:Le présent message est une annonce d'abandon.

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

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

  • Freebase étant obsolète, le guide Searching with Freebase Topics (Rechercher avec les sujets Freebase) a donc été supprimé de la documentation. Ce guide fournissait des exemples de code montrant le fonctionnement d'une application avec l'API Freebase.

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

2 novembre 2016

Cette mise à jour inclut les changements suivants :

  • Nouveaux paramètres et propriétés

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

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

      • La nouvelle propriété hasCustomThumbnail indique si l'utilisateur qui a mis en ligne la vidéo a fourni une miniature personnalisée pour la vidéo. Notez que seul l'utilisateur ayant mis en ligne la vidéo peut voir cette propriété.

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

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

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

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

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

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

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

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

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

      En outre, la propriété targeting de la ressource channelSection a été mise à jour pour refléter le fait que les options de ciblage ne peuvent être définies qu'à l'aide de l'API. Les options de ciblage sont supprimées si vous modifiez la section de la chaîne dans l'interface utilisateur du site Web YouTube.

    • La définition de la propriété snippet.name de la ressource i18nLanguage a été corrigée afin de 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 sont obsolètes. Ces champs sont ignorés s'ils sont définis dans les requêtes playlistItems.insert ou playlistItems.update.

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

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

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

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

  • Erreurs nouvelles et mises à jour

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

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

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

  • Autres actualités

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

15 septembre 2016

Cette mise à jour inclut les changements suivants :

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

  • Les modifications suivantes ont été appliquées. Ces modifications ont été prises en compte dans la mise à jour de l'historique des révisions du 11 août 2016:

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

      Cette modification mineure vise à 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.

      En clair, 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 la chaîne de l'utilisateur. Par conséquent, les ID de l'historique des vidéos regardées et de la playlist "À regarder plus tard" ne peuvent pas être récupérés via l'API.

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

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

11 août 2016

Cette mise à jour inclut les changements suivants :

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

    L'ensemble des nouveaux documents est décrit dans l'historique des révisions des nouvelles conditions d'utilisation. De plus, les modifications futures apportées aux Conditions mises à jour ou aux documents connexes seront également expliquées dans cet historique des révisions. Vous pouvez vous abonner à un flux RSS listant les modifications apportées dans l'historique des révisions à partir d'un lien figurant 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 méthodes et ressources 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 liées à un thème particulier.

    Les modifications apportées à ces fonctionnalités sont les suivantes:

    • À compter du 10 février 2017, YouTube affichera un petit ensemble d'ID de thèmes au lieu de l'ensemble beaucoup plus précis d'ID renvoyés jusqu'à présent. Cet ensemble de thèmes compatibles permet d'identifier des catégories générales, telles que Sports ou Basket-ball, mais pas d'équipes ni de joueurs spécifiques, par exemple. Nous vous communiquerons la liste des sujets pris en charge afin que vous ayez le temps de préparer votre demande d'inscription à ce changement.

    • Tout ID de sujet Freebase que vous avez déjà récupéré peut être utilisé pour rechercher du contenu jusqu'au 10 février 2017. Cependant, après ce délai, vous ne pourrez récupérer les résultats de recherche par thème qu'à l'aide du plus petit ensemble de thèmes identifié dans l'élément précédent.

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

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

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

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

      À partir du 12 septembre 2016, les demandes de récupération des informations (playlists.list) de l'historique des vidéos regardées d'une chaîne ou de la playlist "À regarder plus tard" seront renvoyées à une liste vide. Les demandes de récupération d'éléments (playlistItems.list) dans l'une de ces playlists renvoient également une liste vide après ce délai. Cela s'applique aux nouvelles valeurs HL et WL, ainsi qu'aux ID de l'historique des vidéos regardées ou de la playlist "À regarder plus tard" que votre client API a peut-être déjà stockés.

    • L'objet fileDetails.recordingLocation de la ressource video ou l'une de ses propriétés enfants ne seront plus renvoyés après le 12 septembre 2016. Ces données ne peuvent être récupérées que par le propriétaire d'une vidéo, car l'objet fileDetails parent ne peut être récupéré que par le propriétaire 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+. Après l'abandon, la propriété ne sera plus incluse dans les ressources channel.

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

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

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 derniers abonnés de la chaîne de l'utilisateur authentifié. Pour récupérer la liste complète des abonnés, utilisez le paramètre mySubscribers. Ce paramètre, qui ne renvoie pas d'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é modifiée pour les ressources activity, playlistItem, playlist, résultats de recherche, miniature et vidéo afin de noter que des tailles supplémentaires sont disponibles pour certaines vidéos.

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

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

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

17 mai 2016

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

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

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

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

28 avril 2016

Cette mise à jour inclut les changements suivants :

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

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

    • La propriété recordingDetails.location définit le lieu que le propriétaire de la vidéo souhaite associer à la vidéo. Cette adresse est modifiable, incluse dans l'index de recherche des vidéos publiques et peut être présentée aux 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 importé. Seul le propriétaire de la vidéo peut voir cette valeur.

  • La définition de la propriété contentDetails.relatedPlaylists.favorites de la ressource channel a été mise à jour pour indiquer que sa valeur peut contenir un ID de playlist qui fait référence à une playlist vide et qui ne peut pas être récupéré. Cela s'explique par le fait que la fonctionnalité "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 son utilisation.

16 mars 2016

Cette mise à jour inclut les changements suivants :

  • Mises à jour des ressources et méthodes existantes

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

    • La nouvelle propriété snippet.customUrl de la ressource channel identifie l'URL personnalisée associée au critère. Notez que toutes les chaînes n'ont pas d'URL personnalisée. Le Centre d'aide YouTube décrit les critères d'éligibilité à l'obtention d'une URL personnalisée, ainsi que la procédure à suivre pour la configurer.

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

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

      La valeur de la propriété est un code pays ISO à deux lettres qui identifie la région. La méthode i18nRegions.list renvoie une liste des régions disponibles. La valeur par défaut est US. Si une région non acceptée est spécifiée, YouTube peut tout de même sélectionner une autre région 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 libellé localisé pour les motifs du rapport d'utilisation abusive.

      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 identifie la classification d'une vidéo par l'Office turc 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 acceptent les nouvelles valeurs de propriété suivantes:

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

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

    • La propriété status.rejectionReason de la ressource video prend en charge 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 sur la vidéo identifiée par le paramètre videoId.
    badRequest (400) commentTextTooLong La méthode commentThreads.insert renvoie cette erreur pour indiquer que la ressource comment insérée contient trop de caractères dans la propriété snippet.topLevelComment.snippet.textOriginal.
    invalidValue (400) videoAlreadyInAnotherSeriesPlaylist La méthode playlistItems.insert renvoie cette erreur pour indiquer que la vidéo que vous essayez d'ajouter à la playlist se trouve déjà dans une autre playlist de séries. Pour en savoir plus sur les playlists de séries, consultez le Centre d'aide YouTube.
    badRequest (400) subscriptionForbidden La méthode subscriptions.insert renvoie cette erreur pour indiquer que vous avez atteint le nombre maximal d'abonnements ou que vous avez créé trop d'abonnements récents. Dans ce dernier cas, vous pouvez relancer la requête quelques heures plus tard.
    badRequest (400) invalidCategoryId La méthode videos.update renvoie cette erreur pour indiquer que la propriété snippet.categoryId de la ressource video importée spécifie un ID de catégorie non valide. Utilisez la méthode videoCategories.list pour récupérer les catégories compatibles.
    badRequest (400) invalidDescription La méthode videos.update renvoie cette erreur pour indiquer que la propriété snippet.description de la ressource video importée a spécifié une valeur non valide.
    badRequest (400) invalidPublishAt La méthode videos.update renvoie cette erreur pour indiquer que la propriété status.publishAt de la ressource video importée a spécifié une heure de publication planifiée non valide.
    badRequest (400) invalidRecordingDetails La méthode videos.update renvoie cette erreur pour indiquer que l'objet recordingDetails de la ressource video importée spécifie des détails d'enregistrement non valides.
    badRequest (400) invalidTags La méthode videos.update renvoie cette erreur pour indiquer que la propriété snippet.tags de la ressource video importée a spécifié une valeur non valide.
    badRequest (400) invalidTitle La méthode videos.update renvoie cette erreur pour indiquer que la propriété snippet.title de la ressource video importée spécifie un titre de vidéo non valide ou vide.
    badRequest (400) invalidVideoMetadata La méthode videos.update renvoie cette erreur pour indiquer que les métadonnées de la requête ne sont pas valides. Cette erreur se produit si la requête met à jour la partie snippet d'une ressource video, mais ne définit pas de valeur pour les propriétés snippet.title et snippet.categoryId.

18 décembre 2015

La législation de l'Union européenne (UE) exige que certaines informations soient divulguées aux utilisateurs finaux de l'UE et qu'ils obtiennent leur consentement. Par conséquent, pour les utilisateurs finaux 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 concernant cette exigence dans les Conditions d'utilisation des API YouTube.

19 novembre 2015

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

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

    Vous pouvez définir des valeurs localisées pour une ressource lorsque vous appelez la méthode insert ou update pour cette ressource. Pour définir des valeurs localisées pour une ressource, effectuez les deux opérations suivantes:

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

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

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

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

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

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

  • Récupérer des valeurs localisées

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

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

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

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

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

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

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

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

  • Erreurs liées aux valeurs du texte localisé

    L'API prend également en charge 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 prennent en charge cette erreur.
    badRequest (400) localizationValidationError Cette erreur indique que l'une des valeurs de l'objet localizations d'une ressource n'a pas pu être validée. Par exemple, cette erreur peut se produire si l'objet contient un code de langue non valide. Les méthodes channels.update, channelSections.insert, channelSections.update, playlists.insert et playlists.update prennent en charge 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 des diffusions nombre de spectateurs simultanés pendant la diffusion.

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

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

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

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

      • Si vous définissez la valeur de cette propriété lorsque vous appelez la méthode videos.update, vous devez également définir la valeur de la propriété status.privacyStatus sur private, même si la vidéo est déjà privée.
      • Si la demande planifie la publication d'une vidéo à un moment précis, la vidéo est publiée immédiatement. Par conséquent, si vous définissez la propriété status.publishAt sur une date et une heure passées, cela revient à modifier la valeur privacyStatus de la vidéo de private à public.

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

    • La définition des paramètres 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 dans le comportement de l'API.

    • La documentation de la méthode thumbnails.set a été mise à jour pour indiquer précisément que le corps de la requête contient la vignette que vous importez et que vous associez à une vidéo. Le corps de la requête ne contient pas de ressource thumbnail. Auparavant, la documentation indiquait que vous ne devez pas fournir de corps de requête lorsque vous appelez cette méthode. Cette mise à jour ne reflète pas un changement dans le 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 pas actuellement les ressources liées aux nouveaux commentaires sur les vidéos. Les champs snippet.type et contentDetails.comment de la ressource ont également été mis à jour.

  • Erreurs nouvelles et mises à jour

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

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

28 août 2015

Cette mise à jour inclut les changements suivants :

  • Mises à jour des ressources et méthodes existantes

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

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

7 août 2015

Cette mise à jour inclut les changements suivants :

  • Mises à jour des ressources et méthodes existantes

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

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

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

18 juin 2015

Cette mise à jour inclut les changements suivants :

  • Mises à jour des ressources et méthodes existantes

    • Le nouveau paramètre order de la méthode commentThreads.list spécifie l'ordre dans lequel la réponse de l'API doit répertorier les fils de commentaires. Vous pouvez trier les fils de discussion 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 contenu YouTube, puis revendiqué par ce partenaire. Cela ne représente pas un changement dans le comportement réel de l'API.

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

  • Erreurs nouvelles et mises à jour

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

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

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

27 avril 2015

Cette mise à jour inclut les changements suivants :

  • Nouvelles ressources et méthodes

    • La nouvelle ressource videoAbuseReportReason contient des informations sur le motif pour lequel 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 dont le contenu est abusif. Le corps de la requête contient un objet JSON qui spécifie la vidéo signalée et le motif pour lequel la vidéo est considérée comme présentant du contenu abusif. Vous pouvez obtenir des motifs valides à l'aide de la méthode videoAbuseReportReason.list décrite ci-dessus.

      Le guide de migration a également été mis à jour pour y inclure un exemple illustrant comment signaler une vidéo abusive. Avec ce changement, l'API v3 est désormais compatible avec toutes les fonctionnalités de la version 2 de l'API qu'elle devrait prendre en charge. Ces fonctionnalités sont également toutes expliquées dans le guide de migration.

  • Mises à jour des ressources et méthodes existantes

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

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

      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 site Web, mais pas aux vidéos mises en ligne via d'autres applications ou sites.

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

    • La nouvelle propriété snippet.country de la ressource channel permet aux propriétaires de chaîne d'associer leurs chaînes à un pays 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 est désormais compatible avec le ciblage des ressources channelSection. Le ciblage par sections de chaîne permet de restreindre la visibilité d'une section de contenu aux utilisateurs correspondant à des critères spécifiques.

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

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

    • La documentation pour les méthodes channelSections.delete, playlistItems.delete, playlists.delete, subscriptions.delete et videos.delete a été corrigée afin d'indiquer qu'en cas de succès, ces méthodes renvoient toutes un code de réponse HTTP 204 (No Content).

  • Erreurs nouvelles et mises à jour

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

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

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

16 avril 2015

Cette mise à jour inclut les changements suivants :

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

    Le guide décrit également plusieurs fonctionnalités de commentaires non compatibles avec la version 2 de l'API, mais compatibles avec la version 3 de l'API. Exemples :

    • Récupérer des commentaires sur 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.
    • Modifier le texte d'un commentaire
    • Marquer un commentaire comme spam
    • Définir l'état de modération d'un commentaire

  • Le guide S'abonner aux notifications push a été mis à jour pour tenir compte du fait que les notifications ne sont transmises 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, les 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 fait des ressources comment imbriquées dans la ressource commentThread. Il est important de noter que la ressource commentThread ne contient pas nécessairement toutes les réponses à un commentaire. Vous devez utiliser la méthode comments.list si vous souhaitez récupérer toutes les réponses à un commentaire particulier. En outre, certains commentaires n'ont pas reçu de réponse.

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

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

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

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

      • comments.list : récupère une liste de commentaires. Utilisez cette méthode pour récupérer toutes les réponses à un commentaire particulier.
      • comments.insert : créez une réponse à un commentaire existant.
      • comments.update : modifie un commentaire.
      • comments.markAsSpam : permet de signaler un ou plusieurs commentaires comme spam.
      • comments.setModerationStatus : définit l'état de modération d'un ou de plusieurs commentaires. Par exemple, vous pouvez effacer un commentaire pour qu'il soit public ou refuser un commentaire comme non adapté à l'affichage. La demande API doit être autorisée par le propriétaire de la chaîne ou de la vidéo associée aux commentaires.
      • comments.delete : supprime un commentaire.

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

  • Le nouveau guide S'abonner aux notifications push explique la nouvelle compatibilité de l'API avec les notifications push via PubSubHubBub, un protocole de publication 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
    • met à jour la description d'une vidéo

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

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

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

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

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

2 avril 2015

Cette mise à jour inclut les changements suivants :

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

    L'API est compatible avec les méthodes permettant de répertorier, 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-titres dans la version 2 de l'API.

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

    Ce nouveau niveau d'accès 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 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é Nouveau dans l'API v3, qui liste les fonctionnalités prises en charge par l'API v3 et non prises en charge par l'API v2. Les mêmes fonctionnalités étaient auparavant proposées et sont toujours répertoriées dans d'autres onglets du guide. Par exemple, la nouvelle fonctionnalité expliquant comment mettre à jour les données des campagnes promotionnelles intégrées aux vidéos d'une chaîne est également disponible dans l'onglet Chaînes (profils).

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

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

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

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

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

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

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

    • Compatibilité avec les flux RSS

    • Notifications push pour les mises à jour de flux : l'API v2 prenait 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 étaient envoyées pour les nouveaux abonnements à des chaînes et lorsque des vidéos étaient évaluées, partagées, marquées comme favorites, commentées ou mises en ligne.

      L'API v3 accepte les notifications push à l'aide du protocole PubSubHubbub, mais elles ne concernent que les importations et les mises à jour du titre ou de la description des vidéos.

    • Localisation de la chaîne : l'API v2 utilisait la balise <yt:location> pour identifier la zone géographique de l'utilisateur telle qu'elle était saisie dans le profil public YouTube de la chaîne. Certains développeurs ont utilisé ce champ pour associer une chaîne à un pays en particulier, mais ses données n'ont pas toujours pu être utilisées à cette fin.

    • Définir ou récupérer des tags de développeur : la version 2 de l'API permettait d'associer des mots clés ou des tags de développeur à une vidéo au moment de sa mise en ligne. Les tags de développeur ne sont pas visibles par les utilisateurs YouTube, mais les propriétaires de vidéos peuvent récupérer les vidéos 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 son application. Avec cette fonctionnalité, chaque vidéo importée porte automatiquement le numéro de projet associé à l'application du développeur dans la Google Developers Console. Le développeur utilise ensuite le même numéro de projet pour rechercher des vidéos.

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

      Il existe quelques exceptions. Les nouvelles vidéos mises en ligne, les vidéos que vous ajoutez aux favoris, les vidéos que vous aimez ou les vidéos que vous avez récemment regardées sont automatiquement ajoutées en tant que premier élément (snippet.position=0) pour les types de playlists suivants. Ainsi, chacune de ces listes est triée du plus récent au plus ancien, en fonction de l'heure à laquelle les éléments ont été ajoutés à la liste.

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

      Sachez toutefois qu'un nouvel article a été ajouté à la playlist "À regarder plus tard" est ajouté en tant que dernier élément de la liste, de sorte que celle-ci soit triée du plus ancien au plus récent.

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

    Avec ces modifications, le guide identifie désormais toutes les fonctionnalités compatibles avec l'ancienne API (v2) qui seront abandonnées dans la version actuelle de l'API (v3).

4 mars 2015

Cette mise à jour inclut les changements suivants :

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

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

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

    Remarque:Aucune de ces propriétés n'était soumise 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 DJCQT (Brésil).

  • L'API prend désormais en charge 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 celle-ci n'utilise pas de tri manuel. Par exemple, les éléments d'une playlist peuvent être triés par date ou par popularité. Pour résoudre cette erreur, supprimez l'élément snippet.position de la ressource envoyée dans le corps de la requête. Si vous souhaitez que l'élément de la playlist ait une position spécifique dans la liste, vous devez d'abord définir l'ordre d'affichage de la playlist sur Manuel. Vous pouvez 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 une chaîne qui a été suspendue.
    forbidden (403) playlistForbidden La méthode playlists.list renvoie cette erreur si le paramètre id de la requête n'est pas compatible avec la requête ou si celle-ci n'est pas correctement autorisée.
    notFound (404) channelNotFound La méthode playlists.list renvoie cette erreur si le paramètre channelId de la requête spécifie un canal introuvable.
    notFound (404) playlistNotFound La méthode playlists.list renvoie cette erreur si le paramètre id de la requête spécifie une playlist introuvable.
    notFound (404) videoNotFound La méthode videos.list renvoie cette erreur si le paramètre id de la requête spécifie une vidéo introuvable.
    badRequest (400) invalidRating La méthode videos.rate renvoie cette erreur si la requête contient une valeur inattendue pour le paramètre rating.

2 mars 2015

Cette mise à jour inclut les changements suivants :

14 janvier 2015

Cette mise à jour inclut les changements suivants :

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

    Étant donné qu'il est possible d'importer des vidéos à l'aide de la bibliothèque cliente JavaScript et de CORS, le guide de migration ne liste plus la fonctionnalité d'importation via un navigateur susceptible d'ê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 à la méthode search.list est passé à 100 unités.

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

    • Coût du quota: 100 unités

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

    • Coût du quota: 6 unités

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

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

8 octobre 2014

Cette mise à jour inclut les changements suivants :

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

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

      • allowed : la chaîne peut mettre en ligne des vidéos de plus de 15 minutes.
      • eligible : la chaîne peut mettre en ligne des vidéos de plus de 15 minutes, mais elle doit d'abord être activée.
      • disallowed : la chaîne ne peut pas 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é. Vous trouverez également des informations plus détaillées sur cette fonctionnalité dans le Centre d'aide YouTube.

    • La propriété invideoPromotion.useSmartTiming indique si la campagne promotionnelle de la chaîne utilise le temps intelligent. Cette fonctionnalité s'efforce de diffuser des publicités à un moment de la vidéo où les utilisateurs sont plus susceptibles de cliquer dessus et moins susceptibles de perturber l'expérience de visionnage. Cette fonctionnalité sélectionne également une seule promotion à 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 sans définir de valeur pour ces deux propriétés, l'API renvoie une erreur invalidRequest. La description de cette erreur a également été mise à jour.

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

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

    Type d'erreur Détails de l'erreur Description
    badRequest bannerAlbumFull L'album "Illustration de chaîne YouTube" du propriétaire de la chaîne contient trop d'images. Le propriétaire de la chaîne doit accéder à http://photos.google.com, accéder à la page "Albums", puis supprimer certaines images 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é avec la requête a dépassé la limite de débit de l'abonnement. Vous pourrez essayer d'autres abonnements dans quelques heures.

12 août 2014

Cette mise à jour inclut les changements suivants :

  • Un nouveau guide, intitulé Migrer votre application vers l'API YouTube Data (v3), explique comment utiliser l'API YouTube Data (v3) pour exécuter les fonctionnalités disponibles dans l'API YouTube Data (v2). L'ancienne API a été officiellement abandonnée le 4 mars 2014. Ce guide a pour but de vous aider à migrer les applications qui utilisent encore l'API v2 vers la version la plus récente de l'API.

8 juillet 2014

Cette mise à jour inclut les changements suivants :

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

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

18 juin 2014

Cette mise à jour inclut les changements suivants :

  • La description de chaque méthode 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 indiquer 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 d'elles ayant un coût de deux unités.

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

  • La ressource video est désormais compatible avec 43 nouveaux systèmes de classification du contenu, qui identifient les classifications attribuées aux vidéos par diverses agences nationales de classification.

28 mai 2014

Cette mise à jour inclut les changements suivants :

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

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

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

13 mai 2014

Cette mise à jour inclut les changements suivants :

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

  • La ressource channelSection peut désormais contenir des informations sur quelques nouveaux types de sélections de contenus. 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és de la chaîne
    • postedVideos : vidéos que le propriétaire de la chaîne a publiées dans le flux d'activités de la chaîne
    • subscriptions : chaînes auxquelles le propriétaire de la chaîne s'est abonné.

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

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

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

  • La définition de la propriété pageInfo.totalResults qui est 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. De plus, la valeur maximale est de 1 000 000. N'utilisez pas cette valeur pour créer des liens de pagination. Utilisez plutôt les valeurs des propriétés nextPageToken et prevPageToken pour déterminer si les liens de pagination doivent être affichés.

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

2 mai 2014

Cette mise à jour inclut les changements suivants :

  • La nouvelle ressource i18nLanguage identifie la langue d'application acceptée par le site Web YouTube. Le langage de l'application peut également être appelé langage d'interface utilisateur. Pour le site Web YouTube, une langue d'application pouvait être sélectionnée automatiquement en fonction des paramètres du compte Google, de la langue du navigateur ou de l'emplacement de l'adresse IP. Un utilisateur pouvait é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 répertorier les langages d'application compatibles. Les langages compatibles peuvent être utilisés comme valeur du paramètre hl lors de l'appel de méthodes d'API telles que videoCategories.list et guideCategories.list.

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

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

7 avril 2014

Cette mise à jour inclut les changements suivants :

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

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

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

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

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

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

  • La définition de l'objet invideoPromotion de la ressource channel a été 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 n'est pas compatible avec le paramètre onBehalfOfContentOwner. Il s'agit d'une erreur de documentation, car les requêtes videos.rate qui définissent ce paramètre renvoient une erreur 500.

31 mars 2014

Cette mise à jour inclut les changements suivants :

13 mars 2014

Cette mise à jour inclut les changements suivants :

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

  • La documentation indique désormais le nombre maximal de caractères accepté 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 prend désormais en charge 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 tentez de mettre à jour la partie brandingSettings d'un canal et de modifier la valeur de la propriété brandingSettings.channel.title. Notez que l'API ne renvoie pas 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'éléments que le nombre autorisé d'éléments promus.
    forbidden (403) promotedVideoNotAllowed La méthode channels.update renvoie cette erreur si la propriété invideoPromotion.items[].id.videoId spécifie un ID vidéo qui est introuvable ou qui ne peut pas être utilisé en tant qu'élément promu.
    forbidden (403) websiteLinkNotAllowed La méthode channels.update renvoie cette erreur si la propriété invideoPromotion.items[].id.websiteUrl spécifie une URL non autorisée.
    required (400) requiredTimingType La méthode channels.update renvoie cette erreur si une requête ne spécifie pas de paramètres de délai par défaut pour l'affichage de l'élément sponsorisé 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 promu.
    badRequest (400) invalidPublishAt La méthode videos.insert renvoie cette erreur si les métadonnées de la requête spécifient une heure de publication planifiée non valide.

4 mars 2014

Cette mise à jour inclut les changements suivants :

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 ou un paramètre de filtre.

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

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

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

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

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

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

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

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

  • Les nouvelles propriétés contentDetails.contentRating.catvRating et contentDetails.contentRating.catvfrRating identifient les classifications d'une vidéo classées par le Système de classification de la télévision canadienne et par le système de classification francophone de la régie du cinéma, respectivement utilisé au Québec.

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

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

24 octobre 2013

Cette mise à jour inclut les changements suivants :

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

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

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

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

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

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

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

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

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

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

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

  • La propriété contentDetails.contentRating.tvpgRating de la ressource video prend désormais en charge la valeur pg14, ce qui correspond à une note TV-14.

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

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

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

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

1er octobre 2013

Cette mise à jour inclut les changements suivants :

  • Le nouvel objet auditDetails de la ressource channel contient des données de canaux qu'un réseau multichaîne évaluerait pour déterminer s'il faut accepter ou refuser un canal particulier. Notez que toute requête API qui récupère cette partie de ressource doit fournir un jeton d'autorisation contenant le champ d'application https://www.googleapis.com/auth/youtubepartner-channel-audit. De plus, tout jeton 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 la date d'émission du jeton.

  • 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 la même que celle pour laquelle les données de 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înes des applications TV.

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

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

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

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

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

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

  • L'API prend désormais en charge 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 en question a désactivé les avis pour cette vidéo.

27 août 2013

Cette mise à jour inclut les changements suivants :

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

    La méthode watermarks.set importe et définit l'image du filigrane d'une chaîne. La méthode watermarks.unset supprime l'image de 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 qui indique si le nombre d'abonnés de la chaîne est masqué. Par conséquent, la valeur de la propriété est false si le nombre d'abonnés de la chaîne est visible publiquement.

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

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

  • Le fichier 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 possède les propriétés nouvelles et 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 le message personnalisé à afficher pour la promotion.

      Les liens peuvent rediriger vers des sites Web associés, des sites marchands ou des réseaux sociaux. Consultez les instructions du centre d'aide YouTube pour les sites Web associés et les sites marchands afin d'en savoir plus sur l'activation des liens pour vos contenus.

      En ajoutant des liens promotionnels, vous acceptez 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 pour l'affichage des éléments sponsorisés pendant la lecture de la vidéo ont été restructurées:

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

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

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

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

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

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

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

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

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

    Type d'erreur Détails de l'erreur Description
    badRequest invalidMine Vous ne pouvez pas utiliser le paramètre mine dans les demandes pour lesquelles l'utilisateur authentifié est un partenaire YouTube. Vous devez soit supprimer le paramètre mine, soit 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.

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

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

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

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

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

  • L'objet contentDetails.contentRating de la ressource video spécifie les classifications d'une vidéo selon différents systèmes de classification, y compris les classifications MPAA, TVPG, etc. Pour chaque système de classification, l'API accepte désormais une valeur de classification qui indique que la vidéo n'a pas été classée. Notez que pour la classification MPAA, la valeur "Sans classification" La classification sert souvent à identifier les versions pré-montage des films pour lesquelles la version définitive a reçu une classification officielle.

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

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

  • Les méthodes channelBanners.insert, channels.update, videos.getRating et videos.rate sont désormais compatibles avec le paramètre onBehalfOfContentOwner. Ce paramètre indique que l'utilisateur authentifié agit 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 refléter le 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.

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

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

10 juin 2013

Cette mise à jour inclut les changements suivants :

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

  • La méthode activities.list accepte désormais le paramètre regionCode, qui demande à 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èrent des données concernant leurs propres playlists. Les utilisateurs autorisés peuvent également définir des tags de playlist lors de l'appel des méthodes playlists.insert ou playlists.update.

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

    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 de nombreuses chaînes YouTube différentes. Ce paramètre permet à ces partenaires de s'authentifier une seule fois et d'accéder à toutes les données de leurs vidéos et de leur chaîne, sans avoir à fournir d'identifiants d'authentification pour chaque chaîne.

    Dans cette nouvelle version, le paramètre permet désormais à un partenaire du réseau de contenu d'insérer, de mettre à jour ou de supprimer des vidéos sur n'importe quelle chaîne YouTube dont il est propriétaire.

  • Le 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. Il indique que l'utilisateur du CMS qui appelle l'API ne dispose pas des autorisations nécessaires pour effectuer l'opération demandée. Cette erreur est associée à l'utilisation du paramètre onBehalfOfContentOwner, qui est compatible avec plusieurs méthodes d'API.
    unauthorized authorizationRequired La méthode activities.list renvoie cette erreur lorsque la requête utilise le paramètre home, mais qu'elle n'est pas correctement autorisée.

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

  • Le nouveau guide Utiliser des ID de chaîne explique comment l'API utilise les ID de chaîne. Il peut s'avérer 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 qui reposent sur l'idée que chaque chaîne YouTube possède un nom d'utilisateur unique, ce qui n'est plus le cas aujourd'hui.

22 mai 2013

Cette mise à jour inclut les changements suivants :

14 mai 2013

Cette mise à jour inclut les changements suivants :

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

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

10 mai 2013

Cette mise à jour inclut les changements suivants :

8 mai 2013

Cette mise à jour inclut les changements suivants :

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

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

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

2 mai 2013

Cette mise à jour inclut les changements suivants :

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

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

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

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

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

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

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

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

    • La ressource youtube#videoListResponse, qui est renvoyée en réponse à une requête videos.list, contient désormais l'objet pageInfo, qui contient des informations telles que le nombre total de résultats et le nombre de résultats inclus dans l'ensemble de résultats actuel. La ressource youtube#videoListResponse peut également inclure des propriétés nextPageToken et prevPageToken, chacune fournissant un jeton permettant de 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 que YouTube améliore automatiquement la luminosité et la couleur de la vidéo.
    • stabilize : définissez cette valeur de paramètre sur true pour que YouTube ajuste la vidéo en supprimant les tremblements causés par les mouvements de la caméra.

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

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

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

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

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

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

  • Les requêtes API qui contiennent un paramètre inattendu renvoient désormais une erreur badRequest. Le motif signalé 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 maintenant signalée en tant qu'erreur forbidden, et le motif de l'erreur est playlistContainsMaximumNumberOfVideos.

19 avril 2013

Cette mise à jour inclut les changements suivants :

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

    La documentation sur les erreurs a également été mise à jour pour 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 miniatures sont désormais identifiées comme une ressource distincte. La nouvelle méthode thumbnails.set vous permet d'importer une miniature personnalisée sur YouTube et de la définir pour une vidéo.

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

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

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

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

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

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

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

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

    • Le nouveau paramètre forMine limite les recherches aux seules vidéos de l'utilisateur authentifié.

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

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

  • La méthode videos.insert est compatible avec 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 compatibles.
    badRequest invalidRecordingDetails metadata specifies invalid recording details.
    badRequest invalidVideoGameRating Les métadonnées de la requête spécifient une classification du 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 : cette propriété spécifie le nom du canal responsable de l'activité.
    • search : cette propriété indique le nom du canal associé à la ressource identifiée dans les résultats de recherche.
    • video : la propriété indique 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 la recherche de chaînes afin de récupérer toutes les chaînes ou uniquement les émissions.

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

  • La définition de la partie recordingDetails de la ressource video a été modifiée 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 est renvoyée si la requête API ne spécifie pas d'extrait valide.

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

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

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

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

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

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

25 février 2013

Cette mise à jour inclut les changements suivants :

  • L'API accepte plusieurs nouvelles 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 de mettre en ligne des vidéos. Elles incluent les éléments suivants:

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

      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, la durée, les codecs audio et vidéo du fichier, les débits de flux, etc.

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

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

      • dimension : indique si la vidéo est disponible en 2D ou 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 inclut du contenu revendiqué par un partenaire de contenu YouTube.

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

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

  • La définition du paramètre part a été mise à jour pour les méthodes videos.list, videos.insert et videos.update afin de 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 du profil Google+ associé à la chaîne. Cette valeur peut être utilisée pour générer un lien vers le profil Google+.

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

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

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

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

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

30 janvier 2013

Cette mise à jour inclut les changements suivants :

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

16 janvier 2013

Cette mise à jour inclut les changements suivants :

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

  • Une ressource activity peut désormais signaler une action channelItem, qui se produit lorsqu'YouTube ajoute une vidéo à une chaîne YouTube générée automatiquement. (YouTube utilise des algorithmes pour identifier les thèmes qui occupent une place importante sur le site YouTube et génère automatiquement des chaînes s'y rapportant.)

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

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

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

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

  • Plusieurs ressources d'API prennent en charge les nouvelles propriétés. Le tableau ci-dessous présente les ressources et leurs nouvelles propriétés:

    Ressource Nom de propriété Valeur Description
    activity contentDetails.playlistItem.playlistItemId string ID de l'élément de la playlist attribué par YouTube comme identifiant unique de l'élément dans la playlist.
    activity contentDetails.channelItem object Objet contenant des informations sur une ressource ajoutée à 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, comme une vidéo ou une playlist. Il contient également une seule des propriétés (videoId, playlistId, etc.) qui spécifie l'ID qui identifie cette ressource de manière unique.
    channel status object Cet objet encapsule les informations sur le niveau de confidentialité de la chaîne.
    channel status.privacyStatus string É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 que vous pouvez utiliser pour lire la playlist dans un lecteur intégré.
    playlist player.embedHtml string Une balise <iframe> qui intègre un lecteur vidéo qui lit la playlist.
    video recordingDetails object Cet objet encapsule des informations identifiant ou décrivant le lieu et l'heure d'enregistrement de la vidéo.
    video recordingDetails.location object Cet objet contient des informations de géolocalisation associées à la vidéo.
    video recordingDetails.location.latitude double Latitude en degrés.
    video recordingDetails.location.longitude double Longueur en degrés.
    video recordingDetails.location.elevation double Altitude au-dessus de la Terre, en mètres.
    video recordingDetails.locationDescription string Description textuelle du lieu où la vidéo a été enregistrée.
    video recordingDetails.recordingDate datetime Date et heure d'enregistrement de la vidéo. La valeur est spécifiée au format ISO 8601 (YYYY-MM-DDThh:mm:ss.sZ).

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

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

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

  • L'API ne signale plus d'erreur playlistAlreadyExists si vous essayez de créer ou de mettre à jour une playlist dont le titre est identique à celui d'une playlist déjà présente sur la même chaîne.

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

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