Cette page liste les modifications apportées à l'API YouTube Data (v3) et les mises à jour de la documentation. S'abonner à ce journal des modifications
30 avril 2024
Remarque:Il s'agit d'une annonce de l'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. Ce changement s'inscrit parfaitement dans le cadre de la fonctionnalité disponible sur le site Web YouTube, qui ne permet pas de publier des commentaires sur les chaînes.
13 mars 2024
Remarque:Il s'agit d'une annonce de l'abandon.
Cette mise à jour inclut les changements suivants :
Abandon du paramètre sync
pour les méthodes captions.insert
et captions.update
. YouTube ne prendra plus en charge ce paramètre à compter du 12 avril 2024.
En raison de ce changement, les développeurs doivent inclure des informations temporelles lorsqu'ils insèrent ou mettent à jour des pistes de sous-titres, sans quoi l'importation échouera.
12 mars 2024
Cette mise à jour inclut les changements suivants :
La documentation de la ressource captions
a été mise à jour pour indiquer que la longueur maximale autorisée pour le champ snippet.name
est de 150 caractères. L'API renvoie une erreur nameTooLong
si le nom du canal est plus long.
7 mars 2024
Remarque:Il s'agit d'une annonce de l'abandon.
La propriété de ressource channel
brandingSettings.channel.moderateComments
est obsolète. YouTube ne prendra plus en charge ce paramètre à compter du 7 mars 2024.
31 janvier 2024
Cette mise à jour inclut les changements suivants :
Le nouveau paramètre forHandle
de la méthode channels.list
vous permet de récupérer des informations sur une chaîne en spécifiant son identifiant YouTube.
9 novembre 2023
Toutes les références à la ressource videoId
sous Comments
ont été supprimées, car la ressource videoId
n'est pas renvoyée à l'aide d'un appel d'API.
12 septembre 2023
Remarque:Il s'agit d'une annonce de l'abandon.
La méthode comments.markAsSpam
est obsolète depuis plusieurs années. Cette méthode n'est pas disponible sur YouTube et n'est plus acceptée via l'API.
Un avis d'abandon a été ajouté à tous les documents faisant référence à la méthode comments.markAsSpam
.
22 août 2023
La méthode search.list
accepte désormais le paramètre videoPaidProductPlacement
. Ce paramètre vous permet de filtrer les résultats de recherche pour n'inclure que les vidéos que le créateur a indiquées comme contenant une communication commerciale.
18 août 2023
La définition du liveStreamingDetails.concurrentViewers
de la ressource video
a été mise à jour pour indiquer que le nombre de spectateurs simultanés renvoyés par l'API YouTube Data peut être différent du nombre de spectateurs simultanés traités et supprimés des spams disponibles dans YouTube Analytics. Vous trouverez plus d'informations sur les métriques liées aux diffusions en direct dans le Centre d'aide YouTube.
7 août 2023
Comme annoncé le 12 juin 2023, le paramètre relatedToVideoId
de la méthode search.list
a été abandonné. Ce paramètre n'est plus accepté et les références s'y rapportant ont été supprimées de la documentation de l'API.
28 juin 2023
La méthode thumbnails.set prend désormais en charge l'erreur uploadRateLimitExceeded
, qui indique que la chaîne a mis en ligne trop de miniatures au cours des dernières 24 heures. Elle doit donc réessayer plus tard.
12 juin 2023
Remarque:Il s'agit d'une annonce de l'abandon.
Le paramètre relatedToVideoId
de la méthode search.list a été abandonné. YouTube ne prendra plus en charge ce paramètre à compter du 7 août 2023.
Pour l'instant, un avis d'abandon a été ajouté à la documentation de la méthode search.list
. Ce paramètre sera complètement supprimé de la documentation search.list
le 7 août 2023 ou après cette date.
En outre, un exemple illustrant comment récupérer des vidéos similaires a été supprimé du guide d'implémentation de l'API.
22 août 2022
Correction des annotations de type pour les champs video.statistics par une chaîne d'une longueur non signée.
5 août 2022
YouTube a modifié la façon dont les ID de sous-titres sont générés et, dans le cadre de ce changement, il attribue de nouveaux ID à toutes les pistes de sous-titres. Cette modification peut être rétrocompatible pour les applications qui stockent des valeurs caption_id
, bien qu'elle n'affecte pas les applications qui ne stockent pas de valeurs caption_id
.
D'ici le 1er décembre 2022, les méthodes captions.list
, captions.update
, captions.download
et captions.delete
prendront en charge les anciens et les nouveaux ID de piste de sous-titres. Cependant, à partir du 1er décembre 2022, YouTube n'acceptera plus les anciens ID de piste de sous-titres. À ce stade, l'appel de l'une de ces méthodes d'API avec un ancien ID de piste de sous-titres entraînera une erreur captionNotFound
.
Pour vous préparer à ce changement, vous devez remplacer complètement toutes les données stockées sur les pistes de sous-titres d'ici le 1er décembre 2022. Cela signifie que pour toute vidéo pour laquelle vous stockez des données de piste de sous-titres, vous devez supprimer les données actuellement stockées, puis appeler la méthode captions.list
pour récupérer l'ensemble actuel de pistes de sous-titres et stocker les données dans la réponse de l'API comme vous le feriez normalement.
12 juillet 2022
Les conditions d'utilisation des services d'API YouTube ont été mises à jour. Pour en savoir plus, consultez les Conditions d'utilisation des services d'API YouTube – Historique des révisions.
27 avril 2022
La description de la méthode videos.insert
a été mise à jour pour indiquer que la taille de fichier maximale pour les vidéos importées est passée de 128 Go à 256 Go.
8 avril 2022
Les définitions des paramètres myRecentSubscribers
et mySubscribers
de la méthode subscriptions.list
ont toutes deux été mises à jour pour indiquer que le nombre maximal d'abonnés renvoyés par l'API peut être limité.
Cette modification constitue une correction de la documentation et non un changement du comportement de l'API.
15 décembre 2021
Comme annoncé le 18 novembre 2021, en plus des modifications apportées pour rendre privé le nombre de "Je n'aime pas" sur les vidéos sur l'ensemble de la plate-forme YouTube, la propriété statistics.dislikeCount
de la ressource video
est désormais privée.
Pour en savoir plus sur ce changement, consultez le blog YouTube officiel.
18 novembre 2021
Parallèlement aux modifications apportées pour rendre le nombre de "Je n'aime pas" des vidéos privé sur l'ensemble de la plate-forme YouTube, la propriété statistics.dislikeCount
de la ressource video
sera rendue privée à compter du 13 décembre 2021. Cela signifie que la propriété ne sera incluse dans une réponse d'API du point de terminaison videos.list
que si la requête API a été authentifiée par le propriétaire de la vidéo.
Le point de terminaison videos.rate
n'est pas concerné par cette modification.
Les développeurs qui n'affichent pas publiquement le nombre de "Je n'aime pas" et qui ont toujours besoin de le connaître pour leur client API peuvent demander à être ajoutés à une liste d'autorisation afin d'obtenir une exception. Pour demander une exemption, vous devez remplir ce formulaire de demande.
Pour en savoir plus sur ce changement, consultez le blog YouTube officiel.
2 juillet 2021
Remarque:Il s'agit d'une annonce de l'abandon.
Le point de terminaison commentThreads.update
est obsolète et n'est plus accepté.
Ce point de terminaison a dupliqué une fonctionnalité disponible via d'autres points de terminaison de l'API. À la place, vous pouvez appeler la méthode comments.update
.
commentThreads
, effectuez un appel secondaire à la méthode commentThreads.list
.
1er juillet 2021
Tous les développeurs qui utilisent les services d'API de YouTube doivent effectuer un audit de conformité des API afin d'obtenir un quota supérieur au quota par défaut de 10 000 unités. À ce jour, le processus d'audit de conformité et les demandes d'allocations d'unités de quota supplémentaires ont été effectués par les développeurs qui remplissent et envoient le formulaire d'audit et d'extension de quota des services d'API YouTube.
Afin de clarifier ces processus et de mieux répondre aux besoins des développeurs utilisant nos services d'API, nous ajoutons trois nouveaux formulaires ainsi qu'un guide pour les remplir:
- Formulaire de demande d'examen de conformité pour les développeurs: les développeurs qui ont déjà réussi un audit de conformité des API peuvent remplir et envoyer ce formulaire, plus court, pour demander une extension de quota allouée.
- Formulaire d'appel: les développeurs dont les projets API n'ont pas été soumis à un audit de conformité (ou n'ont pas reçu d'augmentation d'unité de quota) peuvent remplir et envoyer ce formulaire.
- Formulaire de changement de contrôle: les développeurs, ou toute partie gérant un client API au nom d'un développeur, qui font l'objet d'un changement de direction (par exemple, via l'achat ou la vente d'actions, une fusion ou une autre forme de transaction d'entreprise) associés à un projet d'API, doivent remplir et envoyer ce formulaire. Cela permet à l'équipe API de YouTube de mettre à jour nos dossiers, de vérifier la conformité des cas d'utilisation du nouveau projet d'API et de valider l'allocation actuelle des quotas au développeur.
Chaque nouveau formulaire nous informera de l'utilisation que vous comptez faire de l'API YouTube et nous permettra de mieux vous aider.
Pour en savoir plus, consultez notre nouveau guide des audits de conformité des API.
12 mai 2021
Remarque:Il s'agit d'une annonce de l'abandon.
Cette mise à jour couvre les modifications suivantes de l'API:
-
La propriété
contentDetails.relatedPlaylists.favorites
de la ressourcechannel
est obsolète. La fonctionnalité "Vidéos préférées" est déjà obsolète depuis plusieurs années, comme indiqué dans l'entrée de l'historique des révisions du 28 avril 2016.Avant cette mise à jour, l'API créait toujours une playlist si un client API tentait d'ajouter une vidéo à une playlist de favoris inexistante. Dans ce cas, la playlist ne sera pas créée et l'API renverra une erreur. Les tentatives de modification des playlists favorites en ajoutant, en modifiant ou en supprimant des éléments sont également obsolètes, conformément aux annonces précédentes, et peuvent renvoyer des erreurs à tout moment.
-
Les propriétés de ressource
channel
suivantes sont obsolètes. Ces propriétés ne sont déjà pas disponibles dans l'interface utilisateur de YouTube Studio ni sur YouTube. Par conséquent, elles ne sont plus prises en charge via l'API.brandingSettings.channel.defaultTab
brandingSettings.channel.featuredChannelsTitle
brandingSettings.channel.featuredChannelsUrls[]
brandingSettings.channel.profileColor
brandingSettings.channel.showBrowseView
brandingSettings.channel.showRelatedChannels
Toutes les propriétés ont été supprimées de la représentation de ressource
channel
et leurs définitions ont été supprimées de la liste des propriétés de la ressource. De plus, les erreurs associées à ces propriétés ont été supprimées de la documentation spécifique aux méthodes. -
Les propriétés de ressource
channelSection
suivantes sont obsolètes. Ces propriétés ne sont déjà pas disponibles dans l'interface utilisateur de YouTube Studio ni sur YouTube. Par conséquent, elles ne sont plus prises en charge via l'API.snippet.style
snippet.defaultLanguage
snippet.localized.title
localizations
localizations.(key)
localizations.(key).title
targeting
targeting.languages[]
targeting.regions[]
targeting.countries[]
Parallèlement à cette modification, le paramètre
hl
de la méthodechannelSection.list
est également obsolète, car les fonctionnalités qu'elle prend en charge ne sont pas compatibles.Toutes les propriétés ont été supprimées de la représentation de ressource
channelSection
et leurs définitions ont été supprimées de la liste des propriétés de la ressource. De plus, les erreurs associées à ces propriétés ont été supprimées de la documentation spécifique aux méthodes. -
Pour la propriété
snippet.type
de la ressourcechannelSection
, les valeurs suivantes sont obsolètes. Ces valeurs ne sont déjà pas acceptées sur les pages de chaîne YouTube. Par conséquent, elles ne le sont plus via l'API.likedPlaylists
likes
postedPlaylists
postedVideos
recentActivity
recentPosts
-
La propriété
snippet.tags[]
de la ressourceplaylist
est obsolète. Cette propriété n'est déjà pas acceptée sur YouTube. Par conséquent, elle n'est plus acceptée via l'API.
9 février 2021
La ressource playlistItem
accepte deux nouvelles propriétés:
- La propriété
snippet.videoOwnerChannelId
identifie l'ID de la chaîne qui a mis en ligne la vidéo de la playlist. - La propriété
snippet.videoOwnerChannelTitle
identifie le nom de la chaîne sur laquelle la vidéo de la playlist a été mise en ligne.
28 janvier 2021
Cette mise à jour inclut les changements suivants :
-
Les méthodes
playlistItems.delete
,playlistItems.insert
,playlistItems.list
,playlistItems.update
,playlists.delete
,playlists.list
etplaylists.update
acceptent toutes une nouvelle erreurplaylistOperationUnsupported
. Cette erreur se produit lorsqu'une requête tente d'effectuer une opération non autorisée pour une playlist particulière. Par exemple, un utilisateur ne peut pas supprimer une vidéo de sa playlist de vidéos mises en ligne, ni supprimer la playlist elle-même.Dans tous les cas, cette erreur renvoie un code de réponse HTTP
400
(Requête incorrecte). -
Les erreurs
watchHistoryNotAccessible
etwatchLaterNotAccessible
de la méthodeplaylistItems.list
ont été supprimées de la documentation. Bien que l'historique des vidéos regardées et les listes "À regarder plus tard" des utilisateurs ne soient en effet pas accessibles via l'API, ces erreurs particulières ne sont pas renvoyées par l'API.
15 octobre 2020
Deux nouvelles sections ont été ajoutées au Règlement pour les développeurs:
- La nouvelle Section III.E.4.i fournit des informations supplémentaires sur les données collectées et envoyées via le lecteur YouTube intégré. Vous êtes responsable des données utilisateur que vous nous envoyez via un lecteur YouTube intégré avant que l'utilisateur n'ait interagi avec le lecteur pour indiquer son intention de lecture. Vous pouvez limiter les données partagées avec YouTube avant qu'un utilisateur n'interagisse avec le lecteur en définissant la lecture automatique sur "false".
- La nouvelle Section III.E.4.j concerne la vérification de l'état d'un contenu conçu pour les enfants avant de l'intégrer à vos sites et applications. Vous êtes tenu de savoir si les vidéos que vous intégrez dans votre client API sont conçues pour les enfants et de traiter les données collectées à partir du lecteur intégré en conséquence. Vous devez donc vérifier l'état du contenu à l'aide de l'API YouTube Data avant de l'intégrer à votre client API via des lecteurs intégrés YouTube.
Le nouveau guide Finding the MadeForKids status of a video (Trouver le statut MadeForKids d'une vidéo) explique comment rechercher l'état des vidéos conçues pour les enfants à l'aide du service d'API YouTube Data.
Parallèlement à ces modifications, un rappel a été ajouté à la documentation sur les paramètres du lecteur intégré pour expliquer que si vous activez la lecture automatique, la lecture a lieu sans interaction de l'utilisateur avec le lecteur. La collecte et le partage des données de lecture ont donc lieu au chargement de la page.
8 octobre 2020
Cette mise à jour couvre trois petites modifications liées à la ressource channel
:
- L'objet
snippet.thumbnails
, qui identifie les miniatures d'une chaîne, peut être vide pour les nouvelles chaînes et mettre jusqu'à un jour à s'afficher. - La propriété
statistics.videoCount
ne reflète que le nombre de vidéos publiques de la chaîne, y compris celles des propriétaires. Ce comportement est cohérent avec celui indiqué sur le site Web YouTube. - Les mots clés de catégorie, identifiés dans la propriété
brandingSettings.channel.keywords
, peuvent être tronqués s'ils dépassent la longueur maximale autorisée de 500 caractères ou s'ils contiennent des guillemets non échappés ("
). Notez que la limite de 500 caractères n'est pas une limite par mot clé, mais une limite appliquée à la longueur totale de tous les mots clés. Ce comportement est le même que sur le site Web YouTube.
9 septembre 2020
Remarque:Il s'agit d'une annonce de l'abandon.
Cette mise à jour couvre les modifications d'API suivantes. Toutes les modifications entreront en vigueur à compter du 9 septembre 2020, date de cette annonce. C'est pourquoi les développeurs ne doivent plus s'appuyer sur les fonctionnalités d'API listées ci-dessous.
-
Les ressources, méthodes, paramètres et propriétés de ressource d'API suivants sont immédiatement obsolètes et cesseront de fonctionner à la date de cette annonce ou après :
- Les propriétés de ressource
channel
suivantes :- Propriété
statistics.commentCount
- L'objet
brandingSettings.image
et toutes ses propriétés enfants - La liste
brandingSettings.hints
et toutes ses propriétés enfants
- Propriété
- Paramètre de filtre
categoryId
de la méthodechannels.list
- La ressource
guideCategories
et la méthodeguideCategories.list
- Les propriétés de ressource
-
Les réponses de l'API pour la méthode
channels.list
ne contiennent plus la propriétéprevPageToken
si la requête API définit le paramètremanagedByMe
surtrue
. Cette modification n'affecte pas la propriétéprevPageToken
des autres requêteschannels.list
, ni la propriéténextPageToken
des requêtes. -
Les propriétés
contentDetails.relatedPlaylists.watchLater
etcontentDetails.relatedPlaylists.watchHistory
de la ressourcechannel
ont toutes deux été annoncées comme obsolètes le 11 août 2016. La compatibilité des méthodesplaylistItems.insert
etplaylistItems.delete
avec ces playlists est également désormais complètement obsolète. Les deux propriétés ont été supprimées de la documentation. -
Le paramètre
mySubscribers
de la méthodechannels.list
, qui a été annoncé comme obsolète le 30 juillet 2013, a été supprimé de la documentation. Utilisez la méthodesubscriptions.list
et son paramètremySubscribers
pour récupérer la liste des abonnés à la chaîne de l'utilisateur authentifié. -
L'objet
invideoPromotion
de la ressourcechannel
et toutes ses propriétés enfants, annoncés comme obsolètes le 27 novembre 2017, ont été supprimés de la documentation.
29 juillet 2020
Nous avons simplifié le processus de facturation du quota des requêtes API en supprimant le coût supplémentaire associé au paramètre part
. Avec effet immédiat, nous ne facturerons que le coût de base de la méthode appelée. Pour en savoir plus sur le quota simplifié, cliquez ici.
Avec cette modification, le coût de la plupart des appels d'API sera légèrement inférieur, tandis que le coût de certains appels d'API restera le même. Ce changement n'augmente pas le coût des appels d'API. Dans l'ensemble, l'impact probable est que votre quota alloué, comme vous pouvez le voir dans la console Google Cloud, ira un peu plus loin.
Nous recommandons vivement à tous les développeurs d'effectuer un audit de conformité pour leurs projets afin de continuer à accéder aux services d'API YouTube.
Cette entrée de l'historique des révisions a été publiée pour la première fois le 20 juillet 2020.
28 juillet 2020
Toutes les vidéos importées via le point de terminaison videos.insert
à partir de projets d'API non validés créés après le 28 juillet 2020 seront limitées au mode de visionnage privé. Pour lever cette restriction, chaque projet doit faire l'objet d'un audit afin de vérifier qu'il respecte les Conditions d'utilisation.
Les créateurs qui utilisent un client API non validé pour mettre en ligne une vidéo recevront un e-mail leur expliquant que leur vidéo est verrouillée en mode privé et qu'ils peuvent contourner les restrictions en faisant appel à un client officiel ou audité.
Les projets d'API créés avant le 28 juillet 2020 ne sont actuellement pas concernés par ce changement. Toutefois, nous recommandons vivement à tous les développeurs d'effectuer un audit de conformité pour leurs projets afin de continuer à accéder aux services d'API YouTube.
21 juillet 2020
[Mis à jour le 28 juillet 2020] La mise à jour de la documentation référencée dans cette entrée de l'historique des révisions a été republiée le 28 juillet 2020.
Hier, nous avons publié une mise à jour de la documentation concernant notre processus de facturation des quotas. Toutefois, pour des raisons imprévues, le changement de quota n'est pas encore en vigueur. Par conséquent, pour des raisons d'exactitude, la documentation a été rétablie. Pour éviter toute confusion, l'entrée de l'historique des révisions expliquant la modification a été supprimée et sera à nouveau publiée prochainement.
7 juillet 2020
Remarque:Il s'agit d'une annonce de l'abandon.
Les paramètres autoLevels
et stabilize
de la méthode videos.insert
sont désormais obsolètes et ont été supprimés de la documentation. Leurs valeurs sont ignorées et n'affectent pas le traitement des vidéos nouvellement mises en ligne.
15 juin 2020
Le nouveau guide Respecter le Règlement pour les développeurs YouTube fournit des conseils et des exemples pour vous aider à vous assurer que vos clients d'API respectent certaines sections spécifiques des Conditions d'utilisation et des Règles des services d'API YouTube.
Ces conseils vous expliquent comment YouTube applique certains aspects des conditions d'utilisation des API, mais ne remplacent pas les documents existants. Il répond à certaines des questions les plus courantes posées par les développeurs lors des audits de conformité des API. Nous espérons qu'elle simplifiera le processus de développement de fonctionnalités en vous aidant à comprendre comment nous interprétons et appliquons nos règles.
4 juin 2020
Remarque:Il s'agit d'une mise à jour d'une annonce précédente concernant l'abandon.
La fonctionnalité Bulletin de chaîne est désormais complètement obsolète. Cette modification, initialement annoncée le 17 avril 2020, est désormais effective. Par conséquent, la méthode activities.insert
n'est plus acceptée et la méthode activities.list
ne renvoie plus de bulletins de chaîne. Pour en savoir plus, consultez le Centre d'aide YouTube.
17 avril 2020
Remarque:Il s'agit d'une annonce de l'abandon.
YouTube va abandonner la fonctionnalité de bulletin de chaîne. Par conséquent, la méthode activities.insert
sera obsolète, et la méthode activities.list
cessera de renvoyer des bulletins de chaîne. Ces modifications entreront en vigueur dans l'API à partir du 18 mai 2020. Pour en savoir plus, consultez le Centre d'aide YouTube.
31 mars 2020
Cette mise à jour inclut les changements suivants :
-
Nouvelles ressources et méthodes
-
La nouvelle ressource
member
représente le membre d'une chaîne YouTube. Un membre offre un soutien financier récurrent à un créateur et reçoit des avantages spéciaux. Par exemple, les membres peuvent discuter lorsque le créateur active le mode réservé aux membres pour un chat.Cette ressource remplace la ressource
sponsor
, qui est documentée dans le cadre de l'API YouTube Live Streaming. La ressourcesponsor
est désormais obsolète, et les clients API doivent mettre à jour les appels à la méthodesponsors.list
pour utiliser la méthodemembers.list
à la place. -
La nouvelle ressource
membershipsLevel
identifie un niveau de tarification géré par le créateur qui a autorisé la requête API. La méthodemembershipsLevels.list
permet de récupérer la liste de tous les niveaux de souscription du créateur.
-
10 janvier 2020
L'API vous permet désormais d'identifier les contenus destinés aux enfants que YouTube considère comme "conçus pour les enfants". Pour en savoir plus sur les contenus conçus pour les enfants, consultez le Centre d'aide YouTube.
Les ressources channel
et video
prennent en charge deux nouvelles propriétés permettant aux créateurs de contenu et aux spectateurs d'identifier les contenus conçus pour les enfants:
-
La propriété
selfDeclaredMadeForKids
permet aux créateurs de contenu d'indiquer si une chaîne ou une vidéo est conçue pour les enfants.
Pour les canaux, cette propriété peut être définie lors de l'appel de la méthodechannels.update
. Pour les vidéos, cette propriété peut être définie lors de l'appel des méthodesvideos.insert
ouvideos.update
.
Notez que cette propriété n'est incluse dans les réponses de l'API contenant des ressourceschannel
ouvideo
que si le propriétaire du canal a autorisé la requête API. -
La propriété
madeForKids
permet aux utilisateurs de déterminer si une chaîne ou une vidéo est définie comme "conçue pour les enfants". Par exemple, l'état peut être déterminé en fonction de la valeur de la propriétéselfDeclaredMadeForKids
. Consultez le Centre d'aide YouTube pour découvrir comment définir l'audience de votre chaîne, de vos vidéos ou de vos diffusions.
Nous avons également mis à jour les conditions d'utilisation des services d'API YouTube et le règlement pour les développeurs. Pour en savoir plus, consultez les Conditions d'utilisation des services d'API YouTube – Historique des révisions. Les modifications apportées aux conditions d'utilisation des services d'API YouTube et au règlement pour les développeurs prendront effet le 10 janvier 2020 (heure du Pacifique).
10 septembre 2019
La documentation de référence de l'API a été mise à jour pour refléter un changement concernant la façon dont le nombre d'abonnés est indiqué sur YouTube et, par conséquent, dans les réponses de l'API. En raison de ce changement, le nombre d'abonnés renvoyé par l'API YouTube Data est arrondi à trois chiffres significatifs pour les nombres d'abonnés supérieurs à 1 000 abonnés. Cette modification affecte la propriété statistics.subscriberCount de la ressource channel
.
Remarque:Cette modification affecte cette valeur de propriété même si un utilisateur envoie une demande autorisée de données sur sa propre chaîne. Les propriétaires de chaîne peuvent toujours voir le nombre exact d'abonnés dans YouTube Studio.
Par exemple, si une chaîne compte 123 456 abonnés, la propriété statistics.subscriberCount
contient la valeur 123000
.
Le tableau ci-dessous montre comment le nombre d'abonnés est arrondi dans les réponses de l'API et abrégé dans d'autres interfaces utilisateur YouTube visibles par tous:
Exemple de nombre d'abonnés | API YouTube Data | Interfaces utilisateur YouTube visibles publiquement |
---|---|---|
1 234 | 1230 | 1,23 K |
12 345 | 12300 | 12,3 k |
123 456 | 123000 | 123 K |
1 234 567 | 1230000 | 1,23 M |
12 345 678 | 12300000 | 12,3 M |
123,456,789 | 123000000 | 123 M |
4 avril 2019
Cette mise à jour inclut les changements suivants :
-
La documentation de référence de l'API a été mise à jour pour mieux expliquer les cas d'utilisation courants de chaque méthode et pour fournir des exemples de code dynamiques et de haute qualité via le widget APIs Explorer. Consultez la documentation de la méthode
channels.list
pour obtenir un exemple. Les pages qui décrivent les méthodes API comportent désormais deux nouveaux éléments:-
Le widget APIs Explorer vous permet de sélectionner des niveaux d'autorisation, de saisir des exemples de valeurs de paramètres et de propriétés, puis d'envoyer des requêtes API réelles et d'afficher les réponses réelles de l'API. Le widget propose également une vue plein écran présentant des exemples de code complets, mis à jour de façon dynamique pour utiliser les champs d'application et les valeurs que vous avez saisis.
-
La section Cas d'utilisation courants décrit un ou plusieurs cas d'utilisation courants de la méthode présentée sur la page. Par exemple, vous pouvez appeler la méthode
channels.list
pour récupérer des données sur un canal spécifique ou sur le canal de l'utilisateur actuel.Vous pouvez utiliser les liens de cette section pour renseigner APIs Explorer avec des exemples de valeurs pour votre cas d'utilisation ou pour ouvrir APIs Explorer en plein écran avec ces valeurs déjà renseignées. Ces modifications visent à vous permettre de voir plus facilement des exemples de code directement applicables au cas d'utilisation que vous essayez d'implémenter dans votre propre application.
Les exemples de code sont actuellement compatibles avec Java, JavaScript, PHP, Python et curl.
-
-
L'outil Exemples de code a également été mis à jour et dispose d'une nouvelle interface utilisateur offrant toutes les fonctionnalités décrites ci-dessus. Cet outil vous permet d'explorer les cas d'utilisation de différentes méthodes, de charger des valeurs dans APIs Explorer et d'ouvrir APIs Explorer en plein écran pour obtenir des exemples de code en Java, JavaScript, PHP et Python.
Parallèlement à ce changement, les pages listant précédemment des exemples de code disponibles pour Java, JavaScript, PHP et Python ont été supprimées.
-
Les guides de démarrage rapide pour Java, JavaScript, PHP et Python ont été mis à jour. Les guides révisés expliquent comment exécuter un exemple avec une clé API et un autre exemple avec un ID client OAuth 2.0 à l'aide d'exemples de code d'APIs Explorer.
Notez que les modifications décrites ci-dessus remplacent un outil interactif qui avait été ajouté à la documentation de l'API en 2017.
9 juillet 2018
Cette mise à jour inclut les changements suivants :
-
La définition de la propriété
snippet.thumbnails
de la ressourcechannel
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 domainehttp
au lieu du domainehttps
dans une URL renvoyée dans une réponse d'API.À partir de juillet 2018, les URL des miniatures de chaînes ne seront disponibles que dans le domaine
https
, qui s'affichera ainsi dans les réponses de l'API. Passé ce délai, des images non fonctionnelles pourront s'afficher dans votre application si elle tente de charger des images YouTube à partir du domainehttp
. -
Remarque:Il s'agit d'une annonce de l'abandon.
La propriété
recordingDetails.location.altitude
de la ressourcevideo
est obsolète. Rien ne garantit que les vidéos renverront des valeurs pour cette propriété. De même, même si les requêtes API tentent de définir une valeur pour cette propriété, il est possible que les données entrantes ne soient pas stockées.
22 juin 2018
Le guide d'implémentation, anciennement "guide d'implémentation et de migration", a été mis à jour pour supprimer les instructions de migration de l'API v2 vers l'API v3. Nous avons également supprimé les instructions pour les fonctionnalités qui ont depuis été abandonnées dans l'API v3, comme les vidéos favorites.
27 novembre 2017
Cette mise à jour inclut les changements suivants :
-
Remarque:Il s'agit d'une annonce de l'abandon.
YouTube ne prendra plus en charge les fonctionnalités Sélection vidéo et Site Web sélectionné, qui sont compatibles avec l'API via l'objet
invideoPromotion
de la ressourcechannel
. Par conséquent, cet objet, y compris toutes ses propriétés enfants, est obsolète.Vous pouvez récupérer et définir des données
invideoPromotion
jusqu'au 14 décembre 2017. Après cette date :- Les tentatives de récupération de la partie
invideoPromotion
lors de l'appel dechannels.list
renvoient uneinvideoPromotion
vide ou ne renvoient aucune donnéeinvideoPromotion
. - Les tentatives de mise à jour des données
invideoPromotion
lors de l'appel dechannels.update
renvoient une réponse positive jusqu'au 27 mai 2018 au moins, mais elles sont traitées comme des opérations no-ops, ce qui signifie qu'elles n'effectueront aucune mise à jour.
Après le 27 mai 2018, il est possible que ces requêtes renvoient des messages d'erreur pour indiquer, par exemple, que
invalidPromotion
n'est pas une partie non valide. - Les tentatives de récupération de la partie
16 novembre 2017
Cette mise à jour inclut les changements suivants :
-
L'outil d'extraits de code interactif est désormais compatible avec les exemples de code Node.js. Les exemples sont également visibles dans la documentation pour presque toutes les méthodes d'API, telles que la méthode
channels.list
.Les exemples personnalisables sont conçus pour vous offrir un point de départ spécifique à un cas d'utilisation pour une application Node.js. Cette fonctionnalité est semblable au code fourni dans le guide de démarrage rapide de Node.js. Toutefois, les exemples contiennent des fonctions utilitaires qui n'apparaissent pas dans le guide de démarrage rapide:
- La fonction
removeEmptyParameters
utilise une liste de paires clé-valeur correspondant aux paramètres de requête de l'API et supprime les paramètres sans valeur. - La fonction
createResource
utilise une liste de paires clé/valeur correspondant aux propriétés d'une ressource d'API. Il convertit ensuite les propriétés en un objet JSON pouvant être utilisé dans les opérationsinsert
etupdate
. L'exemple ci-dessous montre un ensemble de noms et de valeurs de propriétés, ainsi que l'objet JSON que le code créerait pour ces propriétés :# Key-value pairs: {'id': 'ABC123', 'snippet.title': 'Resource title', 'snippet.description': 'Resource description', 'status.privacyStatus': 'private'} # JSON object: { 'id': 'ABC123', 'snippet': { 'title': 'Resource title', 'description': 'Resource description', }, 'status': { 'privacyStatus': 'private' } }
Tous ces exemples sont conçus pour être téléchargés et exécutés localement. Pour en savoir plus, consultez les conditions préalables à l'exécution d'exemples de code complets en local dans les instructions de l'outil d'extraits de code.
- La fonction
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
etgoogle-auth-oauthlib
au lieu de la bibliothèqueoauth2client
, qui est désormais obsolète.En plus de ce changement, l'outil fournit désormais des exemples de code complets pour les applications Python installées et les applications de serveur Web Python, qui utilisent des flux d'autorisation légèrement différents. Pour afficher les exemples complets (et cette modification):
- Accédez à l'outil d'extraits de code interactif ou à la documentation d'une méthode d'API, telle que
channels.list
. - Cliquez sur l'onglet
Python
au-dessus des exemples de code. - Cliquez sur le bouton d'activation au-dessus des onglets pour passer d'un extrait à un extrait complet.
- L'onglet devrait maintenant afficher un exemple de code complet utilisant le flux d'autorisation
InstalledAppFlow
. La description au-dessus de l'exemple explique cela et renvoie vers un exemple d'application de serveur Web. - Cliquez sur le lien pour basculer vers l'exemple de serveur Web. Cet exemple utilise le framework d'application Web Flask et un flux d'autorisation différent.
Tous ces exemples sont conçus pour être téléchargés et exécutés localement. Si vous souhaitez exécuter les exemples, consultez les instructions de l'outil d'extraits de code pour exécuter des exemples de code complets en local.
- Accédez à l'outil d'extraits de code interactif ou à la documentation d'une méthode d'API, telle que
29 août 2017
Cette mise à jour inclut les changements suivants :
- La définition du paramètre
forContentOwner
de la méthodesearch.list
a été mise à jour pour noter que si ce paramètre est défini surtrue
, le paramètretype
doit être défini survideo
. - La définition du paramètre
regionCode
de la méthodesearch.list
a été mise à jour pour préciser que le paramètre limite les résultats de recherche aux vidéos pouvant être regardées dans la région spécifiée. - YouTube a mis à jour ses logos et icônes de branding. Vous pouvez télécharger les nouveaux logos "développés avec YouTube" sur la page des consignes relatives à la marque. D'autres logos et icônes YouTube sont également affichés sur cette page. Vous pouvez les télécharger sur le site de la marque YouTube.
24 juillet 2017
Cette mise à jour inclut les changements suivants :
- Un nouveau guide de démarrage rapide de l'API YouTube Data est disponible pour iOS. Ce guide explique comment utiliser l'API YouTube Data dans une application iOS simple en Objective-C ou en Swift.
- L'outil d'extraits de code interactif de l'API YouTube Data inclut désormais une documentation expliquant certaines des fonctionnalités de l'outil :
- Exécuter des requêtes API
- Basculer entre les extraits de code et les exemples de code complets
- Utiliser des fonctions standards
- Chargement des ressources existantes (pour les méthodes de mise à jour)
Remarque:L'outil est également intégré dans la documentation de référence de l'API pour les méthodes d'API (exemple).
1er juin 2017
Cette mise à jour inclut les changements suivants :
-
Remarque:Il s'agit d'une annonce de l'abandon.
Les propriétés de ressource
video
suivantes vont être abandonnées. Bien que les propriétés soient prises en charge jusqu'au 1er décembre 2017, rien ne garantit que les vidéos continueront de renvoyer des valeurs pour ces propriétés jusqu'à cette date. De même, les requêtesvideos.insert
etvideos.update
qui définissent ces valeurs de propriété ne généreront pas d'erreurs avant cette date, mais il est possible que les données entrantes ne soient pas stockées.
17 mai 2017
Cette mise à jour inclut les changements suivants :
-
La documentation de référence de l'API a été mise à jour pour rendre les extraits de code plus omniprésents et interactifs. Les pages qui expliquent les méthodes d'API, telles que
channels.list
ouvideos.rate
, comportent désormais un outil interactif qui vous permet d'afficher et de personnaliser des extraits de code en Java, JavaScript, PHP, Python, Ruby, Apps Script et Go.Pour chaque méthode, l'outil affiche des extraits de code pour un ou plusieurs cas d'utilisation. Chaque cas d'utilisation décrit une méthode courante d'appel de cette méthode. Par exemple, vous pouvez appeler la méthode
channels.list
pour récupérer des données sur un canal spécifique ou sur le canal de l'utilisateur actuel.Vous pouvez également interagir avec des exemples de code:
-
Modifiez les valeurs des paramètres et des propriétés. Les extraits de code sont mis à jour de manière dynamique pour refléter les valeurs que vous fournissez.
-
Basculer entre les extraits de code et les exemples complets Un extrait de code montre la partie du code qui appelle la méthode API. Un exemple complet contient cet extrait, ainsi que du code récurrent permettant d'autoriser et d'envoyer des requêtes. Les exemples complets peuvent être copiés et exécutés à partir de la ligne de commande ou d'un serveur Web local.
-
Exécuter des requêtes en cliquant sur un bouton Pour exécuter des requêtes, vous devez autoriser l'outil à appeler l'API en votre nom.
Notez que cet outil a remplacé APIs Explorer sur les pages où il est disponible. (Chaque page affiche un lien qui vous permet également de charger la requête sur laquelle vous travaillez dans APIs Explorer.)
-
-
L'outil Extraits de code de l'API Data a également été mis à jour avec une nouvelle interface utilisateur offrant toutes les fonctionnalités décrites ci-dessus. Voici les principales nouvelles fonctionnalités disponibles sur cette page:
- Prise en charge des requêtes API qui écrivent des données.
- Prise en charge des exemples Java.
- Un code récurrent plus flexible et plus complet pour autoriser les utilisateurs et créer des requêtes API.
27 avril 2017
Cette mise à jour inclut les changements suivants :
- Les nouveaux guides de démarrage rapide expliquent comment configurer une application simple qui envoie des requêtes à l'API YouTube Data. Des guides sont actuellement disponibles pour Android, Apps Script, Go, Java, JavaScript, Node.js, PHP, Python et Ruby.
30 mars 2017
Cette mise à jour inclut les changements suivants :
- La nouvelle propriété
topicDetails.topicCategories[]
de la ressourcechannel
contient une liste d'URL Wikipédia décrivant le contenu de la chaîne. Les URL correspondent aux ID de thèmes renvoyés dans la propriététopicDetails.topicIds[]
de la ressource. - La nouvelle propriété
contentDetails.videoPublishedAt
de la ressourceplaylistItem
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 ressourcevideo
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 ressourcesvideo
, les URL correspondent aux ID des thèmes renvoyés dans la propriététopicDetails.relevantTopicIds[]
de la ressource. - La nouvelle propriété
contentDetails.contentRating.mpaatRating
de la ressourcevideo
identifie la classification que la Motion Picture Association of America a attribuée à la bande-annonce ou à l'aperçu d'un film.
27 février 2017
Comme annoncé le 11 août 2016, YouTube a remplacé la liste des ID de thèmes acceptés par une liste sélectionnée. La liste complète des ID de thèmes acceptés est incluse dans les propriétés topicDetails
des ressources channel
et video
, ainsi que dans le paramètre topicId
de la méthode search.list
.
Notez que plusieurs modifications ont été apportées à la liste sélectionnée:
- Les thèmes suivants ont été ajoutés en tant que sous-thèmes de
Society
:Nom ID du thème Entreprise /m/09s1f
Health /m/0kt51
Armée /m/01h6rj
Politique /m/05qt0
Religion /m/06bvp
- Le sujet
Animated cartoon
, qui était auparavant enfant deEntertainment
, a été supprimé. - Le sujet
Children's music
, qui était auparavant enfant deMusic
, a été supprimé.
En raison de cette modification, les thèmes liés à une vidéo sont désormais systématiquement renvoyés dans la valeur de la propriété topicDetails.relevantTopicIds[]
de la ressource video
.
29 novembre 2016
Cette mise à jour inclut les changements suivants :
-
Trois modifications mineures ont été apportées à la liste des ID de thèmes qui seront acceptés à partir du 10 février 2017:
- La catégorie
Professional wrestling
, qui était auparavant un enfant de la catégorieSports
, est désormais un enfant deEntertainment
. - La catégorie
TV shows
, enfant deEntertainment
, est nouvelle. - La catégorie
Health
, qui était auparavant un enfant deLifestyle
, a été supprimée.
Notez également qu'il existe quelques catégories parentes (
Entertainment
,Gaming
,Lifestyle
,Music
etSports
). Toute vidéo associée à une catégorie enfant, commeTennis
, sera également associée à la catégorie parente (Sports
). - La catégorie
10 novembre 2016
Cette mise à jour inclut les changements suivants :
-
Comme annoncé pour la première fois le 11 août 2016, l'abandon de Freebase et de l'API Freebase nécessite plusieurs modifications liées aux ID de thèmes. Les ID de thème identifient les thèmes associés aux ressources
channel
etvideo
. Vous pouvez également utiliser le paramètre de recherchetopicId
pour trouver des chaînes ou des vidéos en rapport avec un thème spécifique.À partir du 10 février 2017, YouTube commencera à renvoyer un petit ensemble d'ID de thèmes au lieu de l'ensemble beaucoup plus précis d'ID renvoyés jusqu'à présent. En outre, sachez qu'il n'est pas garanti que les chaînes et les vidéos soient associées à des thèmes, ce qui est cohérent avec le comportement actuel de l'API.
Pour que vous puissiez préparer vos clients API à ces modifications, les définitions des propriétés et paramètres d'API suivants ont été mises à jour afin de lister les ID de sujets qui seront pris en charge après cette date. Notez que la liste des catégories est la même pour toutes les propriétés.
- Propriété
topicDetails.topicIds[]
de la ressourcechannel
. - Propriété
topicDetails.relevantTopicIds[]
de la ressourcevideo
. - Paramètre
topicId
de la méthodesearch.list
- Propriété
-
Remarque:Il s'agit d'une annonce de l'abandon.
Les propriétés suivantes seront bientôt obsolètes:
- Propriété
topicDetails.topicIds[]
de la ressourcechannel
. Cette propriété sera acceptée jusqu'au 10 novembre 2017. - Propriété
topicDetails.relevantTopicIds[]
de la ressourcevideo
. Cette propriété sera acceptée jusqu'au 10 novembre 2017. - Propriété
topicDetails.topicIds[]
de la ressourcevideo
. Cette propriété ne contiendra aucune valeur après le 10 février 2017. Après cette date, la valeur de la propriététopicDetails.relevantTopicIds[]
identifiera tous les thèmes associés à une vidéo.
- Propriété
-
Freebase étant déjà obsolète, le guide Searching with Freebase Topics a été supprimé de la documentation. Ce guide fournissait des exemples de code illustrant le fonctionnement d'une application avec l'API Freebase.
En outre, plusieurs exemples de code liés aux ID de sujet ont été supprimés de la documentation de la méthode
search.list
.
2 novembre 2016
Cette mise à jour inclut les changements suivants :
-
Nouveaux paramètres et propriétés
-
La ressource
video
contient plusieurs nouvelles propriétés:-
La propriété
player.embedHtml
contient une balise<iframe>
que vous pouvez utiliser pour intégrer un lecteur qui lit la vidéo. Les nouvelles propriétésplayer.embedHeight
etplayer.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ètresmaxHeight
oumaxWidth
. Ces deux nouveaux paramètres sont expliqués plus loin dans cette entrée de l'historique des révisions. -
La nouvelle propriété
hasCustomThumbnail
indique si l'utilisateur ayant mis en ligne la vidéo a fourni une miniature personnalisée pour la vidéo. Notez que cette propriété n'est visible que par l'utilisateur ayant mis en ligne la vidéo. -
Le nouveau
fpbRatingReasons[]
indique les raisons pour lesquelles la vidéo a été classée FPB (Afrique du Sud). -
Le nouveau
mcstRating
indique la classification que la vidéo a reçue au Vietnam.
-
-
La méthode
videos.list
accepte deux nouveaux paramètres,maxHeight
etmaxWidth
. Vous pouvez utiliser l'un ou l'autre des paramètres ou les deux lors de la récupération de la partieplayer
dans les ressourcesvideo
.Par défaut, la hauteur de l'élément
<iframe>
renvoyé dans la propriétéplayer.embedHtml
est de 360 pixels. La largeur s'ajuste au format de la vidéo, ce qui permet de s'assurer que le lecteur intégré ne comporte pas de bandes noires encadrant la vidéo. Ainsi, si le format d'une vidéo est en 16:9, la largeur du lecteur sera de 640 pixels.Avec les nouveaux paramètres, vous pouvez indiquer que le code d'intégration doit utiliser une hauteur et/ou une largeur adaptées à la mise en page de votre application, au lieu des dimensions par défaut. Le serveur d'API adapte les dimensions du lecteur afin de s'assurer que le lecteur intégré ne comporte pas de bandes noires encadrant la vidéo. Notez que ces deux paramètres définissent les dimensions maximales du lecteur intégré. Par conséquent, si les deux paramètres sont spécifiés, il est possible qu'une dimension soit inférieure au nombre maximal autorisé pour celle-ci.
Prenons l'exemple d'une vidéo au format 16:9. Ainsi, la balise
player.embedHtml
peut contenir un lecteur de 640 x 360 pixels si le paramètremaxHeight
oumaxWidth
n'est pas défini.- Si le paramètre
maxHeight
est défini sur720
, mais que le paramètremaxWidth
n'est pas défini, l'API renvoie un lecteur de 1 280 x 720 pixels. - Si le paramètre
maxWidth
est défini sur960
, mais que le paramètremaxHeight
n'est pas défini, l'API renvoie un lecteur de 960 x 540 pixels. - Si le paramètre
maxWidth
est défini sur960
, et le paramètremaxHeight
sur450
, l'API renvoie un lecteur de 800 x 450 pixels.
Les nouvelles propriétés
player.embedHeight
etplayer.embedWidth
, décrites ci-dessus, identifient les dimensions du lecteur. - Si le paramètre
-
-
Modifications apportées aux méthodes, propriétés et paramètres existants
-
La description de la ressource
channelSection
a été mise à jour pour indiquer qu'une chaîne peut créer jusqu'à 10 sections sans définir de données de ciblage, et peut créer jusqu'à 100 sections avec des données de ciblage.De plus, la propriété
targeting
de la ressourcechannelSection
a été mise à jour pour refléter le fait que les options de ciblage ne peuvent être définies qu'à l'aide de l'API. Les options de ciblage sont supprimées si vous modifiez la section de la chaîne dans l'interface utilisateur du site YouTube. -
La définition de la propriété
snippet.name
de la ressourcei18nLanguage
a été corrigée pour refléter le fait que la valeur représente le nom d'une langue tel qu'il est écrit dans la langue spécifiée par le paramètrehl
de la méthodei18nLanguage.list
. -
La propriété
contentDetails.note
de la ressourceplaylistItem
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
etcontentDetails.endAt
de la ressourceplaylistItem
ont été abandonnées. Ces champs sont ignorés s'ils sont définis dans des requêtesplaylistItems.insert
ouplaylistItems.update
. -
Les méthodes
playlistItems.delete
etplaylistItems.update
prennent désormais en charge le paramètreonBehalfOfContentOwner
, qui est déjà compatible avec plusieurs autres méthodes. Les requêtes qui utilisent cette méthode doivent également être autorisées avec un jeton permettant d'accéder au champ d'applicationhttps://www.googleapis.com/auth/youtubepartner
. -
Les paramètres
publishedBefore
etpublishedAfter
de la méthodesearch.list
ont tous deux été mis à jour pour indiquer que les valeurs des paramètres sont inclusives. Ainsi, par exemple, si le paramètrepublishedBefore
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 ressourcevideo
accepte trois valeurs supplémentaires:grfilmK12
,grfilmK15
etgrfilmK18
. -
La description de la méthode
videos.insert
a été mise à jour pour indiquer que la taille de fichier maximale pour les vidéos importées est passée de 64 Go à 128 Go.
-
-
Nouvelles erreurs et erreurs mises à jour
-
L'API prend en charge les nouvelles erreurs suivantes:
Type d'erreur Détails de l'erreur Description forbidden (403)
homeParameterDeprecated
La méthode activities.list
renvoie cette erreur pour indiquer que les données d'activité de la page d'accueil de l'utilisateur ne sont pas disponibles via cette API. Cette erreur peut se produire si vous avez défini le paramètrehome
surtrue
dans une requête non autorisée.invalidValue (400)
invalidContentDetails
La méthode playlistItems.insert
renvoie cette erreur pour indiquer que l'objetcontentDetails
de la requête n'est pas valide. Cette erreur se produit en partie parce que le champcontentDetails.note
comporte plus de 280 caractères.forbidden (403)
watchHistoryNotAccessible
La méthode playlistItems.list
renvoie cette erreur pour indiquer que la requête a tenté de récupérer les éléments de la playlist "historique des vidéos regardées", mais ceux-ci ne peuvent pas être récupérés à l'aide de l'API.forbidden (403)
watchLaterNotAccessible
La méthode playlistItems.list
renvoie cette erreur pour indiquer que la requête a tenté de récupérer les éléments de la playlist "À regarder plus tard", mais ceux-ci ne peuvent pas être récupérés à l'aide de l'API.badRequest (400)
uploadLimitExceeded
La méthode videos.insert
renvoie cette erreur pour indiquer que la chaîne a dépassé le nombre de vidéos qu'elle peut mettre en ligne.forbidden (403)
forbiddenEmbedSetting
La méthode videos.update
renvoie cette erreur pour indiquer que la requête API tente de définir un paramètre d'intégration non valide pour la vidéo. Il est possible que certaines chaînes ne soient pas autorisées à proposer des lecteurs intégrés pour les diffusions en direct. Pour en savoir plus, consultez le Centre d'aide YouTube. -
La méthode
playlistItems.insert
ne renvoie plus d'erreur si vous insérez une vidéo en double dans une playlist. Cette erreur s'est déjà produite pour certaines playlists, comme les vidéos préférées, qui n'autorisaient pas les doublons, mais qui ne sont plus acceptées. En général, les playlists autorisent les vidéos en double.
-
-
Autres nouveautés
-
L'entrée de l'historique des révisions du 15 septembre 2016 a été mise à jour pour préciser que, chaque fois que les propriétés
contentDetails.relatedPlaylists.watchHistory
etcontentDetails.relatedPlaylists.watchLater
de la ressourcechannel
sont incluses dans une réponse, elles contiennent toujours les valeursHL
etWL
, respectivement. De plus, ces propriétés ne sont incluses que si un utilisateur autorisé récupère des données sur sa propre chaîne.
-
15 septembre 2016
Cette mise à jour inclut les changements suivants :
-
La mise à jour de l'historique des révisions du 11 août 2016 portait sur plusieurs changements liés aux ID de thèmes, y compris sur le fait que l'ensemble des ID de thèmes acceptés va changer à compter du 10 février 2017. La liste des thèmes compatibles sera publiée d'ici le 10 novembre 2016.
-
Les modifications suivantes sont désormais en vigueur. Ces modifications ont été annoncées dans la mise à jour de l'historique des révisions le 11 août 2016:
-
Si la méthode
activities.list
est appelée avec le paramètrehome
défini surtrue
, la réponse de l'API contient désormais des éléments semblables à ce qu'un utilisateur YouTube déconnecté verra sur la page d'accueil.Il s'agit d'une légère modification destinée à offrir une meilleure expérience utilisateur que le comportement décrit dans la mise à jour de l'historique des révisions du 11 août 2016. Cette mise à jour indiquait que les requêtes utilisant le paramètre
home
renvoyaient une liste vide. -
Les propriétés
contentDetails.relatedPlaylists.watchHistory
etcontentDetails.relatedPlaylists.watchLater
de la ressourcechannel
contiennent désormais les valeursHL
etWL
, respectivement, pour tous les canaux.Sachez que ces propriétés ne sont visibles que par un utilisateur autorisé qui récupère des données sur sa propre chaîne. Les propriétés contiennent toujours les valeurs
HL
etWL
, même pour un utilisateur autorisé qui récupère des données sur sa propre chaîne. Par conséquent, l'historique des vidéos regardées et l'ID de la playlist "À regarder plus tard" ne peuvent pas être récupérés via l'API.De plus, les demandes de récupération des détails d'une playlist (
playlists.list
) ou des éléments d'une playlist (playlistItems.list
) pour l'historique des vidéos regardées d'une chaîne ou la playlist "À regarder plus tard" renvoient désormais des listes vides. Ce comportement est vrai pour les nouvelles valeurs,HL
etWL
, ainsi que pour les ID de l'historique des vidéos regardées ou de la playlist "À regarder plus tard" déjà enregistrés par votre client API.
-
-
L'objet
fileDetails.recordingLocation
de la ressourcevideo
et ses propriétés enfants ne sont plus renvoyés. Auparavant, ces données (comme l'objet parentfileDetails
) ne pouvaient être récupérées que par le propriétaire de la vidéo.
11 août 2016
Cette mise à jour inclut les changements suivants :
-
Les nouvelles conditions d'utilisation des services d'API YouTube ("les Conditions mises à jour"), discutées en détail sur le blog des ingénieurs et des développeurs YouTube, incluent de nombreuses mises à jour des conditions d'utilisation actuelles. En plus des Conditions mises à jour, qui entreront en vigueur le 10 février 2017, cette mise à jour inclut plusieurs documents justificatifs expliquant les règles que les développeurs doivent respecter.
L'ensemble des nouveaux documents est décrit dans l'historique des révisions des nouvelles Conditions d'utilisation. Par ailleurs, les futures modifications apportées aux Conditions mises à jour ou à ces documents connexes seront également expliquées dans cet historique des révisions. Vous pouvez vous abonner à un flux RSS pour répertorier les modifications de cet historique de révisions à partir d'un lien dans ce document.
-
L'abandon de Freebase et de l'API Freebase entraîne plusieurs modifications liées aux ID de thèmes. Les ID de sujet sont utilisés dans les ressources et méthodes d'API suivantes:
- La partie
topicDetails
de la ressourcechannel
identifie les sujets associés à la chaîne. - La partie
topicDetails
de la ressourcevideo
identifie les sujets associés à la vidéo. - Le paramètre
topicId
de la méthodesearch.list
vous permet de rechercher des vidéos ou des chaînes en rapport avec un thème spécifique.
Voici les modifications apportées à ces fonctionnalités:
-
À compter du 10 février 2017, YouTube commencera à renvoyer un petit ensemble d'ID de thèmes au lieu de l'ensemble beaucoup plus précis d'ID obtenus jusqu'à présent. Cet ensemble de thèmes disponibles permet d'identifier des catégorisations générales telles que Sports ou Basket-ball, mais pas des équipes ou des joueurs spécifiques. Nous allons annoncer la liste des thèmes pris en charge afin que vous ayez le temps de préparer votre demande à ce changement.
-
Tous les ID de sujets Freebase que vous avez déjà récupérés peuvent être utilisés pour rechercher du contenu jusqu'au 10 février 2017. Cependant, une fois ce délai écoulé, vous ne pourrez utiliser que le plus petit ensemble de sujets identifiés au niveau de l'élément précédent pour obtenir des résultats de recherche par thème.
-
Après le 10 février 2017, si vous essayez de rechercher des résultats à l'aide d'un ID de sujet qui ne fait pas partie du plus petit ensemble d'ID de thèmes acceptés, l'API affichera un ensemble de résultats vide.
- La partie
-
Plusieurs champs et paramètres de l'API seront abandonnés à compter du 12 septembre 2016:
-
Le paramètre
home
de la méthodeactivities.list
permettait à un utilisateur autorisé de récupérer le flux d'activité qui s'afficherait sur la page d'accueil YouTube de cet utilisateur. Les requêtes qui utilisent ce paramètre après le 12 septembre 2016 renverront une liste vide. -
Seul un utilisateur autorisé peut voir les propriétés
contentDetails.relatedPlaylists.watchHistory
etcontentDetails.relatedPlaylists.watchLater
de la ressourcechannel
pour récupérer des données sur sa propre chaîne. Après le 12 septembre 2016,contentDetails.relatedPlaylists.watchHistory
affichera la valeurHL
, et la propriétécontentDetails.relatedPlaylists.watchLater
affichera une valeur deWL
pour tous les canaux.Les demandes de récupération des détails d'une playlist (
playlists.list
) pour l'historique des vidéos regardées d'une chaîne ou la playlist "À regarder plus tard" renvoient une liste vide après le 12 septembre 2016. Les requêtes de récupération des éléments d'une playlist (playlistItems.list
) dans l'une de ces playlists renvoient également une liste vide au-delà de ce délai. Cela est vrai pour les nouvelles valeurs,HL
etWL
, ainsi que pour l'historique des vidéos regardées ou l'ID de playlist "À regarder plus tard" que votre client API a peut-être déjà enregistré. -
L'objet
fileDetails.recordingLocation
de la ressourcevideo
ou l'une de ses propriétés enfants ne sera plus renvoyé après le 12 septembre 2016. Seul le propriétaire de la vidéo peut récupérer ces données, car l'objetfileDetails
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 ressourcechannel
est obsolète. Auparavant, la propriété n'était présente que si la chaîne était associée à un profil Google+. À la suite de l'abandon, la propriété ne sera plus incluse dans les ressourceschannel
. -
La propriété
snippet.authorGoogleplusProfileUrl
de la ressourcecomment
est obsolète. Auparavant, la propriété n'était présente que si la chaîne était associée à un profil Google+. À la suite de l'abandon, la propriété ne sera plus incluse dans les ressourcescomment
.
Étant donné qu'aucune de ces propriétés ne sera renvoyée après l'abandon, les deux propriétés ont été supprimées de la documentation correspondante sur les ressources.
31 mai 2016
Cette mise à jour inclut les changements suivants :
-
Le nouveau paramètre
myRecentSubscribers
de la méthodesubscriptions.list
récupère la liste des abonnés à la chaîne de l'utilisateur authentifié, dans l'ordre chronologique inverse de l'heure à laquelle ils se sont abonnés à la chaîne.Notez que le nouveau paramètre ne permet de récupérer que les 1 000 abonnés les plus récents sur la chaîne de l'utilisateur authentifié. Pour récupérer la liste complète des abonnés, utilisez le paramètre
mySubscribers
. Ce paramètre, qui ne renvoie pas les abonnés dans un ordre particulier, ne limite pas le nombre d'abonnés pouvant être récupérés. -
La définition de la propriété
snippet.thumbnails.(key)
a été mise à jour pour les ressources activity, playlistItem, playlist, résultat de recherche, vignette et vidéo pour indiquer que d'autres tailles d'image de miniature sont disponibles pour certaines vidéos.- L'image
standard
mesure 640 pixels de large et 480 pixels de haut. - L'image
maxres
mesure 1 280 pixels de large et 720 pixels de haut.
- L'image
-
La définition du paramètre
part
de la méthodechannelSection.list
a été mise à jour pour indiquer que la partietargeting
peut être récupérée au prix de2
unités de quota. -
La méthode
videos.list
renvoie désormais une erreur forbidden (403
) lorsqu'une requête mal autorisée tente de récupérer les partiesfileDetails
,processingDetails
ousuggestions
d'une ressourcevideo
. Seul le propriétaire de la vidéo a accès à ces parties.
17 mai 2016
Le nouvel outil Extraits de code de l'API Data fournit de courts extraits de code pour les cas d'utilisation courants de l'API YouTube Data. Les extraits de code sont actuellement disponibles pour toutes les méthodes d'API en lecture seule dans Apps Script, Go, JavaScript, PHP, Python et Ruby.
Pour chaque méthode, l'outil affiche des exemples de code correspondant à un ou plusieurs cas d'utilisation. Par exemple, elle fournit cinq extraits de code pour la méthode search.list
:
- Lister les vidéos par mot clé
- Lister les vidéos par lieu
- Lister les événements en direct
- Rechercher les vidéos de l'utilisateur authentifié
- Lister les vidéos similaires
Pour chaque cas d'utilisation, l'outil affiche les paramètres utilisés dans la requête API. Vous pouvez modifier les valeurs des paramètres. Dans ce cas, l'outil met à jour les extraits de code pour refléter les valeurs de paramètre que vous avez fournies.
Enfin, l'outil affiche la réponse de l'API à chaque requête. Si vous avez modifié les paramètres de requête, la réponse de l'API est basée sur les valeurs de paramètres que vous avez fournies. Notez que vous devez autoriser l'outil à envoyer des requêtes en votre nom pour que les réponses de l'API s'affichent.
28 avril 2016
Cette mise à jour inclut les changements suivants :
-
La nouvelle propriété
contentDetails.projection
de la ressourcevideo
spécifie le format de projection de la vidéo. Les valeurs de propriété valides sont360
etrectangular
. -
Les propriétés
recordingDetails.location
etfileDetails.recordingLocation
de la ressourcevideo
ont toutes deux été mises à jour pour expliquer la différence entre les deux propriétés:- La propriété
recordingDetails.location
indique le lieu que le propriétaire de la vidéo souhaite associer à celle-ci. Ce lieu peut être modifié, inclus dans l'index de recherche pour les vidéos publiques et visible par les utilisateurs dans le cas de vidéos publiques. - La valeur de la propriété
fileDetails.recordingLocation
est immuable et représente l'emplacement associé au fichier vidéo d'origine mis en ligne. Seul le propriétaire de la vidéo peut voir cette valeur.
- La propriété
-
La définition de la propriété
contentDetails.relatedPlaylists.favorites
de la ressourcechannel
a été mise à jour pour indiquer que la valeur de la propriété peut contenir un ID de playlist qui fait référence à une playlist vide et qui ne peut pas être extraite. Cela est dû au fait que la fonctionnalité des vidéos préférées a déjà été abandonnée. Notez que cette propriété n'est pas soumise au règlement relatif aux abandons de l'API. -
La définition de l'erreur
ineligibleAccount
, qui peut être renvoyée par la méthodecomments.insert
,comments.update
,commentThreads.insert
oucommentThreads.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éthodechannels.update
a été mise à jour pour indiquer quelocalizations
est également une valeur valide pour ce paramètre. -
La section Utilisation du quota du guide de démarrage a été mise à jour pour être associée à la Google Developers Console, où vous pouvez consulter votre quota réel et votre utilisation réelle.
16 mars 2016
Cette mise à jour inclut les changements suivants :
-
Mises à jour des ressources et méthodes existantes
-
La documentation sur la ressource
channelBanner
a été mise à jour pour indiquer que la taille recommandée pour l'image de la bannière de la chaîne importée est de 2 560 x 1 440 pixels. La taille minimale (2 048 x 1 152 pixels) n'a pas été modifiée. -
La nouvelle propriété
snippet.customUrl
de la ressourcechannel
identifie l'URL personnalisée associée au critère. (Certaines chaînes ne possèdent pas d'URL personnalisée.) Le Centre d'aide YouTube décrit les critères d'éligibilité à remplir pour obtenir une URL personnalisée et explique comment la configurer. -
L'objet
brandingSettings.watch
de la ressourcechannel
et toutes ses propriétés enfants ont été abandonnés. -
La réponse de l'API à une requête
search.list
contient désormais une propriétéregionCode
. La propriété identifie le code régional utilisé pour la requête de recherche. Le code de région indique à l'API de renvoyer des résultats de recherche pour le pays spécifié.La valeur de la propriété est un code pays ISO à deux lettres qui identifie la région. La méthode
i18nRegions.list
renvoie une liste des régions acceptées. La valeur par défaut estUS
. Si vous spécifiez une région non compatible, YouTube peut sélectionner une autre région, plutôt que la valeur par défaut, pour traiter la requête. -
Les définitions des propriétés
snippet.label
etsnippet.secondaryReasons[].label
de la ressourcevideoAbuseReportReason
ont été mises à jour pour indiquer que les propriétés contiennent un texte de libellé localisé pour les motifs de signalement d'abus.De plus, la méthode
videoAbuseReportReasons.list
prend désormais en charge le paramètrehl
, 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 esten_US
. -
La nouvelle propriété
contentDetails.contentRating.ecbmctRating
de la ressourcevideo
indique la classification d'une vidéo fournie par l'Autorité turque d'évaluation et de classification du ministère de la Culture et du Tourisme.En outre, les propriétés d'API des autres systèmes de classification prennent en charge les nouvelles valeurs de propriété suivantes:
contentDetails.contentRating.fpbRating
(Afrique du Sud)
Note: 10 ; valeur de l'établissement:fpb10
contentDetails.contentRating.moctwRating
(Taïwan)
Classification: R-12 ; valeur de la propriété:moctwR12
contentDetails.contentRating.moctwRating
(Taïwan)
Classification: R-15 ; valeur de la propriété:moctwR15
-
La propriété
liveStreamingDetails.activeLiveChatId
de la ressourcevideo
contient l'ID du chat en direct actif associé à la vidéo. La valeur de la propriété n'est indiquée que si la vidéo est une diffusion en direct pour laquelle le chat en direct est activé. Une fois la diffusion terminée et le chat en direct terminé, la propriété n'est plus renvoyée pour la vidéo. -
La propriété
status.rejectionReason
de la ressourcevideo
accepte la nouvelle valeur de propriétélegal
.
-
-
L'API prend en charge les nouvelles erreurs suivantes:
Type d'erreur Détails de l'erreur Description badRequest (400)
notEditable
Les méthodes channelSections.insert
,channelSections.update
etchannelSections.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
etchannelSections.update
renvoient cette erreur pour indiquer que la ressourcechannelSection
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
etchannelSections.update
renvoient cette erreur pour indiquer que la ressourcechannelSection
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 ressourcecommentThread
dans le corps de la requête pour vous assurer qu'elle est valide.forbidden (403)
commentsDisabled
La méthode commentThreads.list
renvoie cette erreur pour indiquer que les commentaires sont désactivés dans la vidéo identifiée par le paramètrevideoId
.badRequest (400)
commentTextTooLong
La méthode commentThreads.insert
renvoie cette erreur pour indiquer que la ressourcecomment
en cours d'insertion contient trop de caractères dans la propriétésnippet.topLevelComment.snippet.textOriginal
.invalidValue (400)
videoAlreadyInAnotherSeriesPlaylist
La méthode playlistItems.insert
renvoie cette erreur pour indiquer que la vidéo que vous essayez d'ajouter à la playlist se trouve déjà dans une autre playlist de séries. Pour en savoir plus sur les playlists de séries, consultez le Centre d'aide YouTube.badRequest (400)
subscriptionForbidden
La méthode subscriptions.insert
renvoie cette erreur pour indiquer que vous avez atteint le nombre maximal d'abonnements ou que vous avez créé un trop grand nombre d'abonnements récents. Dans ce dernier cas, vous pouvez réessayer d'envoyer la requête après quelques heures.badRequest (400)
invalidCategoryId
La méthode videos.update
renvoie cette erreur pour indiquer que la propriétésnippet.categoryId
de la ressourcevideo
importée a spécifié un ID de catégorie non valide. Utilisez la méthodevideoCategories.list
pour récupérer les catégories acceptées.badRequest (400)
invalidDescription
La méthode videos.update
renvoie cette erreur pour indiquer que la propriétésnippet.description
de la ressourcevideo
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 ressourcevideo
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'objetrecordingDetails
de la ressourcevideo
importée a spécifié des détails d'enregistrement non valides.badRequest (400)
invalidTags
La méthode videos.update
renvoie cette erreur pour indiquer que la propriétésnippet.tags
de la ressourcevideo
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 ressourcevideo
importée a spécifié un titre de vidéo non valide ou vide.badRequest (400)
invalidVideoMetadata
La méthode videos.update
renvoie cette erreur pour indiquer que les métadonnées de la requête ne sont pas valides. Cette erreur se produit si la requête met à jour la partiesnippet
d'une ressourcevideo
, mais ne définit pas de valeur pour les propriétéssnippet.title
etsnippet.categoryId
.
18 décembre 2015
Conformément à la législation de l'Union européenne (UE), les utilisateurs finaux de l'UE doivent divulguer certaines informations et obtenir leur autorisation. Par conséquent, si vous êtes un utilisateur final de l'Union européenne, vous devez respecter les Règles relatives au consentement de l'utilisateur dans l'UE. Nous avons ajouté une notification à ce sujet dans les Conditions d'utilisation de l'API YouTube.
19 novembre 2015
L'API permet désormais de définir et de récupérer du texte localisé pour les propriétés snippet.title
et snippet.description
des ressources playlist
et video
, la propriété snippet.title
de la ressource channelSection
et la propriété snippet.description
de la ressource channel
.
-
Définir des titres et des descriptions localisés
Vous pouvez définir des valeurs localisées pour une ressource lorsque vous appelez la méthode
insert
ouupdate
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éssnippet.title
etsnippet.description
de la ressource. Sa valeur peut correspondre à n'importe quelle langue d'application compatible ou à la plupart des autres codes de langue ISO 639-1:2002. Par exemple, si vous mettez en ligne une vidéo dont le titre et la description sont en anglais, vous devez définir la propriétésnippet.defaultLanguage
suren
.Remarque concernant la mise à jour de ressources
channel
:Pour définir la propriétésnippet.defaultLanguage
d'une ressourcechannel
, vous devez mettre à jour la propriétébrandingSettings.channel.defaultLanguage
. -
Ajoutez l'objet
localizations
à la ressource que vous mettez à jour. Chaque clé d'objet est une chaîne qui identifie une langue d'application ou un code de langue ISO 639-1:2002, et chaque clé correspond à un objet contenant le titre localisé (et la description) de la ressource.L'exemple d'extrait ci-dessous définit l'anglais comme langue par défaut de la ressource. Il ajoute également des descriptions et des titres en allemand et en espagnol localisés à une vidéo:
{ "kind": "youtube#video", ... "snippet": { "title": "Playing soccer", "description": "We play soccer in the park on Sundays.", "defaultLanguage": "en", ... }, "localizations": "de": { "title": "Fußball spielen", "description": "Wir spielen Fußball im Park am Sonntag" }, "es": { "title": "Jugar al fútbol", "description": "Nosotros jugamos fútbol en el parque los domingos", } } }
Important:N'oubliez pas que lorsque vous mettez à jour les données localisées d'une ressource, votre requête API doit inclure toutes les versions localisées existantes des données. Par exemple, si vous avez ensuite demandé l'ajout de données en portugais à la vidéo de l'exemple ci-dessus, la demande doit inclure les données localisées pour l'allemand, l'espagnol et le portugais.
-
-
Récupérer des valeurs localisées
L'API accepte deux méthodes pour récupérer des valeurs localisées pour une ressource:
-
Ajoutez le paramètre
hl
à votre requêtechannels.list
,channelSections.list
,playlists.list
ouvideos.list
afin de récupérer des données localisées pour une langue d'application spécifique compatible avec le site Web YouTube. Si les détails de la ressource localisée sont disponibles dans cette langue, l'objetsnippet.localized
de la ressource contiendra les valeurs localisées. Toutefois, si les détails localisés ne sont pas disponibles, l'objetsnippet.localized
contiendra les détails de la ressource dans la langue par défaut de la ressource.Par exemple, supposons qu'une requête
videos.list
récupère les données de la vidéo décrite ci-dessus, avec des données localisées en allemand et en espagnol. Si le paramètrehl
est défini surde
, la ressource contient les données suivantes:{ "kind": "youtube#video", ... "snippet": { "title": "Playing soccer", "description": "We play soccer in the park on Sundays.", "defaultLanguage": "en", "localized": { "title": "Fußball spielen", "description": "Wir spielen Fußball im Park am Sonntag" } ... } }
Toutefois, si le paramètre
hl
était défini surfr
, l'objetsnippet.localized
contiendrait le titre et la description en anglais, car l'anglais est la langue par défaut de la ressource et les détails localisés en français ne sont pas disponibles.Important:Le paramètrehl
n'est compatible qu'avec les valeurs qui identifient les langues d'application prises en charge par le site YouTube. Pour déterminer si du texte localisé est disponible dans d'autres langues, vous devez récupérer la partielocalizations
de la ressource et filtrer pour déterminer si le texte localisé existe.
Par exemple, vous devez récupérer la liste complète des traductions pour déterminer si le texte localisé est disponible en anglais des Appalaches.
-
Lorsque vous récupérez une ressource, incluez
localizations
dans la valeur du paramètrepart
pour récupérer tous les détails localisés de cette ressource. Si vous souhaitez récupérer des données localisées pour une langue qui n'est pas une langue d'application YouTube actuelle, vous devez utiliser cette méthode pour récupérer toutes les versions localisées, puis filtrer les données afin de déterminer si les données localisées souhaitées existent.
-
-
Erreurs liées aux valeurs de texte localisé
L'API accepte également les nouvelles erreurs suivantes pour les valeurs de texte localisé:
Type d'erreur Détails de l'erreur Description badRequest (400)
defaultLanguageNotSetError
Cette erreur indique qu'une requête qui tente d'insérer ou de mettre à jour l'objet localizations
d'une ressource échoue, car la propriétésnippet.defaultLanguage
n'est pas définie pour cette ressource. Les méthodeschannels.update
,channelSections.insert
,channelSections.update
,playlists.insert
,playlists.update
,videos.insert
etvideos.update
acceptent cette erreur.badRequest (400)
localizationValidationError
Cette erreur indique que la validation de l'une des valeurs de l'objet localizations
d'une ressource a échoué. Par exemple, cette erreur peut se produire si l'objet contient un code de langue incorrect. Les méthodeschannels.update
,channelSections.insert
,channelSections.update
,playlists.insert
etplaylists.update
acceptent cette erreur.
4 novembre 2015
Cette mise à jour inclut les changements suivants :
-
Mises à jour des ressources et méthodes existantes
-
Le paramètre
order
de la méthodesearch.list
a été mis à jour pour indiquer que si vous triez les diffusions en direct parviewCount
, les résultats de l'API sont triés en fonction du nombre de spectateurs simultanés des diffusions, alors que celles-ci sont toujours en cours. -
Le paramètre
relatedToVideoId
de la méthodesearch.list
a été mis à jour pour indiquer que si le paramètre est défini, les seuls autres paramètres acceptés sontpart
,maxResults
,pageToken
,regionCode
,relevanceLanguage
,safeSearch
,type
(qui doit être défini survideo
) etfields
. Cette mise à jour ne reflète pas un changement de comportement de l'API. -
La définition de la propriété
snippet.publishedAt
de la ressourcevideo
a été mise à jour pour indiquer que la valeur de la propriété, qui spécifie la date et l'heure de publication de la vidéo, peut être différente de l'heure de mise en ligne. Par exemple, si une vidéo est mise en ligne en tant que vidéo privée, puis rendue publique par la suite, la valeur de la propriété indique l'heure à laquelle elle a été rendue publique. La nouvelle définition explique également comment cette valeur est renseignée pour les vidéos privées et non répertoriées.Cette modification ne reflète pas un changement de comportement de l'API.
-
La définition de la propriété
status.publishAt
de la ressourcevideo
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
surprivate
, même si la vidéo est déjà privée. - Si la demande planifie la publication d'une vidéo par le passé, elle est publiée immédiatement. Par conséquent, le fait de définir la propriété
status.publishAt
sur une date et une heure dans le passé est le même que de faire passer l'privacyStatus
de la vidéo deprivate
àpublic
.
- Si vous définissez la valeur de cette propriété lorsque vous appelez la méthode
-
La propriété
contentDetails.contentRating.cncRating
de la ressourcevideo
spécifie la note de la vidéo fournie par la Commission de classification cinématographique française. Cette propriété remplace la propriétécontentDetails.contentRating.fmocRating
, qui est désormais obsolète. -
La définition du paramètre brandingSettings.channel.keywords de la ressource
channel
a été mise à jour pour indiquer correctement que la valeur de la propriété contient une liste de chaînes séparées par des espaces et non une liste d'éléments séparés par une virgule, comme indiqué précédemment. Cette mise à jour ne reflète pas un changement de comportement de l'API. -
La documentation de la méthode
thumbnails.set
a été mise à jour pour indiquer précisément que le corps de la requête contient l'image miniature que vous importez et associez à une vidéo. Le corps de la requête ne contient pas de ressourcethumbnail
. Auparavant, la documentation indiquait qu'il ne fallait pas fournir de corps de requête lorsque vous appelez cette méthode. Cette mise à jour ne reflète pas un changement de comportement de l'API. -
La description de la ressource
activity
a été mise à jour pour tenir compte du fait que la méthodeactivities.list
n'inclut actuellement aucune ressource liée aux nouveaux commentaires sur une vidéo. Les champssnippet.type
etcontentDetails.comment
de la ressource ont également été mis à jour.
-
-
Nouvelles erreurs et erreurs mises à jour
-
L'API accepte désormais les erreurs suivantes:
Informations sur l'erreur activities.insert
Code de réponse HTTP badRequest (400)
Motif invalidMetadata
Description La propriété kind
ne correspond pas au type d'ID fourni.commentThreads.update
comments.insert
comments.update
Code de réponse HTTP badRequest (400)
Motif commentTextTooLong
Description La ressource comment
en cours d'insertion ou de mise à jour contient trop de caractères dans la propriétésnippet.topLevelComment.snippet.textOriginal
.playlistItems.insert
playlistItems.update
Code de réponse HTTP forbidden (403)
Motif playlistItemsNotAccessible
Description La 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 HTTP badRequest (400)
Motif playlistForbidden
Description Cette opération est interdite ou la requête n'est pas correctement autorisée. search.list
Code de réponse HTTP badRequest (400)
Motif invalidLocation
Description Le format des valeurs des paramètres location
et/oulocationRadius
n'est pas valide.search.list
Code de réponse HTTP badRequest (400)
Motif invalidRelevanceLanguage
Description Le format de la valeur du paramètre relevanceLanguage
est incorrect.subscriptions.insert
Code de réponse HTTP badRequest (400)
Motif subscriptionForbidden
Description Cette erreur se produit lorsque l'une des conditions suivantes est remplie: - L'abonnement que vous essayez de créer existe déjà
- Vous avez déjà atteint le nombre maximal d'abonnements autorisé
- Vous essayez de vous abonner à votre propre chaîne, mais ce n'est pas possible.
- Vous avez créé trop d'abonnements récemment et devez attendre quelques heures avant de réessayer d'envoyer la demande.
videos.update
Code de réponse HTTP badRequest (400)
Motif invalidDefaultBroadcastPrivacySetting
Description La 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 ressourcevideo
est obsolète.Conformément à notre règlement relatif aux abandons, cette propriété continuera d'être incluse dans les ressources
video
pendant au moins un an après cette annonce. Cependant, la valeur de la propriété est désormais toujours définie sur0
.
-
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 ressourcevideo
a été mise à jour pour fournir plus d'informations sur la manière dont le serveur d'API calcule la longueur de la valeur de la propriété. Notez que cette mise à jour ne reflète pas un changement du comportement de l'API.Plus précisément, la définition explique maintenant que si un tag contient un espace, le serveur d'API traite la valeur du tag comme si elle était entre guillemets, lesquels sont comptabilisés dans le nombre maximal de caractères. Ainsi, dans le cadre de la limitation du nombre de caractères, le tag Foo-Baz contient sept caractères, mais le tag Foo-Baz en contient neuf.
-
La méthode
commentThreads.insert
n'accepte plus le paramètreshareOnGooglePlus
, qui indiquait précédemment si un commentaire et ses réponses devaient également être publiés sur le profil Google+ de l'auteur. Si une requête envoie le paramètre, le serveur d'API l'ignore, mais le gère autrement.
-
18 juin 2015
Cette mise à jour inclut les changements suivants :
-
Mises à jour des ressources et méthodes existantes
-
Le nouveau paramètre
order
de la méthodecommentThreads.list
spécifie l'ordre dans lequel la réponse de l'API doit répertorier les fils de commentaires. Les fils de discussion peuvent être classés par date ou par pertinence. Le comportement par défaut consiste à les classer par heure. -
La nouvelle propriété
snippet.defaultAudioLanguage
de la ressourcevideo
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 ressourcevideo
a été modifiée pour préciser que le contenu doit avoir été initialement mis en ligne sur une chaîne associée à un partenaire de contenus YouTube, puis revendiqué par ce partenaire. Cela ne reflète pas un changement du comportement réel de l'API. -
Les méthodes
captions.delete
,captions.download
,captions.insert
,captions.list
etcaptions.update
acceptent désormais le paramètreonBehalfOfContentOwner
, qui est déjà compatible avec plusieurs autres méthodes. Les requêtes qui utilisent cette méthode doivent également être autorisées avec un jeton permettant d'accéder au champ d'applicationhttps://www.googleapis.com/auth/youtubepartner
.
-
-
Nouvelles erreurs et erreurs mises à jour
-
L'API accepte désormais les erreurs suivantes:
Informations sur l'erreur videos.rate
Code de réponse HTTP badRequest (400)
Motif emailNotVerified
Description L'utilisateur doit valider son adresse e-mail avant de donner son avis sur la vidéo. videos.rate
Code de réponse HTTP badRequest (400)
Motif videoPurchaseRequired
Description Les vidéos en location ne peuvent être évaluées que par les utilisateurs qui les ont louées. -
Les méthodes
subscriptions.delete
etsubscriptions.insert
ne sont plus compatibles avec les erreursaccountClosed
etaccountSuspended
.
-
27 avril 2015
Cette mise à jour inclut les changements suivants :
-
Nouvelles ressources et méthodes
-
La nouvelle ressource
videoAbuseReportReason
contient des informations sur les raisons pour lesquelles une vidéo peut être signalée comme présentant du contenu abusif. La méthodevideoAbuseReportReasons.list
vous permet de récupérer la liste de toutes les raisons pour lesquelles des vidéos peuvent être signalées. -
La nouvelle méthode
videos.reportAbuse
permet de signaler une vidéo comportant du contenu abusif. Le corps de la demande contient un objet JSON qui précise la vidéo signalée et la raison pour laquelle elle est considérée comme présentant du contenu abusif. Pour obtenir des raisons valables, vous pouvez utiliser la méthodevideoAbuseReportReason.list
décrite ci-dessus.Le guide de migration contient également un exemple permettant de signaler une vidéo abusive. Avec ce changement, la version 3 de l'API est désormais compatible avec toutes les fonctionnalités de la version 2 qui devraient lui être prises en charge. Ces fonctionnalités sont également expliquées dans le guide de migration.
-
-
Mises à jour des ressources et méthodes existantes
-
Le nouveau paramètre de filtre
forDeveloper
de la méthodesearch.list
limite une recherche pour ne récupérer que les vidéos mises en ligne via l'application ou le site Web du développeur. Le paramètreforDeveloper
peut être utilisé avec des paramètres de recherche facultatifs tels que le paramètreq
.Pour cette fonctionnalité, chaque vidéo mise en ligne est automatiquement taguée avec le numéro de projet associé à l'application du développeur dans la Google Play Console.
Lorsqu'une requête de recherche définit ensuite le paramètre
forDeveloper
surtrue
, le serveur d'API utilise les identifiants d'autorisation de la requête pour identifier le développeur. Par conséquent, un développeur peut limiter les résultats aux vidéos mises en ligne via son application ou son propre site Web, mais pas aux vidéos mises en ligne via d'autres applications ou sites.Cette nouvelle fonctionnalité est semblable, bien que pas identique, aux balises de développeur compatibles avec la version 2 de l'API.
-
La nouvelle propriété
snippet.country
de la ressourcechannel
permet aux propriétaires de chaînes d'associer leurs chaînes à un pays spécifique.Remarque:Pour définir la propriété
snippet.country
pour une ressourcechannel
, vous devez mettre à jour la propriétébrandingSettings.channel.country
. -
L'API prend désormais en charge le ciblage des ressources
channelSection
. Le ciblage d'une section de chaîne permet de restreindre la visibilité d'une section de contenu aux utilisateurs répondant à certains critères.L'API propose trois options de ciblage. Pour être visible, un utilisateur doit remplir tous les paramètres de ciblage pour qu'une section de chaîne soit visible.
-
targeting.languages[]
: liste des langues pour les applications YouTube Les utilisateurs qui ont choisi l'une de ces langues peuvent voir la section de chaîne correspondante. -
targeting.regions[]
: liste des régions de contenus YouTube Preferred. Les utilisateurs ayant sélectionné l'une de ces régions peuvent voir la section de la chaîne, ainsi que ceux pour lesquels l'une de ces régions est automatiquement sélectionnée. -
targeting.countries[]
: liste des pays dans lesquels la section de chaîne est visible. Chaque valeur de la liste est un code pays ISO 3166-1 alpha-2.
-
-
La définition de la propriété
contentDetails.duration
de la ressourcevideo
a été corrigée pour refléter le fait que la valeur peut refléter les heures, les jours, etc. -
La documentation de la méthode
channelSections.delete
,playlistItems.delete
,playlists.delete
,subscriptions.delete
etvideos.delete
a été corrigée pour refléter le fait que, lorsque l'opération réussit, ces méthodes renvoient toutes un code de réponse HTTP204
(No Content
).
-
-
Nouvelles erreurs et erreurs mises à jour
-
L'API accepte désormais les erreurs suivantes:
Type d'erreur Détails de l'erreur Description badRequest (400)
targetInvalidCountry
Les méthodes channelSections.insert
etchannelSections.update
renvoient cette erreur si la ressourcechannelSection
insérée contient une valeur non valide pour la propriététargeting.countries[]
.badRequest (400)
targetInvalidLanguage
Les méthodes channelSections.insert
etchannelSections.update
renvoient cette erreur si la ressourcechannelSection
insérée contient une valeur non valide pour la propriététargeting.languages[]
.badRequest (400)
targetInvalidRegion
Les méthodes channelSections.insert
etchannelSections.update
renvoient cette erreur si la ressourcechannelSection
insérée contient une valeur non valide pour la propriététargeting.regions[]
.badRequest (400)
operationNotSupported
La méthode comments.insert
renvoie cette erreur si l'utilisateur de l'API n'est pas en mesure d'insérer un commentaire en réponse au commentaire de premier niveau identifié par la propriétésnippet.parentId
. Dans une ressourcecommentThread
, la propriétésnippet.canReply
indique si le lecteur actuel peut répondre au fil de discussion.badRequest (400)
invalidChannelId
La méthode search.list
renvoie cette erreur si le paramètrechannelId
de la requête spécifie un ID de chaîne non valide.badRequest (400)
subscriptionForbidden
La méthode subscriptions.insert
renvoie cette erreur si l'utilisateur de l'API tente de s'abonner à sa propre chaîne. -
La méthode
captions.update
n'est plus compatible avec les erreursinvalidMetadata
etvideoNotFound
.
-
16 avril 2015
Cette mise à jour inclut les changements suivants :
-
Le guide de migration a été mis à jour pour expliquer comment migrer des applications qui utilisent encore la fonctionnalité de commentaires de la version 2 de l'API.
Il décrit également plusieurs fonctionnalités de commentaires non compatibles avec la version 2 de l'API, mais qui sont compatibles avec la version 3 de l'API. En voici quelques-unes :
- Récupérer des commentaires à propos d'une chaîne
- Récupérer tous les fils de commentaires associés à une chaîne, ce qui signifie que la réponse de l'API peut contenir des commentaires sur la chaîne ou l'une de ses vidéos.
- Mettre à jour le texte d'un commentaire
- Marquer un commentaire comme spam
- Définir l'état de modération d'un commentaire
-
Le guide S'abonner aux notifications push a été mis à jour pour tenir compte du fait que les notifications ne sont envoyées qu'au hub Google PubSubHubBub, et non au hub Superfeedr, comme indiqué précédemment.
9 avril 2015
Cette mise à jour inclut les changements suivants :
-
Les nouvelles ressources
commentThread
etcomment
de l'API vous permettent de récupérer, d'insérer, de mettre à jour, de supprimer et de modérer des commentaires.-
Une ressource
commentThread
contient des informations sur un fil de commentaires YouTube, qui comprend un commentaire de premier niveau et, le cas échéant, des réponses à ce commentaire. Une ressourcecommentThread
peut représenter des commentaires sur une vidéo ou une chaîne.Le commentaire de premier niveau et les réponses sont en réalité des ressources
comment
imbriquées dans la ressourcecommentThread
. Il est important de noter que la ressourcecommentThread
ne contient pas nécessairement toutes les réponses à un commentaire. Vous devez utiliser la méthodecomments.list
si vous souhaitez récupérer toutes les réponses à un commentaire particulier. En outre, certains commentaires n'ont pas de réponse.L'API est compatible avec les méthodes suivantes pour les ressources
commentThread
:commentThreads.list
: récupère une liste des fils de commentaires. Utilisez cette méthode pour récupérer les commentaires associés à une vidéo ou à une chaîne spécifique.commentThreads.insert
: créer un commentaire de premier niveau (Utilisez la méthodecomments.insert
pour répondre à un commentaire existant.)commentThreads.update
: permet de modifier un commentaire principal.
-
Une ressource
comment
contient des informations sur un seul commentaire YouTube. Une ressourcecomment
peut représenter un commentaire sur une vidéo ou une chaîne. Il peut également s'agir d'un commentaire de premier niveau ou d'une réponse à un commentaire de premier niveau.L'API est compatible avec les méthodes suivantes pour les ressources
comment
:comments.list
: récupère une liste de commentaires. Utilisez cette méthode pour récupérer toutes les réponses à un commentaire particulier.comments.insert
: permet de créer une réponse à un commentaire existant.comments.update
: permet de modifier un commentaire.comments.markAsSpam
: permet de signaler un ou plusieurs commentaires comme spam.comments.setModerationStatus
: permet de définir l'état de modération d'un ou de plusieurs commentaires. Par exemple, effacez un commentaire pour l'afficher publiquement ou refusez un commentaire comme inadapté à l'affichage. La requête API doit être autorisée par le propriétaire de la chaîne ou de la vidéo associée aux commentaires.comments.delete
: supprimer un commentaire.
Notez que le nouveau champ d'application
https://www.googleapis.com/auth/youtube.force-ssl
de l'API, décrit dans l'historique des révisions du 2 avril 2015, est obligatoire pour les appels aux méthodescomments.insert
,comments.update
,comments.markAsSpam
,comments.setModerationStatus
,comments.delete
,commentThreads.insert
etcommentThreads.update
. -
-
Le nouveau guide S'abonner aux notifications push explique que l'API accepte désormais les notifications push via PubSubHubBub, un protocole de publication et d'abonnement de serveur à serveur pour les ressources accessibles sur le Web. Votre serveur de rappel PubSubHubBub peut recevoir des notifications de flux Atom lorsqu'un canal effectue l'une des activités suivantes:
- met en ligne une vidéo
- modifie le titre d'une vidéo
- modifie la description d'une vidéo
-
Le guide de migration a également été mis à jour pour tenir compte de la prise en charge des notifications push. Toutefois, la version 2 de l'API prenant en charge de nombreux autres types de notifications push non compatibles avec la version 3, la mention de la compatibilité avec PubSubHubBub reste indiquée dans la section Obsolète de ce guide.
-
Le nouveau champ d'application
https://www.googleapis.com/auth/youtube.force-ssl
de l'API est désormais un champ d'application valide pour toute méthode d'API qui prenait auparavant en charge le champ d'applicationhttps://www.googleapis.com/auth/youtube
. -
L'API accepte désormais les erreurs suivantes:
Type d'erreur Détails de l'erreur Description badRequest (400)
invalidRating
La méthode videos.rate
renvoie cette erreur si la requête contient une valeur inattendue pour le paramètrerating
. -
La méthode
subscriptions.insert
n'est plus compatible avec l'erreursubscriptionLimitExceeded
, qui indiquait précédemment que l'abonné identifié à la requête avait dépassé la limite du nombre d'abonnements.
2 avril 2015
Cette mise à jour inclut les changements suivants :
-
La nouvelle ressource
captions
représente une piste de sous-titres YouTube. Une piste de sous-titres est associée à une seule vidéo YouTube.L'API est compatible avec les méthodes permettant de lister, insérer, mettre à jour, télécharger et supprimer des pistes de sous-titres.
-
Le guide de migration a également été mis à jour pour expliquer comment migrer les applications qui utilisent encore la fonctionnalité de sous-titrage dans la version 2 de l'API.
-
Le nouveau champ d'application
https://www.googleapis.com/auth/youtube.force-ssl
de l'API nécessite une communication avec le serveur d'API via une connexion SSL.Ce nouveau champ d'application accorde le même accès que le champ d'application
https://www.googleapis.com/auth/youtube
. D'un point de vue fonctionnel, ces deux champs d'application sont identiques, car le serveur d'API YouTube n'est disponible que via un point de terminaison HTTPS. Par conséquent, même si le champ d'applicationhttps://www.googleapis.com/auth/youtube
ne nécessite pas de connexion SSL, il n'existe en réalité aucun autre moyen d'envoyer une requête API.Le nouveau champ d'application est requis pour les appels à toutes les méthodes de la ressource
caption
.
11 mars 2015
Cette mise à jour inclut les changements suivants :
-
Le guide de migration de l'API YouTube Data (v3) contient un nouvel onglet, intitulé Nouveauté de la version 3 de l'API, qui liste les fonctionnalités compatibles avec la version 3 de l'API, mais pas celles de la version 2. Les mêmes fonctionnalités étaient auparavant disponibles et sont toujours répertoriées dans d'autres onglets du guide. Par exemple, la nouvelle fonctionnalité expliquant comment mettre à jour les données des campagnes promotionnelles dans des vidéos d'une chaîne est également disponible dans l'onglet Chaînes (profils).
-
Le guide de migration de l'API YouTube Data (v3) a été mis à jour pour indiquer que la version 3 de l'API est compatible avec les fonctionnalités suivantes de l'API v2:
-
Le guide de migration de l'API YouTube Data (v3) a été mis à jour pour indiquer que les fonctionnalités suivantes de la version 2 de l'API ne seront pas compatibles avec la version 3:
-
Récupérer les recommandations de vidéos : la version 3 de l'API ne récupère pas de liste contenant uniquement les vidéos recommandées pour l'utilisateur actuel de l'API. Toutefois, vous pouvez utiliser la version 3 de l'API pour trouver des vidéos recommandées en appelant la méthode
activities.list
et en définissant la valeur du paramètrehome
surtrue
.Dans la réponse de l'API, une ressource correspond à une vidéo recommandée si la valeur de la propriété
snippet.type
estrecommendation
. Dans ce cas, les propriétéscontentDetails.recommendation.reason
etcontentDetails.recommendation.seedResourceId
contiennent des informations expliquant pourquoi la vidéo a été recommandée. Notez que nous ne pouvons pas garantir que la réponse contiendra un nombre spécifique de vidéos recommandées. -
Récupérer de nouvelles vidéos d'abonnement : la version 3 de l'API ne récupère pas de liste contenant uniquement les vidéos récemment mises en ligne sur des chaînes auxquelles l'utilisateur de l'API est abonné. Toutefois, vous pouvez utiliser la version 3 de l'API pour rechercher de nouvelles vidéos sur abonnement en appelant la méthode
activities.list
et en définissant la valeur du paramètrehome
surtrue
.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
estupload
. Notez que nous ne pouvons pas garantir que la réponse contiendra un nombre spécifique de nouvelles vidéos disponibles sur abonnement. -
Notifications push pour les mises à jour de flux : la version 2 de l'API prend en charge les notifications push, à l'aide du protocole SUP (Simple Update Protocol) ou de PubSubHubbub, pour surveiller les flux d'activité des utilisateurs de YouTube. Des notifications ont été envoyées pour les nouveaux abonnements à des chaînes et pour les vidéos notées, partagées, marquées comme favorites, commentées ou mises en ligne.
L'API v3 prendra en charge les notifications push à l'aide du protocole PubSubHubbub, mais celles-ci ne couvriront que les mises en ligne de vidéos et les mises à jour des titres ou descriptions des vidéos.
-
Emplacement de la chaîne : la version 2 de l'API utilisait la balise
<yt:location>
pour identifier la situation géographique de l'utilisateur, telle que saisie dans le profil public YouTube de la chaîne. Certains développeurs utilisaient ce champ pour associer un canal à un pays en particulier, mais ses données n'ont pas pu être utilisées de façon cohérente à cette fin. -
Définir ou récupérer des tags de développeur : la version 2 de l'API permettait d'associer des mots clés, ou tags de développeur, à une vidéo au moment de sa mise en ligne. Les tags de développeur ne sont pas visibles par les utilisateurs YouTube, mais les propriétaires de vidéos peuvent récupérer les vidéos correspondant à un tag de développeur spécifique.
La version 3 de l'API fournira une fonctionnalité similaire, mais pas identique. Plus précisément, un développeur pourra rechercher des vidéos mises en ligne par sa propre application. Pour cette fonctionnalité, chaque vidéo mise en ligne est automatiquement taguée avec le numéro de projet associé à l'application du développeur dans la Google Play Console. Le développeur utilise ensuite le même numéro de projet pour rechercher des vidéos.
-
Lister les vidéos par date de publication, nombre de vues ou note : dans la version 2 de l'API, le paramètre
orderby
vous permet de trier les vidéos d'une playlist par position, durée, date de publication, titre et plusieurs autres valeurs. Dans la version 3 de l'API, les éléments de la playlist sont généralement triés par position dans l'ordre croissant, et les autres options de tri ne sont pas disponibles.Il existe quelques exceptions. Une nouvelle vidéo mise en ligne, une vidéo favorite, une vidéo "J'aime" ou une vidéo visionnée récemment est automatiquement ajoutée en tant que premier élément (
snippet.position
=0
) pour les types de playlists suivants. Chacune de ces listes est donc triée de l'élément le plus récent au plus ancien, en fonction de l'heure à laquelle les éléments ont été ajoutés à la liste.- importations par des utilisateurs
- vidéos favorites
- vidéos "J'aime"
- historique des vidéos regardées
Notez toutefois qu'un nouvel élément ajouté à la playlist "À regarder plus tard" est le dernier élément de la liste, de sorte qu'elle est triée du plus ancien au plus récent.
-
Traitement par lot : la version 3 de l'API est compatible avec l'un des cas d'utilisation du traitement par lot compatibles avec la version 2. Les méthodes
channels.list
,channelSections.list
,guideCategories.list
,playlistItems.list
,playlists.list
,subscriptions.list
,videoCategories.list
etvideos.list
de l'API v3 acceptent toutes un paramètreid
, qui peut être utilisé pour spécifier une liste d'ID séparés par une virgule (ID vidéo, ID de chaîne, etc.). Ces méthodes vous permettent de récupérer une liste de plusieurs ressources en une seule requête.
Grâce à ces modifications, le guide identifie toutes les fonctionnalités compatibles avec l'ancienne API (v2) qui seront abandonnées dans la version actuelle de l'API (v3).
-
4 mars 2015
Cette mise à jour inclut les changements suivants :
-
Les méthodes
channelSections.delete
etchannelSections.update
prennent désormais en charge le paramètreonBehalfOfContentOwner
, 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 ressourcevideo
identifie les raisons pour lesquelles la vidéo a été classée par le DJCQT (Brésil). -
L'API accepte désormais les erreurs suivantes:
Type d'erreur Détails de l'erreur Description notFound (404)
channelNotFound
La méthode channels.update
renvoie cette erreur si le paramètreid
de la requête spécifie un canal introuvable.badRequest (400)
manualSortRequiredinvalidValue
Les méthodes playlistItems.insert
etplaylistItems.update
renvoient cette erreur si la requête tente de définir la position de l'élément de la playlist, mais que la playlist n'utilise pas le tri manuel. Par exemple, les éléments d'une playlist peuvent être triés par date ou par popularité. Vous pouvez corriger cette erreur en supprimant l'élémentsnippet.position
de la ressource envoyée dans le corps de la requête. Si vous souhaitez que l'élément de la playlist occupe une position spécifique dans la liste, vous devez d'abord définir le paramètre d'ordre de lecture sur Manuel. Vous pouvez modifier ce paramètre dans le Gestionnaire de vidéos YouTube.forbidden (403)
channelClosed
La méthode playlists.list
renvoie cette erreur si le paramètrechannelId
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ètrechannelId
de la requête spécifie un canal suspendu.forbidden (403)
playlistForbidden
La méthode playlists.list
renvoie cette erreur si le paramètreid
de la requête n'est pas compatible avec la requête ou si celle-ci n'est pas autorisée correctement.notFound (404)
channelNotFound
La méthode playlists.list
renvoie cette erreur si le paramètrechannelId
de la requête spécifie un canal introuvable.notFound (404)
playlistNotFound
La méthode playlists.list
renvoie cette erreur si le paramètreid
de la requête spécifie une playlist introuvable.notFound (404)
videoNotFound
La méthode videos.list
renvoie cette erreur si le paramètreid
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ètrerating
.
2 mars 2015
Cette mise à jour inclut les changements suivants :
-
La méthode
search.list
prend désormais en charge le paramètrerelevanceLanguage
, qui vous permet de demander les résultats les plus pertinents pour une langue donnée.Le guide de migration de l'API YouTube Data (v3) a également été mis à jour pour expliquer comment utiliser ce nouveau paramètre. Le paramètre comble une lacune qui existait auparavant entre la version actuelle de l'API (v3) et la version précédente (v2), qui est déjà obsolète.
-
Le guide de migration de l'API YouTube Data (v3) a également été mis à jour pour indiquer l'abandon des flux spéciaux et champs de métadonnées fournis par la version 2 de l'API pour décrire des films, des bandes-annonces, des émissions, des saisons et des épisodes de séries TV.
14 janvier 2015
Cette mise à jour inclut les changements suivants :
-
Le guide de migration de l'API YouTube Data (v3) a été mis à jour pour expliquer comment utiliser la version 3 pour mettre en ligne des vidéos via JavaScript. Pour en savoir plus, consultez la section Mettre en ligne une vidéo. Cette fonctionnalité est comparable à la fonctionnalité d'importation via le navigateur compatible avec la version 2 de l'API. Notez que cette modification du guide de migration ne reflète pas une modification réelle de l'API, mais la disponibilité d'un nouvel exemple de code permettant d'importer des vidéos avec JavaScript côté client.
Étant donné qu'il était possible d'importer des vidéos à l'aide de la bibliothèque cliente JavaScript et de CORS, le guide de migration ne mentionne plus la fonctionnalité d'importation via un navigateur qui pourrait être abandonnée dans la version 3 de l'API.
-
La documentation de la méthode
videos.insert
a été mise à jour pour inclure le nouvel exemple de code JavaScript décrit ci-dessus. La liste des exemples de code JavaScript pour l'API YouTube Data (v3) a également été mise à jour.
11 novembre 2014
Cette mise à jour inclut les changements suivants :
-
Le coût du quota d'un appel de la méthode
search.list
est passé à 100 unités.Important:Dans de nombreux cas, vous pouvez utiliser d'autres méthodes d'API pour récupérer des informations à moindre coût. Examinons par exemple les deux méthodes ci-dessous pour trouver des vidéos mises en ligne sur la chaîne GoogleDevelopers.
-
Coût du quota: 100 unités
Appelez la méthode
search.list
et recherchezGoogleDevelopers
. -
Coût du quota: 6 unités
Appelez la méthode
channels.list
pour trouver l'ID de chaîne approprié. Définissez le paramètreforUsername
surGoogleDevelopers
et le paramètrepart
surcontentDetails
. Dans la réponse de l'API, la propriétécontentDetails.relatedPlaylists.uploads
spécifie l'ID de playlist des vidéos mises en ligne par la chaîne.Appelez ensuite la méthode
playlistItems.list
et définissez le paramètreplaylistId
sur l'ID capturé et le paramètrepart
sursnippet
.
-
8 octobre 2014
Cette mise à jour inclut les changements suivants :
-
La ressource
channel
contient deux nouvelles propriétés:-
La propriété
status.longUploadsStatus
indique si la chaîne peut mettre en ligne des vidéos de plus de 15 minutes. Cette propriété n'est renvoyée que si le propriétaire de la chaîne a autorisé la requête API. Les valeurs de propriété valides sont les suivantes:allowed
: la chaîne peut mettre en ligne des vidéos de plus de 15 minutes.eligible
: la chaîne peut mettre en ligne des vidéos de plus de 15 minutes, mais cette fonctionnalité doit d'abord être activée.disallowed
: la chaîne n'est pas autorisée à mettre en ligne des vidéos de plus de 15 minutes.
Pour en savoir plus sur ces valeurs, consultez la définition de la propriété. Le Centre d'aide YouTube fournit également des informations plus détaillées sur cette fonctionnalité.
-
La propriété
invideoPromotion.useSmartTiming
indique si la campagne promotionnelle de la chaîne utilise la "chronologie intelligente". Cette fonctionnalité essaie d'afficher les publicités à un moment de la vidéo où les internautes sont plus enclins à cliquer dessus et moins susceptibles de perturber l'expérience de visionnage. Cette fonctionnalité sélectionne une seule publicité à diffuser sur chaque vidéo.
-
-
Les définitions des propriétés
snippet.title
etsnippet.categoryId
de la ressourcevideo
ont été mises à jour pour clarifier la façon dont l'API gère les appels à la méthodevideos.update
. Si vous appelez cette méthode pour mettre à jour la partiesnippet
d'une ressourcevideo
, vous devez définir une valeur pour ces deux propriétés.Si vous essayez de mettre à jour la partie
snippet
d'une ressourcevideo
et que vous ne définissez pas de valeur pour ces deux propriétés, l'API renvoie une erreurinvalidRequest
. La description de cette erreur a également été mise à jour. -
La propriété
contentDetails.contentRating.oflcRating
de la ressourcevideo
, qui identifie la classification d'une vidéo de l'Office of Film and Literature Classification en Nouvelle-Zélande, accepte désormais deux nouvelles classifications:oflcRp13
etoflcRp16
. Elles correspondent respectivement aux notesRP13
etRP16
. -
La méthode
channelBanners.insert
prend désormais en charge l'erreur suivante:Type d'erreur Détails de l'erreur Description badRequest
bannerAlbumFull
L'album de l'illustration de chaîne YouTube du propriétaire de la chaîne comporte trop d'images. Le propriétaire de la chaîne doit ouvrir la page http://photos.google.com, accéder à la page des albums et supprimer certaines des photos de l'album.
12 septembre 2014
Cette mise à jour inclut les changements suivants :
-
En plus du coût des éléments de ressource spécifiés, le coût du quota d'un appel de la méthode
search.list
est passé d'une unité à deux unités.
13 août 2014
Cette mise à jour inclut les changements suivants :
-
La méthode
subscriptions.insert
prend désormais en charge l'erreur suivante:Type d'erreur Détails de l'erreur Description badRequest
subscriptionLimitExceeded
L'abonné identifié dans la requête a dépassé la limite du nombre d'abonnements. Vous pourrez essayer d'autres abonnements dans quelques heures.
12 août 2014
Cette mise à jour inclut les changements suivants :
-
Un nouveau guide, intitulé Migration de votre application vers l'API YouTube Data (v3), explique comment utiliser l'API YouTube Data (v3) pour exploiter les fonctionnalités disponibles dans l'API YouTube Data (v2). L'ancienne API est officiellement obsolète depuis le 4 mars 2014. L'objectif de ce guide est de vous aider à migrer les applications qui utilisent encore la version 2 de l'API vers la version la plus récente.
8 juillet 2014
Cette mise à jour inclut les changements suivants :
-
La méthode
playlists.insert
prend désormais en charge l'erreur suivante:Type d'erreur Détails de l'erreur Description badRequest
maxPlaylistExceeded
Cette erreur se produit si une playlist ne peut pas être créée, car la chaîne a déjà atteint le nombre maximal de playlists autorisé.
18 juin 2014
Cette mise à jour inclut les changements suivants :
-
La description de chaque méthode de l'API a été mise à jour pour inclure le coût du quota engendré par un appel à cette méthode. De même, les définitions des paramètres
part
ont été mises à jour pour spécifier le coût du quota de chaque partie pouvant être récupérée dans un appel d'API. Par exemple, un appel à la méthodesubscriptions.insert
a un coût de quota d'environ 50 unités. La ressourcesubscription
contient également trois parties (snippet
,contentDetails
etsubscriberSnippet
), chacune ayant un coût de deux unités.N'oubliez pas que les coûts des quotas peuvent changer sans avertissement préalable.
-
La ressource
video
est désormais compatible avec 43 nouveaux systèmes de classification du contenu, qui identifient les classifications que les vidéos reçoivent de diverses agences nationales de classification. {35,454,444,{35,45 Italie, Suisse, 34{/1,,{35, Italie, Singapour,14,{35,48,15}15 ,it
28 mai 2014
Cette mise à jour inclut les changements suivants :
-
La méthode
search.list
est désormais compatible avec les paramètreslocation
etlocationRadius
, qui vous permettent de rechercher des vidéos associées à une zone géographique. Une requête doit spécifier une valeur pour les deux paramètres afin de récupérer les résultats en fonction de l'emplacement. L'API renvoie une erreur si une requête n'inclut qu'un seul des deux paramètres.-
Le paramètre
location
spécifie les coordonnées de latitude/longitude au centre de la zone géographique circulaire. -
Le paramètre
locationRadius
spécifie la distance maximale entre le lieu associé à une vidéo et le centre de la zone pour que la vidéo soit quand même incluse dans les résultats de recherche.
-
13 mai 2014
Cette mise à jour inclut les changements suivants :
-
La propriété
invideoPromotion.items[]
de la ressourcechannel
a été mise à jour pour indiquer que vous ne pouvez généralement définir qu'un seul élément promu pour votre chaîne. Si vous essayez d'insérer trop d'articles en promotion, l'API affiche une erreurtooManyPromotedItems
, qui affiche un code d'état HTTP400
. -
La ressource
channelSection
peut désormais contenir des informations sur de nouveaux types de contenus sélectionnés. La propriétésnippet.type
de la ressourcechannelSection
accepte désormais les valeurs suivantes:postedPlaylists
: playlists publiées par le propriétaire de la chaîne dans le flux d'activité de la chaînepostedVideos
: vidéos que le propriétaire de la chaîne a publiées dans le flux d'activité de la chaînesubscriptions
: chaînes auxquelles le propriétaire de la chaîne est abonné
-
La nouvelle propriété
contentDetails.contentRating.ifcoRating
de la ressourcevideo
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 ressourcewatermark
a été mise à jour pour indiquer que le filigrane apparaît toujours dans l'angle supérieur droit du lecteur. -
La définition du paramètre
q
de la méthodesearch.list
a été mise à jour pour indiquer que le terme de requête peut utiliser l'opérateur booléen NOT (-
) pour exclure les vidéos associées à un terme de recherche particulier. Cette valeur peut également utiliser l'opérateur booléen OU (|
) pour rechercher des vidéos associées à l'un des termes de recherche. -
La définition de la propriété
pageInfo.totalResults
renvoyée dans une réponse d'API à un appelsearch.list
a été mise à jour pour indiquer que la valeur est approximative et peut ne pas représenter une valeur exacte. La valeur maximale est également de 1 000 000. Vous ne devez pas utiliser cette valeur pour créer des liens de pagination. Utilisez plutôt les valeurs de propriéténextPageToken
etprevPageToken
pour déterminer si les liens de pagination doivent être affichés. -
Les méthodes
watermarks.set
etwatermarks.unset
ont été mises à jour pour refléter le fait que l'API renvoie un code de réponse HTTP204
pour les requêtes réussies vers ces méthodes.
2 mai 2014
Cette mise à jour inclut les changements suivants :
-
La nouvelle ressource
i18nLanguage
identifie la langue de l'application disponible sur le site YouTube. Le langage de l'application peut également être désigné par le terme "langage d'interface utilisateur". Pour le site Web YouTube, une langue d'application peut être sélectionnée automatiquement en fonction des paramètres du compte Google, de la langue du navigateur ou de l'adresse IP. L'utilisateur peut également sélectionner manuellement la langue de l'interface utilisateur souhaitée dans le pied de page du site YouTube.L'API accepte une méthode permettant de lister les langues d'application prises en charge. Les langues compatibles peuvent être utilisées comme valeur du paramètre
hl
lorsque vous appelez des méthodes d'API telles quevideoCategories.list
etguideCategories.list
. -
La nouvelle ressource
i18nRegion
identifie la zone géographique qu'un utilisateur YouTube peut sélectionner comme région de contenu préférée. La région du contenu peut également être désignée par l'expression "Paramètres régionaux du contenu". Pour le site Web YouTube, une région de contenu peut être automatiquement sélectionnée en fonction d'heuristiques comme le domaine YouTube ou l'adresse IP de l'utilisateur. L'utilisateur peut également sélectionner manuellement la région de contenu souhaitée dans le pied de page du site YouTube.L'API accepte une méthode permettant de lister les régions de contenu compatibles. Les codes régionaux acceptés peuvent être utilisés comme valeur du paramètre
regionCode
lors de l'appel de méthodes d'API telles quesearch.list
,videos.list
,activities.list
etvideoCategories.list
.
7 avril 2014
Cette mise à jour inclut les changements suivants :
-
La nouvelle ressource
channelSection
contient des informations sur un ensemble de vidéos qu'une chaîne a choisi de présenter. Par exemple, une section peut présenter les dernières mises en ligne d'une chaîne, les vidéos les plus populaires, ou les vidéos d'une ou plusieurs playlists.L'API est compatible avec les méthodes permettant de lister, insérer, mettre à jour ou supprimer des sections de canaux. Vous pouvez récupérer la liste des sections de la chaîne de l'utilisateur authentifié en spécifiant un ID de chaîne spécifique ou une liste d'ID de section uniques.
La documentation sur les erreurs a également été mise à jour pour décrire les messages d'erreur compatibles avec l'API, spécifiquement pour ces nouvelles méthodes.
-
La définition de l'objet
fileDetails
de la ressourcevideo
a été mise à jour pour expliquer que cet objet ne sera renvoyé que si la propriétéprocessingDetails.fileDetailsAvailability
de la vidéo a la valeuravailable
.De même, la définition de l'objet
suggestions
de la ressourcevideo
a été mise à jour pour expliquer que cet objet n'est renvoyé que si la propriétéprocessingDetails.tagSuggestionsAvailability
de la vidéo ou sa propriétéprocessingDetails.editorSuggestionsAvailability
ont la valeuravailable
. -
La documentation des méthodes
videos.insert
etvideos.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 ressourcechannel
a été mise à jour pour expliquer que l'objet ne peut être récupéré que par le propriétaire du canal. -
La liste des paramètres de la méthode
videos.rate
a été mise à jour pour indiquer que cette méthode ne prend pas en charge le paramètreonBehalfOfContentOwner
. Il s'agit d'une erreur de documentation, car les requêtesvideos.rate
qui définissent ce paramètre renvoient une erreur500
.
31 mars 2014
Cette mise à jour inclut les changements suivants :
-
La nouvelle propriété
status.publishAt
de la ressourcevideo
vous permet de spécifier la date et l'heure auxquelles une vidéo privée doit être publiée. Cette propriété ne peut être définie que si l'état de confidentialité de la vidéo estprivate
et que celle-ci n'a jamais été publiée. Cette nouvelle propriété n'est pas soumise au règlement relatif aux abandons.
13 mars 2014
Cette mise à jour inclut les changements suivants :
-
L'API est désormais compatible avec la partie
contentOwnerDetails
pour les ressourceschannel
. La nouvelle partie contient des données de chaîne pertinentes pour les partenaires YouTube qui y sont associés, y compris l'ID du propriétaire de contenu associé, ainsi que la date et l'heure de l'association entre le propriétaire de contenu et la chaîne. Notez que cette nouvelle partie n'est pas concernée par le règlement relatif aux abandons. -
La documentation indique désormais la longueur maximale de caractères acceptée pour les propriétés suivantes:
Ressource Propriété Durée maximale channel
invideoPromotion.items[].customMessage
40 caractères video
snippet.title
100 caractères video
snippet.description
5 000 octets video
snippet.tags
500 caractères. Notez que la valeur de la propriété est une liste et que les virgules entre les éléments de la liste sont comptabilisées dans la limite. -
La propriété
brandingSettings.watch.featuredPlaylistId
de la ressourcechannel
est obsolète. L'API renverra une erreur si vous tentez de définir sa valeur. -
Les propriétés de ressource
video
suivantes ont été ajoutées à la liste des valeurs pouvant être définies lors de l'insertion ou de la mise à jour d'une vidéo: -
La documentation sur les erreurs spécifie désormais le code de réponse HTTP pour chaque type d'erreur.
-
L'API accepte désormais les erreurs suivantes:
Type d'erreur Détails de l'erreur Description badRequest (400)
invalidCriteria
La méthode channels.list
renvoie cette erreur si la requête spécifie des paramètres de filtre qui ne peuvent pas être utilisés conjointement.badRequest (400)
channelTitleUpdateForbidden
La méthode channels.update
renvoie cette erreur si vous essayez de mettre à jour la partiebrandingSettings
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 partieinvideoPromotion
spécifie un décalage temporel non valide.badRequest (400)
tooManyPromotedItems
La méthode channels.update
renvoie cette erreur si la partieinvideoPromotion
spécifie plus d'articles que le nombre autorisé.forbidden (403)
promotedVideoNotAllowed
La méthode channels.update
renvoie cette erreur si la propriétéinvideoPromotion.items[].id.videoId
spécifie un ID vidéo introuvable ou qui ne peut pas être utilisé comme élément promu.forbidden (403)
websiteLinkNotAllowed
La méthode channels.update
renvoie cette erreur si la propriétéinvideoPromotion.items[].id.websiteUrl
spécifie une URL non autorisée.required (400)
requiredTimingType
La méthode channels.update
renvoie cette erreur si une requête ne spécifie pas de paramètres de codes temporels par défaut pour l'affichage d'un article mis en avant par YouTube.required (400)
requiredTiming
La méthode channels.update
doit spécifier un objetinvideoPromotion.items[].timing
pour chaque article promu.required (400)
requiredWebsiteUrl
La méthode channels.update
doit spécifier une propriétéinvideoPromotion.items[].id.websiteUrl
pour chaque article dont vous faites la promotion.badRequest (400)
invalidPublishAt
La méthode videos.insert
renvoie cette erreur si les métadonnées de la requête spécifient une heure de publication planifiée non valide.
4 mars 2014
Cette mise à jour inclut les changements suivants :
-
L'API YouTube Data (version 3) est désormais soumise au règlement relatif aux abandons décrit dans les Conditions d'utilisation des API YouTube. Notez que la page qui liste les API soumises au règlement relatif aux abandons exclut spécifiquement certaines fonctionnalités des API v3.
5 décembre 2013
Cette mise à jour inclut les changements suivants :
-
La documentation de la méthode
search.list
a été mise à jour pour indiquer qu'il n'est pas nécessaire de spécifier une valeur pour un seul paramètre de filtre lorsque vous envoyez une requête de recherche. À la place, vous pouvez définir une valeur pour zéro paramètre de filtre ou pour un paramètre de filtrage. -
Les définitions des paramètres de la méthode
search.list
ont été mises à jour pour indiquer que vous devez définir la valeur du paramètretype
survideo
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'imagebrandingSettings.image.bannerTvImageUrl
pour les applications TV est de 2 120 x 1 192 px, mais l'image réelle peut mesurer 2 048 x 1 152 px. Le Centre d'aide YouTube fournit des conseils supplémentaires pour optimiser l'affichage de votre illustration de chaîne sur différents types d'appareils. -
Plusieurs définitions de propriétés de ressource
channel
ont été mises à jour pour refléter les informations suivantes:- La valeur de la propriété
brandingSettings.channel.description
ne doit pas comporter plus de 1 000 caractères. - La propriété
brandingSettings.channel.featuredChannelsTitle
ne doit pas comporter plus de 30 caractères. - La propriété
brandingSettings.channel.featuredChannelsUrls[]
peut désormais répertorier jusqu'à 100 chaînes. - Si la valeur de la propriété
brandingSettings.channel.unsubscribedTrailer
est définie, elle doit indiquer l'ID vidéo YouTube d'une vidéo publique ou non répertoriée appartenant au propriétaire de la chaîne.
- La valeur de la propriété
-
La méthode
channels.update
prend désormais en charge les mises à jour de la propriétéinvideoPromotion.items[].promotedByContentOwner
. Cet établissement indique si le nom du propriétaire du contenu sera affiché lors de l'affichage de la promotion. Elle ne peut être définie que si la requête API qui définit la valeur de la propriété est effectuée au nom du propriétaire de contenu à l'aide du paramètreonBehalfOfContentOwner
. -
Les méthodes
playlistItems.list
etplaylistItems.insert
prennent désormais en charge le paramètreonBehalfOfContentOwner
, qui est déjà compatible avec plusieurs autres méthodes. -
La propriété
contentDetails.contentRating.acbRating
peut désormais spécifier une classification de l'Australian Classification Board (ACB) pour les films ou de l'Australian Communications and Media Authority (ACMA) pour les programmes télévisés pour enfants. -
Les nouvelles propriétés
contentDetails.contentRating.catvRating
etcontentDetails.contentRating.catvfrRating
indiquent la classification qu'une vidéo a reçue selon le Système de classification de la télévision canadienne et le système de classification de la régie du cinéma de langue française, utilisé au Québec, respectivement. -
La nouvelle propriété
snippet.assignable
de la ressourcevideoCategory
indique si des vidéos mises à jour ou récemment mises en ligne peuvent être associées à cette catégorie de vidéos. -
Des exemples de code ont été ajoutés pour les méthodes suivantes:
activities.insert
(OK)channelBanners.insert
(Python)channels.update
(Python)playlistItems.list
(OK)search.list
(OK)thumbnails.set
(Java)videos.insert
(OK)
24 octobre 2013
Cette mise à jour inclut les changements suivants :
-
L'API inclut deux fonctionnalités supplémentaires conçues pour vous aider à rechercher et à mettre en avant des contenus diffusés en direct:
La nouvelle propriété
snippet.liveBroadcastContent
dans les résultats de recherche indique si une ressource vidéo ou de chaîne comporte du contenu diffusé en direct. Les valeurs de propriété valides sontupcoming
,active
etnone
.-
La nouvelle propriété
snippet.liveBroadcastContent
de la ressourcevideo
indique si la vidéo est une diffusion en direct à venir ou active. La liste ci-dessous décrit les valeurs possibles de cette propriété:upcoming
: la vidéo est une diffusion en direct qui n'a pas encore commencé.active
: la vidéo est une diffusion en direct.none
: la vidéo n'est ni une diffusion en direct à venir, ni active. Il s'agira de la valeur de la propriété des diffusions terminées qui sont toujours visibles sur YouTube.
-
La nouvelle propriété
liveStreamingDetails
de la ressourcevideo
est un objet qui contient des métadonnées sur une diffusion vidéo en direct. Pour récupérer ces métadonnées, incluezliveStreamingDetails
dans la liste des parties de ressources de la valeur du paramètrepart
. Les métadonnées incluent les nouvelles propriétés suivantes:liveStreamingDetails.actualStartTime
: heure à laquelle la diffusion a réellement commencé. (Cette valeur sera visible une fois que l'état de la diffusion seraactive
.)liveStreamingDetails.actualEndTime
: heure à laquelle la diffusion s'est réellement terminée. (Cette valeur sera visible une fois la diffusion terminée.)liveStreamingDetails.scheduledStartTime
: heure prévue de début de la diffusion.liveStreamingDetails.scheduledEndTime
: heure de fin programmée de la diffusion. Si la valeur de la propriété est vide ou si la propriété n'est pas présente, la diffusion est programmée pour durer indéfiniment.liveStreamingDetails.concurrentViewers
: nombre de personnes qui regardent la diffusion en direct.
Pour récupérer ces métadonnées, incluez
liveStreamingDetails
dans la valeur du paramètrepart
lorsque vous appelez la méthodevideos.list
,videos.insert
ouvideos.update
.
Notez que deux autres fonctionnalités permettant d'identifier le contenu diffusé en direct ont été publiées le 1er octobre 2013 : le paramètre
eventType
de la méthodesearch.list
et la propriétésnippet.liveBroadcastContent
du résultat de recherche. -
-
La méthode
videos.insert
est désormais compatible avec le paramètrenotifySubscribers
, qui indique si YouTube doit envoyer une notification concernant la nouvelle vidéo aux utilisateurs qui s'abonnent à la chaîne de la vidéo. La valeur par défaut de ce paramètre estTrue
. Elle indique que les abonnés seront informés des nouvelles vidéos mises en ligne. Toutefois, un propriétaire de chaîne qui met en ligne de nombreuses vidéos peut préférer définir la valeurFalse
pour éviter d'envoyer une notification aux abonnés à chaque nouvelle vidéo. -
La liste des propriétés pouvant être modifiées lors de l'appel de la méthode
channels.update
a été mise à jour pour inclure les propriétésinvideoPromotion.items[].customMessage
etinvideoPromotion.items[].websiteUrl
. En outre, la liste a été modifiée afin d'identifier les propriétésbrandingSettings
modifiables. Ces propriétésbrandingSettings
étaient déjà modifiables. Le changement apporté à la documentation ne reflète donc pas un changement apporté aux fonctionnalités existantes de l'API. -
Les méthodes
playlists.insert
,playlists.update
etplaylists.delete
acceptent désormais le paramètreonBehalfOfContentOwner
, qui est déjà compatible avec plusieurs autres méthodes. -
La méthode
playlists.insert
prend désormais en charge le paramètreonBehalfOfContentOwnerChannel
, qui est déjà compatible avec plusieurs autres méthodes. -
La propriété
contentDetails.contentRating.tvpgRating
de la ressourcevideo
accepte désormais la valeurpg14
, ce qui correspond à une noteTV-14
. -
La définition de la propriété
snippet.liveBroadcastContent
, qui fait partie des résultats de recherche, a été corrigée pour refléter le fait quelive
est une valeur de propriété valide, mais pasactive
. -
La propriété
contentDetails.contentRating.mibacRating
de la ressourcevideo
accepte désormais deux notes supplémentaires:mibacVap
(VAP) : les enfants doivent être accompagnés d'un adulte.mibacVm6
(V.M.6) – Réservé à un public de 6 ans et plus.mibacVm12
(V.M.12) – Interdit aux moins de 12 ans.
-
La nouvelle propriété
invideoPromotion.items[].promotedByContentOwner
de la ressourcechannel
indique si le nom du propriétaire de contenu sera affiché lors de l'affichage de la promotion. Ce champ ne peut être défini que si la requête API qui définit la valeur est effectuée au nom du propriétaire de contenu. Pour en savoir plus, consultez le paramètreonBehalfOfContentOwner
.
1er octobre 2013
Cette mise à jour inclut les changements suivants :
-
Le nouvel objet
auditDetails
de la ressourcechannel
contient des données de canal qu'un réseau multichaîne évaluerait afin de déterminer s'il faut accepter ou refuser une chaîne spécifique. Notez que toute requête API qui récupère cette partie de ressource doit fournir un jeton d'autorisation contenant le champ d'applicationhttps://www.googleapis.com/auth/youtubepartner-channel-audit
. De plus, tout jeton utilisant ce champ d'application doit être révoqué lorsque le réseau multichaîne accepte ou refuse la chaîne, ou dans les deux semaines suivant sa date d'émission. -
La propriété
invideoPromotion.items[].id.type
de la ressourcechannel
accepte désormais la valeurrecentUpload
, ce qui indique que l'élément promu est la dernière vidéo mise en ligne sur une chaîne spécifiée.Par défaut, la chaîne est identique à celle pour laquelle les données de la promotion dans des vidéos sont définies. Toutefois, vous pouvez promouvoir la dernière vidéo mise en ligne sur une autre chaîne en définissant la valeur de la nouvelle propriété
invideoPromotion.items[].id.recentlyUploadedBy
sur l'ID de la chaîne. -
La ressource
channel
contient trois nouvelles propriétés (brandingSettings.image.bannerTvLowImageUrl
,brandingSettings.image.bannerTvMediumImageUrl
etbrandingSettings.image.bannerTvHighImageUrl
) qui spécifient les URL des images de bannière qui s'affichent sur les pages de chaîne des applications TV. -
La nouvelle propriété
snippet.liveBroadcastContent
dans les résultats de recherche indique si une ressource vidéo ou de chaîne comporte du contenu diffusé en direct. Les valeurs de propriété valides sontupcoming
,active
etnone
.- Pour une ressource
video
, la valeurupcoming
indique que la vidéo est une diffusion en direct qui n'a pas encore commencé, tandis qu'une valeuractive
indique qu'il s'agit d'une diffusion en direct en cours. - Pour une ressource
channel
, la valeurupcoming
indique que la chaîne a une diffusion programmée qui n'a pas encore commencé, tandis qu'une valeur deacive
indique qu'une diffusion en direct est en cours sur la chaîne.
- Pour une ressource
-
Dans la ressource
watermark
, la propriététargetChannelId
est passée d'un objet à une chaîne. Au lieu de contenir une propriété enfant spécifiant l'ID de la chaîne YouTube vers laquelle renvoie l'image du filigrane, la propriététargetChannelId
spécifie désormais cette valeur. Par conséquent, la propriététargetChannelId.value
de la ressource a été supprimée. -
La méthode
thumbnails.set
prend désormais en charge le paramètreonBehalfOfContentOwner
, qui est déjà compatible avec plusieurs autres méthodes. -
La méthode
search.list
prend désormais en charge le paramètreeventType
, qui limite une recherche pour qu'elle ne renvoie que les événements de diffusion actifs, à venir ou terminés. -
La nouvelle propriété
contentDetails.contentRating.mibacRating
identifie la classification qu'une vidéo a reçue du Ministero dei Beni e delle Attivita Culturali e del Turismo. -
L'API accepte désormais les erreurs suivantes:
Type d'erreur Détails de l'erreur Description badRequest
invalidImage
La méthode thumbnails.set
renvoie cette erreur si le contenu de l'image fourni n'est pas valide.forbidden
videoRatingDisabled
La méthode videos.rate
renvoie cette erreur si le propriétaire de la vidéo évaluée a désactivé les avis sur cette vidéo.
27 août 2013
Cette mise à jour inclut les changements suivants :
-
La nouvelle ressource
watermark
identifie une image qui s'affiche lors de la lecture des vidéos d'une chaîne donnée. Vous pouvez également spécifier un canal cible vers lequel l'image sera associée, ainsi que des informations temporelles qui déterminent le moment où le filigrane apparaît lors de la lecture de la vidéo et sa durée de visibilité.La méthode
watermarks.set
importe et définit l'image de filigrane d'une chaîne. La méthodewatermarks.unset
supprime l'image en filigrane d'une chaîne.La documentation sur les erreurs décrit les messages d'erreur compatibles avec l'API, spécifiquement pour les méthodes
watermarks.set
etwatermarks.unset
. -
La nouvelle propriété
statistics.hiddenSubscriberCount
de la ressourcechannel
contient une valeur booléenne indiquant si le nombre d'abonnés à la chaîne est masqué. Par conséquent, la valeur de la propriété estfalse
si le nombre d'abonnés de la chaîne est visible publiquement. -
La méthode
playlists.list
accepte désormais les paramètresonBehalfOfContentOwner
etonBehalfOfContentOwnerChannel
. Ces deux paramètres sont déjà pris en charge pour plusieurs autres méthodes. -
La méthode
videos.list
prend désormais en charge le paramètreregionCode
, 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ètrechart
. La valeur du paramètre est un code pays ISO 3166-1 alpha-2. -
error documentation
décrit la nouvelle erreur de requête courante suivante, qui peut se produire pour plusieurs méthodes d'API:Type d'erreur Détails de l'erreur Description forbidden
insufficientPermissions
Les champs d'application associés au jeton OAuth 2.0 fourni pour la requête sont insuffisants pour accéder aux données demandées.
15 août 2013
Cette mise à jour inclut les changements suivants :
-
L'objet
invideoPromotion
de la ressourcechannel
comporte les nouvelles propriétés et celles mises à jour suivantes:-
L'API permet désormais de spécifier un site Web comme article promu. Pour ce faire, définissez la valeur de la propriété
invideoPromotion.items[].id.type
surwebsite
et utilisez la nouvelle propriétéinvideoPromotion.items[].id.websiteUrl
pour spécifier l'URL. Utilisez également la nouvelle propriétéinvideoPromotion.items[].customMessage
pour définir un message personnalisé à afficher pour la promotion.Il peut s'agir de sites Web associés, de sites marchands ou de réseaux sociaux. Afin d'en savoir plus sur l'activation des liens pour votre contenu, consultez les instructions du centre d'aide YouTube pour les sites Web associés et les sites de marchands.
En ajoutant des liens promotionnels, vous acceptez que ces liens ne soient pas utilisés pour rediriger le trafic vers des sites non autorisés, et qu'ils respectent les Règles AdWords, les Règles relatives aux annonces YouTube, le Règlement de la communauté YouTube et les Conditions d'utilisation de YouTube.
-
Les propriétés liées aux paramètres de codes temporels permettant d'afficher les articles sponsorisés lors de la lecture de la vidéo ont été restructurées:
-
L'objet
invideoPromotion.timing
a été déplacé versinvideoPromotion.items[].timing
. Cet objet vous permet désormais de personnaliser les données temporelles pour chaque article promu dans la listeinvideoPromotion.items[]
. -
Le nouvel objet
invideoPromotion.defaultTiming
définit les paramètres temporels par défaut de votre promotion. Ces paramètres permettent de définir à quel moment l'article que vous promouvez s'affiche pendant la lecture de l'une des vidéos de votre chaîne. Vous pouvez remplacer les paramètres de synchronisation par défaut pour n'importe quel article promu à l'aide de l'objetinvideoPromotion.items[].timing
. -
La nouvelle propriété
invideoPromotion.items[].timing.durationMs
indique la durée, en millisecondes, pendant laquelle la promotion doit s'afficher. L'objetinvideoPromotion.defaultTiming
contient également un champdurationMs
qui spécifie la durée par défaut d'affichage de l'élément promu.
-
-
Les propriétés
invideoPromotion.items[].type
etinvideoPromotion.items[].videoId
ont toutes deux été déplacées dans l'objetinvideoPromotion.items[].id
.
-
-
La méthode
subscriptions.list
accepte désormais les paramètresonBehalfOfContentOwner
etonBehalfOfContentOwnerChannel
. Ces deux paramètres sont déjà pris en charge pour plusieurs autres méthodes. -
Dans la réponse de l'API à une requête
thumbnails.set
, la valeur de la propriétékind
est passée deyoutube#thumbnailListResponse
àyoutube#thumbnailSetResponse
. -
Des exemples de code ont été ajoutés pour les méthodes suivantes:
channels.update
(Java, Python)playlists.insert
(.NET, PHP)subscriptions.insert
(PHP, Python)thumbnails.set
(PHP, Python)videos.insert
(PHP)videos.list
(PHP)videos.rate
(Python)videos.update
(Java, PHP, Python)
Notez que l'exemple Python pour la méthode
playlistItems.insert
a également été supprimé, car la fonctionnalité présentée est désormais gérée par la méthodevideos.rate
. -
error documentation
décrit la nouvelle erreur de contexte de requête suivante, qui peut se produire pour toute méthode d'API compatible avec le paramètre de requêtemine
:Type d'erreur Détails de l'erreur Description badRequest
invalidMine
Le paramètre mine
ne peut pas être utilisé dans les demandes pour lesquelles l'utilisateur authentifié est un partenaire YouTube. Vous devez soit supprimer le paramètremine
, vous authentifier en tant qu'utilisateur YouTube en supprimant le paramètreonBehalfOfContentOwner
, soit agir en tant que chaîne du partenaire en fournissant le paramètreonBehalfOfContentOwnerChannel
s'il est disponible pour la méthode appelée.
8 août 2013
Cette mise à jour inclut les changements suivants :
-
La section Utilisation du quota du guide Premiers pas avec l'API YouTube Data a été mise à jour pour refléter le changement du coût d'une importation de vidéo, passant de 16 000 unités environ à 1 600 unités.
30 juillet 2013
Cette mise à jour inclut les changements suivants :
-
Dans une ressource
channelBanner
, la valeur de la propriétékind
est passée deyoutube#channelBannerInsertResponse
àyoutube#channelBannerResource
. Cette ressource est renvoyée en réponse à une requêtechannelBanners.insert
. -
La nouvelle propriété
brandingSettings.channel.profileColor
de la ressourcechannel
spécifie une couleur proéminente qui complète le contenu de la chaîne. La valeur de la propriété est un signe dièse (#
) suivi d'une chaîne hexadécimale à six caractères, par exemple#2793e6
. -
Vous pouvez désormais indiquer si un abonnement s'applique à l'ensemble des activités d'une chaîne ou uniquement aux nouvelles mises en ligne. La nouvelle propriété
contentDetails.activityType
de la ressourcesubscription
identifie les types d'activités pour lesquels l'abonné sera averti. Les valeurs de propriété valides sontall
etuploads
. -
La méthode
videos.list
accepte de nouveaux paramètres permettant de récupérer un graphique des vidéos les plus populaires sur YouTube:- Le paramètre
chart
identifie le graphique que vous souhaitez récupérer. Actuellement, la seule valeur acceptée estmostPopular
. Notez que le paramètrechart
est un paramètre de filtre, ce qui signifie qu'il ne peut pas être utilisé dans la même demande que d'autres paramètres de filtre (id
etmyRating
). - 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ètrechart
. Par défaut, les graphiques ne sont pas limités à une catégorie particulière.
- Le paramètre
-
La nouvelle propriété
topicDetails.relevantTopicIds[]
de la ressourcevideo
fournit une liste d'ID de thèmes Freebase pertinents pour la vidéo ou son contenu. Les sujets de ces sujets peuvent être mentionnés ou apparaître dans la vidéo. -
La propriété
recordingDetails.location.elevation
de la ressourcevideo
a été renomméerecordingDetails.location.altitude
, et sa propriétéfileDetails.recordingLocation.location.elevation
a été renomméefileDetails.recordingLocation.location.altitude
. -
L'objet
contentDetails.contentRating
de la ressourcevideo
spécifie les classifications qu'une vidéo a reçues en fonction de différents systèmes de classification, y compris les classifications MPAA, TVPG, etc. Pour chaque système de classification, l'API accepte désormais une valeur indiquant que la vidéo n'a pas été évaluée. Remarque : Dans les classifications MPAA, la mention "non évalué" est fréquemment utilisée pour identifier les versions non montées des films pour lesquelles la version coupée du film a reçu une classification officielle. -
La nouvelle propriété
contentDetails.contentRating.ytRating
de la ressourcevideo
identifie le contenu soumis à une limite d'âge. La valeur de la propriété estytAgeRestricted
si YouTube a identifié le contenu de la vidéo comme inapproprié pour les utilisateurs de moins de 18 ans. Si la propriété est absente ou si sa valeur est vide, cela signifie que le contenu n'a pas été soumis à une limite d'âge. -
Le paramètre
mySubscribers
de la méthodechannels.list
a été abandonné. Utilisez la méthodesubscriptions.list
et son paramètremySubscribers
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
etvideos.rate
acceptent désormais le paramètreonBehalfOfContentOwner
. Ce paramètre indique que l'utilisateur authentifié agit pour le compte du propriétaire de contenu spécifié dans la valeur du paramètre. -
La documentation de la méthode
channels.update
a été mise à jour pour tenir compte du fait qu'elle peut être utilisée pour mettre à jour l'objetbrandingSettings
de la ressourcechannel
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'objetinvideoPromotion
de la ressourcechannel
. -
error documentation
décrit les nouvelles erreurs suivantes:Type d'erreur Détails de l'erreur Description forbidden
accountDelegationForbidden
Cette erreur n'est pas spécifique à une méthode API particulière. Elle indique que l'utilisateur authentifié n'est pas autorisé à agir au nom du compte Google spécifié. forbidden
authenticatedUserAccountClosed
Cette erreur n'est pas spécifique à une méthode API particulière. Il indique que le compte YouTube de l'utilisateur authentifié est clôturé. Si l'utilisateur agit au nom d'un autre compte Google, cette erreur indique que cet autre compte est clôturé. forbidden
authenticatedUserAccountSuspended
Cette erreur n'est pas spécifique à une méthode API particulière. Il indique que le compte YouTube de l'utilisateur authentifié est suspendu. Si l'utilisateur agit au nom d'un autre compte Google, cette erreur indique que cet autre compte est suspendu. forbidden
authenticatedUserNotChannel
Cette erreur n'est pas spécifique à une méthode API particulière. Il indique que le serveur d'API ne peut pas identifier le canal associé à la requête API. Si la requête est autorisée et utilise le paramètre onBehalfOfContentOwner
, vous devez également définir le paramètreonBehalfOfContentOwnerChannel
.forbidden
cmsUserAccountNotFound
Cette erreur n'est pas spécifique à une méthode API particulière. L'utilisateur du CMS n'est pas autorisé à agir au nom du propriétaire de contenu spécifié. notFound
contentOwnerAccountNotFound
Cette erreur n'est pas spécifique à une méthode API particulière. Impossible de trouver le compte de propriétaire de contenu spécifié. badRequest
invalidPart
Cette erreur n'est pas spécifique à une méthode API particulière. Le paramètre part
de la requête spécifie les parties qui ne peuvent pas être écrites en même temps.badRequest
videoChartNotFound
La méthode videos.list
renvoie cette erreur lorsque la requête spécifie un graphique vidéo non compatible ou non disponible.notFound
videoNotFound
La méthode videos.update
renvoie cette erreur pour indiquer que la vidéo que vous essayez de mettre à jour est introuvable. Vérifiez que la valeur de la propriétéid
est correcte dans le corps de la requête.
10 juin 2013
Cette mise à jour inclut les changements suivants :
-
Le nouveau paramètre
forUsername
de la méthodechannels.list
vous permet de récupérer des informations sur une chaîne en spécifiant son nom d'utilisateur YouTube. -
La méthode
activities.list
prend désormais en charge le paramètreregionCode
, qui indique à l'API de renvoyer des résultats pertinents pour le pays spécifié. YouTube utilise cette valeur lorsque l'activité précédente de l'utilisateur autorisé sur YouTube ne fournit pas suffisamment d'informations pour générer le flux d'activité. -
Les ressources de playlist contiennent désormais la propriété
snippet.tags
. La propriété ne sera renvoyée qu'aux utilisateurs autorisés qui récupéraient des données concernant leurs propres playlists. Les utilisateurs autorisés peuvent également définir des tags de playlist lorsqu'ils appellent les méthodesplaylists.insert
ouplaylists.update
. -
Le paramètre
onBehalfOfContentOwner
, qui était auparavant compatible avec les méthodeschannels.list
etsearch.list
, est désormais également pris en charge pour les méthodesvideos.insert
,videos.update
etvideos.delete
. Notez que lorsque ce paramètre est utilisé dans un appel de la méthodevideos.insert
, la requête doit également spécifier une valeur pour le nouveau paramètreonBehalfOfContentOwnerChannel
, 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ètreonBehalfOfContentOwner
.Le paramètre indique que les identifiants d'autorisation de la demande identifient un utilisateur du CMS YouTube agissant pour le compte du propriétaire de contenu spécifié dans la valeur du paramètre. Le compte CMS avec lequel l'utilisateur s'authentifie doit être associé au propriétaire de contenu YouTube spécifié.
Ce paramètre est destiné aux partenaires de contenu qui possèdent et gèrent un grand nombre de chaînes YouTube. Ce paramètre leur permet de s'authentifier une seule fois et d'accéder à toutes les données de leurs vidéos et de leurs chaînes, sans avoir à fournir d'identifiants d'authentification pour chaque chaîne.
Concernant cette version, ce paramètre permet désormais à un partenaire de contenu d'insérer, de mettre à jour ou de supprimer des vidéos sur n'importe quelle chaîne YouTube dont il est le propriétaire.
-
error documentation
décrit les nouvelles erreurs suivantes:Type d'erreur Détails de l'erreur Description forbidden
insufficientCapabilities
Cette erreur n'est pas spécifique à une méthode API particulière. Elle indique que l'utilisateur du CMS qui appelle l'API ne dispose pas des autorisations nécessaires pour effectuer l'opération demandée. Cette erreur est associée à l'utilisation du paramètre onBehalfOfContentOwner
, qui est compatible avec plusieurs méthodes d'API.unauthorized
authorizationRequired
La méthode activities.list
renvoie cette erreur lorsque la requête utilise le paramètrehome
, mais n'est pas correctement autorisée. -
Dans la ressource
channels
, la propriétéinvideoPromotion.channelId
a été supprimée, car l'ID du canal est déjà spécifié à l'aide de la propriétéid
de la ressource. -
Le nouveau guide Utiliser des ID de canal explique comment l'API utilise les ID de canal. Il peut être particulièrement utile pour les développeurs qui migrent depuis la version précédente de l'API, et dont les applications demandent du contenu pour l'utilisateur
default
ou estiment que chaque chaîne YouTube possède un nom d'utilisateur unique, ce qui n'est plus le cas.
22 mai 2013
Cette mise à jour inclut les changements suivants :
-
La nouvelle méthode
channelBanners.insert
vous permet d'importer une image de bannière, que vous pouvez ensuite définir comme bannière pour une chaîne à l'aide de la nouvelle propriétébrandingSettings.image.bannerExternalUrl
de la ressourcechannel
. -
La documentation de la méthode
channels.update
a été mise à jour pour répertorier les propriétés pouvant être modifiées lors de l'appel de la méthode. -
La documentation de la ressource
video
ne répertorie plusunspecified
comme valeur de propriété valide pour les propriétéssuggestions.processingErrors[]
,suggestions.processingHints[]
,suggestions.processingWarnings[]
etsuggestions.editorSuggestions[]
. -
La valeur par défaut du paramètre
maxResults
de la méthodevideos.list
est désormais5
. -
error documentation
répertorie désormais les erreurs pour les méthodeschannelBanners.insert
etsubscriptions.list
. Il répertorie également plusieurs nouvelles erreurs pour la méthodechannels.update
.
14 mai 2013
Cette mise à jour inclut les changements suivants :
-
Les pages autonomes répertorient désormais des exemples de code pour Java, .NET, PHP et Ruby.
-
La page qui répertorie les exemples de code Python inclut désormais des exemples permettant d'ajouter un abonnement, de créer une playlist et de mettre à jour une vidéo.
10 mai 2013
Cette mise à jour inclut les changements suivants :
-
YouTube n'identifie plus les fonctionnalités et services d'API expérimentaux. À la place, nous fournissons désormais une liste des API YouTube soumises au règlement relatif aux abandons.
8 mai 2013
Cette mise à jour inclut les changements suivants :
-
Les ressources de canal acceptent désormais l'objet
inVideoPromotion
, qui encapsule les informations sur une campagne promotionnelle associée à la chaîne. Une chaîne peut utiliser une campagne promotionnelle dans les vidéos pour afficher la miniature d'une vidéo sponsorisée dans le lecteur vidéo lors de la lecture des vidéos de la chaîne.Vous pouvez récupérer ces données en incluant
invideoPromotion
dans la valeur du paramètrepart
dans une requêtechannels.list
. -
La nouvelle méthode
channels.update
permet de mettre à jour les données des campagnes promotionnelles dans des vidéos d'une chaîne. Notez que cette méthode ne prend en charge que les mises à jour de la partieinvideoPromotion
de la ressourcechannel
. Elle n'est pas encore compatible avec les mises à jour d'autres parties de cette ressource.
2 mai 2013
Cette mise à jour inclut les changements suivants :
-
Les ressources de la chaîne sont désormais compatibles avec la propriété
status.isLinked
, qui indique si les données de la chaîne identifient un utilisateur déjà associé à un nom d'utilisateur YouTube ou à un compte Google+. Un utilisateur disposant de l'un de ces liens possède déjà une identité YouTube publique, ce qui est indispensable pour plusieurs actions, telles que la mise en ligne de vidéos. -
Les ressources d'abonnement sont désormais compatibles avec la partie
subscriberSnippet
. Cet objet encapsule un extrait de données correspondant à la chaîne de l'abonné. -
L'API est désormais compatible avec la méthode
videos.getRating
, qui récupère les notes que l'utilisateur authentifié a attribuées à une liste d'une ou plusieurs vidéos. -
Le nouveau paramètre
myRating
de la méthodevideos.list
vous permet de récupérer une liste des vidéos que l'utilisateur authentifié a évaluées avec une classificationlike
oudislike
.Les paramètres
myRating
etid
sont désormais tous deux considérés comme des paramètres de filtre, ce qui signifie qu'une requête API doit spécifier un seul des paramètres. (Auparavant, le paramètreid
était obligatoire pour cette méthode.)La méthode renvoie une erreur
forbidden
pour les requêtes qui tentent de récupérer les informations de classification des vidéos, mais qui ne sont pas autorisées à le faire. -
Avec l'introduction du paramètre
myRating
, la méthodevideos.list
a également été mise à jour pour prendre en charge la pagination. Notez toutefois que les paramètres de pagination ne sont compatibles qu'avec les requêtes utilisant le paramètremyRating
. (Les paramètres et informations de pagination ne sont pas compatibles avec les requêtes qui utilisent le paramètreid
.)-
Le paramètre
maxResults
spécifie le nombre maximal de vidéos que l'API peut renvoyer dans l'ensemble de résultats, tandis que le paramètrepageToken
identifie la page spécifique à récupérer dans l'ensemble de résultats. -
La ressource
youtube#videoListResponse
, qui est renvoyée en réponse à une requêtevideos.list
, contient désormais l'objetpageInfo
, qui contient des détails tels que le nombre total de résultats et le nombre de résultats inclus dans l'ensemble de résultats actuel. La ressourceyoutube#videoListResponse
peut également inclure les propriétésnextPageToken
etprevPageToken
, chacune d'elles fournissant un jeton pouvant être utilisé pour récupérer une page spécifique dans l'ensemble de résultats.
-
-
La méthode
videos.insert
accepte les nouveaux paramètres suivants:autoLevels
: définissez cette valeur de paramètre surtrue
pour indiquer à YouTube d'améliorer automatiquement l'éclairage et la couleur de la vidéo.stabilize
: définissez cette valeur de paramètre surtrue
pour indiquer à YouTube d'ajuster la vidéo en supprimant les tremblements liés aux mouvements de la caméra.
-
La propriété
channelTitle
a été ajoutée àsnippet
pour les ressources suivantes:playlistItem
: la propriété spécifie le nom de la chaîne sur laquelle l'élément a été ajouté à la playlist.playlist
: la propriété spécifie le nom de la chaîne sur laquelle la playlist a été créée.subscription
: la propriété spécifie le nom de la chaîne à laquelle l'utilisateur est abonné.
-
Des exemples de code ont été ajoutés pour les méthodes suivantes:
activities.insert
(Ruby)playlistItems.list
(.NET)search.list
(.NET)subscriptions.insert
(Java, Ruby)videos.insert
(.NET, Ruby)
-
Le nouveau paramètre
mySubscribers
de la méthodesubscriptions.list
vous permet de récupérer la liste des abonnés de l'utilisateur actuellement authentifié. Ce paramètre ne peut être utilisé que dans une demande autorisée.Remarque:Cette fonctionnalité est destinée à remplacer le paramètre
mySubscribers
actuellement compatible avec la méthodechannels.list
. Ce paramètre sera abandonné. -
Dans une ressource
video
, la valeur de propriétéunspecified
n'est plus une valeur possible pour les propriétés suivantes: -
Les requêtes API contenant un paramètre inattendu renvoient désormais une erreur
badRequest
. Le motif signalé de l'erreur estunexpectedParameter
. -
L'erreur renvoyée par la méthode
playlistItems.insert
lorsque la playlist contient déjà le nombre maximal d'éléments autorisés a été mise à jour. L'erreur est désormais signalée en tant qu'erreurforbidden
. Son motif estplaylistContainsMaximumNumberOfVideos
.
19 avril 2013
Cette mise à jour inclut les changements suivants :
-
La nouvelle méthode
videos.rate
permet à un utilisateur de définir une classificationlike
oudislike
pour une vidéo, ou de supprimer une note pour une vidéo.La documentation sur les erreurs a également été mise à jour pour répertorier les erreurs que l'API peut renvoyer en réponse à un appel de méthode
videos.rate
. -
Dans la documentation de l'API, les images miniatures sont désormais identifiées comme une ressource distincte. La nouvelle méthode
thumbnails.set
vous permet d'importer une miniature de vidéo personnalisée sur YouTube et de la définir pour une vidéo.La documentation sur les erreurs a également été mise à jour pour répertorier les erreurs que l'API peut renvoyer en réponse à un appel de méthode
thumbnails.set
.Notez que ce changement n'a pas d'incidence réelle sur les ressources existantes qui renvoient des vignettes. Les images miniatures sont renvoyées dans ces ressources de la même manière qu'auparavant, bien que la documentation liste désormais les noms des différentes tailles de vignettes que l'API peut renvoyer.
-
La nouvelle partie
brandingSettings
de la ressourcechannel
identifie les paramètres, le texte et les images de la page de chaîne et des pages de lecture des vidéos. -
La ressource
playlistItem
contient les nouvelles propriétés suivantes:-
Le nouvel objet
status
encapsule les informations d'état sur l'élément de playlist, et la propriétéstatus.privacyStatus
identifie l'état de confidentialité de l'élément de playlist.
-
-
La ressource
video
contient les nouvelles propriétés suivantes:-
La propriété
status.publicStatsViewable
indique si les statistiques étendues de la vidéo sur la page de lecture sont visibles publiquement. Par défaut, ces statistiques sont visibles, et des statistiques telles que le nombre de vues et les notes d'une vidéo restent visibles publiquement, même si la valeur de cette propriété est définie surfalse
. Vous pouvez définir la valeur de cette propriété lorsque vous appelez la méthodevideos.insert
ouvideos.update
. -
L'objet
contentDetails.contentRating
encapsule les notes attribuées à la vidéo selon différents systèmes de classification. La liste ci-dessous répertorie les systèmes de classification acceptés et fournit un lien vers l'établissement associé à chacun d'entre eux. Les définitions des propriétés identifient les valeurs de notation acceptées pour chaque système.Pays Système de classification Propriété États-Unis Motion Picture Association of America (MPAA) contentDetails.contentRating.mpaaRating
États-Unis TV Parental Guidelines contentDetails.contentRating.tvpgRating
Australie L'Australian Classification Board (ACB) contentDetails.contentRating.acbRating
Brésil Departamento de Justiça, Classificação, Qualificação e Títulos contentDetails.contentRating.djctqRating
Canada Système canadien de classification des vidéos (CHVRS) contentDetails.contentRating.chvrsRating
France Centre national du cinéma et de l'image animée (Ministère français de la Culture) contentDetails.contentRating.fmocRating
Allemagne Freiwillige Selbstkontrolle der Filmwirtschaft (FSK) contentDetails.contentRating.fskRating
Grande-Bretagne British Board of Film Classification (BBFC) contentDetails.contentRating.bbfcRating
Inde Central Board of Film Certification (CBFC) contentDetails.contentRating.cbfcRating
Japon 映倫管理委員件 (EIRIN) contentDetails.contentRating.eirinRating
Corée 영상물등파원회 (KMRB) contentDetails.contentRating.kmrbRating
Mexique Direction générale de la radio, la télévision et la cinématographie (RTC) contentDetails.contentRating.rtcRating
Nouvelle-Zélande Office of Film and Literature Classification contentDetails.contentRating.oflcRating
Russie Registre national des films de la Fédération de Russie contentDetails.contentRating.russiaRating
Espagne Instituto de la Cinematografía y de las Artes Audiovisuales (ICAA) contentDetails.contentRating.icaaRating
-
-
La documentation de la méthode
playlistItems.update
a été mise à jour pour tenir compte du fait que la propriétésnippet.resourceId
doit être spécifiée dans la ressource envoyée en tant que corps de la requête. -
La méthode
search.list
est désormais compatible avec les fonctionnalités suivantes:-
Le nouveau paramètre
forMine
limite une recherche afin de ne récupérer que les vidéos de l'utilisateur authentifié. -
Le paramètre
order
permet désormais de trier les résultats par ordre alphabétique par titre (order=title
) ou par nombre de vidéos dans l'ordre décroissant (order=videoCount
). -
Le nouveau paramètre
safeSearch
indique si les résultats de recherche doivent inclure du contenu soumis à des restrictions.
-
-
La méthode
videos.insert
accepte plusieurs nouvelles erreurs, répertoriées dans le tableau ci-dessous:Type d'erreur Détails de l'erreur Description badRequest
invalidCategoryId
La propriété snippet.categoryId
spécifie un ID de catégorie non valide. Utilisez la méthodevideoCategories.list
pour récupérer les catégories acceptées.badRequest
invalidRecordingDetails
metadata specifies invalid recording details.
badRequest
invalidVideoGameRating
Les métadonnées de la requête spécifient une classification de jeu vidéo non valide. badRequest
invalidVideoMetadata
Les métadonnées de la requête ne sont pas valides. -
Le paramètre
onBehalfOfContentOwner
a été supprimé de la liste des paramètres acceptés pour les méthodesvideos.update
etvideos.delete
.
12 mars 2013
Cette mise à jour inclut les changements suivants :
-
La propriété
channelTitle
a été ajoutée àsnippet
pour les ressources suivantes: -
La méthode
search.list
accepte les nouveaux paramètres suivants:-
Le paramètre
channelType
vous permet de limiter une recherche de chaînes afin de récupérer toutes les chaînes ou uniquement des émissions. -
Le paramètre
videoType
vous permet de limiter la recherche de vidéos afin de récupérer toutes les vidéos, uniquement des films ou uniquement des épisodes de séries.
-
-
La définition de la partie
recordingDetails
de la ressourcevideo
a été mise à jour pour indiquer que l'objet n'est renvoyé pour une vidéo que si les données de géolocalisation ou la durée d'enregistrement de la vidéo ont été définies. -
La méthode
playlistItems.update
renvoie désormais une erreurinvalidSnippet
, qui s'affiche si la requête API ne spécifie pas d'extrait valide. -
Plusieurs méthodes d'API sont compatibles avec de nouveaux paramètres destinés exclusivement aux partenaires de contenu YouTube. Les partenaires de contenu YouTube incluent des studios de cinéma et de télévision, des maisons de disques et d'autres créateurs de contenu qui publient leurs contenus sur YouTube.
-
Le paramètre
onBehalfOfContentOwner
indique que les identifiants d'autorisation de la demande identifient un utilisateur du CMS YouTube agissant pour le compte du propriétaire de contenu spécifié dans la valeur du paramètre. Le compte CMS avec lequel l'utilisateur s'authentifie doit être associé au propriétaire de contenu YouTube spécifié.Ce paramètre est destiné aux partenaires de contenu qui possèdent et gèrent un grand nombre de chaînes YouTube. Ce paramètre leur permet de s'authentifier une seule fois et d'accéder à toutes les données de leurs vidéos et de leurs chaînes, sans avoir à fournir d'identifiants d'authentification pour chaque chaîne.
Les méthodes
channels.list
,search.list
,videos.delete
,videos.list
etvideos.update
acceptent toutes ce paramètre. -
Le paramètre
managedByMe
, qui est compatible avec la méthodechannels.list
, indique à l'API de renvoyer toutes les chaînes appartenant au propriétaire de contenu spécifiées par le paramètreonBehalfOfContentOwner
. -
Le paramètre
forContentOwner
, compatible avec la méthodesearch.list
, indique à l'API de limiter les résultats de recherche pour qu'ils n'incluent que les ressources appartenant au propriétaire de contenu spécifié par le paramètreonBehalfOfContentOwner
.
-
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
etsuggestions
fournissent aux propriétaires de vidéos des informations sur les vidéos qu'ils ont mises en ligne. Ces données sont très utiles dans les applications qui permettent la mise en ligne de vidéos et incluent:- l'état et la progression du traitement
- erreurs ou autres problèmes rencontrés lors du traitement d'une vidéo
- la disponibilité des vignettes ;
- des suggestions pour améliorer la qualité des vidéos ou des métadonnées ;
- les informations concernant le fichier original mis en ligne sur YouTube ;
Seul le propriétaire de la vidéo peut récupérer ces parties. La liste ci-dessous décrit brièvement les nouvelles parties, et la documentation de la ressource
video
définit toutes les propriétés de chaque partie.-
L'objet
fileDetails
contient des informations sur le fichier vidéo importé sur YouTube, y compris la résolution du fichier, sa durée, ses codecs audio et vidéo, le débit du flux, etc. -
L'objet
processingProgress
contient des informations sur la progression de YouTube dans le traitement du fichier vidéo importé. Les propriétés de l'objet identifient l'état de traitement actuel et estiment le temps restant avant que YouTube n'ait fini de traiter la vidéo. Cette partie indique également si différents types de données ou de contenu, tels que des détails de fichier ou des vignettes, sont disponibles pour la vidéo.Cet objet est conçu pour être interrogé afin que l'utilisateur ayant mis en ligne la vidéo puisse suivre la progression du traitement du fichier vidéo mis en ligne par YouTube.
-
L'objet
suggestions
contient des suggestions qui identifient des possibilités d'amélioration de la qualité ou des métadonnées de la vidéo mise en ligne.
-
La partie
contentDetails
contient quatre nouvelles propriétés. Ces propriétés peuvent être récupérées à l'aide de requêtes non authentifiées.dimension
: indique si la vidéo est disponible en 2D ou en 3D.definition
: indique si la vidéo est disponible en définition standard ou haute définition.caption
: indique si des sous-titres sont disponibles pour la vidéo.licensedContent
: indique si la vidéo comporte du contenu revendiqué par un partenaire de contenu YouTube.
-
La partie
status
contient deux nouvelles propriétés. Les propriétaires de vidéos peuvent définir des valeurs pour les deux propriétés lors de l'insertion ou de la mise à jour d'une vidéo. Ces propriétés peuvent également être récupérées à l'aide de requêtes non authentifiées.embeddable
: indique si la vidéo peut être intégrée sur un autre site Web.license
: licence de la vidéo. Les valeurs valides sontcreativeCommon
etyoutube
.
-
-
La définition du paramètre
part
a été mise à jour pour les méthodesvideos.list
,videos.insert
etvideos.update
afin de répertorier les nouvelles parties décrites ci-dessus, ainsi que la partierecordingDetails
, qui avait été omise par inadvertance. -
La nouvelle propriété
contentDetails.googlePlusUserId
de la ressourcechannel
spécifie l'ID de profil Google+ associé à la chaîne. Cette valeur peut être utilisée pour générer un lien vers le profil Google+. -
Chaque objet d'image vignette spécifie désormais la largeur et la hauteur de l'image. Les images miniatures sont actuellement renvoyées dans les ressources
activity
,channel
,playlist
,playlistItem
,search result
,subscription
etvideo
. -
playlistItems.list
accepte désormais le paramètrevideoId
, que vous pouvez utiliser avec le paramètreplaylistId
pour ne récupérer que l'élément de la playlist qui représente la vidéo spécifiée.L'API renvoie une erreur
notFound
si la vidéo identifiée par le paramètre est introuvable dans la playlist. -
La documentation sur les erreurs décrit une nouvelle erreur
forbidden
, qui indique qu'une requête n'est pas correctement autorisée pour l'action demandée. -
La propriété
snippet.channelId
de la ressourcechannel
a été supprimée. La propriétéid
de la ressource fournit la même valeur.
30 janvier 2013
Cette mise à jour inclut les changements suivants :
-
La nouvelle page error répertorie les erreurs que l'API peut renvoyer. Cette page inclut des erreurs générales, qui peuvent se produire pour plusieurs méthodes d'API différentes, ainsi que des erreurs spécifiques aux méthodes.
16 janvier 2013
Cette mise à jour inclut les changements suivants :
-
Des exemples de code sont désormais disponibles pour les méthodes et les langages répertoriés ci-dessous:
activities.insert
– JavaplaylistItems.insert
– PythonplaylistItems.list
: Java, JavaScript, PHP, Python, Rubyplaylists.insert
: Java, JavaScript, Pythonsearch.list
: Java, JavaScript, Python, Rubyvideos.insert
– Java
-
Une ressource
activity
peut désormais signaler une actionchannelItem
, qui se produit lorsque YouTube ajoute une vidéo à une chaîne YouTube générée automatiquement. YouTube utilise un algorithme qui identifie les sujets qui bénéficient d'une forte présence sur le site Web YouTube et génère automatiquement des chaînes pour ces sujets. -
Les paramètres
search.list
suivants ont été mis à jour:- Le paramètre
q
n'est plus désigné comme filtre, ce qui signifie que... - Le paramètre
relatedToVideo
a été renommérelatedToVideoId
. - Le paramètre
published
a été remplacé par deux nouveaux paramètres,publishedAfter
etpublishedBefore
, décrits ci-dessous.
- Le paramètre
-
La méthode
search.list
accepte les nouveaux paramètres suivants:Nom du paramètre Valeur Description channelId
string
Affiche les ressources créées par le canal spécifié. publishedAfter
datetime
Affiche les ressources créées après l'heure spécifiée. publishedBefore
datetime
Affiche les ressources créées avant l'heure spécifiée. regionCode
string
Affiche les ressources pour le pays spécifié. videoCategoryId
string
Filtrez les résultats de recherche de vidéos pour n'inclure que les vidéos associées à la catégorie de vidéo spécifiée. videoEmbeddable
string
Filtrez les résultats de recherche de vidéos pour n'inclure que les vidéos pouvant être lues dans un lecteur intégré sur une page Web. Définissez la valeur du paramètre sur true
pour ne récupérer que les vidéos intégrables.videoSyndicated
string
Filtrez les résultats de recherche de vidéos pour n'inclure que les vidéos qui peuvent être lues en dehors de YouTube.com. Définissez la valeur du paramètre sur true
pour ne récupérer que les vidéos syndiquées. -
Plusieurs ressources d'API prennent en charge de nouvelles propriétés. Le tableau ci-dessous identifie les ressources et leurs nouvelles propriétés:
Ressource Nom de propriété Valeur Description activity
contentDetails.playlistItem.playlistItemId
string
ID de l'élément de la playlist attribué par YouTube pour l'identifier de façon unique. activity
contentDetails.channelItem
object
Objet contenant des informations sur une ressource ajoutée à un canal. Cette propriété n'est présente que si snippet.type
est défini surchannelItem
.activity
contentDetails.channelItem.resourceId
object
Objet qui identifie la ressource qui a été ajoutée au canal. Comme les autres propriétés resourceId
, elle contient une propriétékind
qui spécifie le type de ressource (vidéo ou playlist, par exemple). Il contient également exactement l'une des propriétés (videoId
,playlistId
, etc.) qui spécifie l'identifiant permettant d'identifier la ressource de manière unique.channel
status
object
Cet objet encapsule les informations sur l'état de confidentialité du canal. channel
status.privacyStatus
string
État de confidentialité de la chaîne. Les valeurs valides sont private
etpublic
.playlist
contentDetails
object
Cet objet contient des métadonnées sur le contenu de la playlist. playlist
contentDetails.itemCount
unsigned integer
Nombre de vidéos dans la playlist. playlist
player
object
Cet objet contient les informations dont vous avez besoin pour lire la playlist dans un lecteur intégré. playlist
player.embedHtml
string
Une balise <iframe>
qui intègre un lecteur vidéo qui lit la playlist.video
recordingDetails
object
Cet objet encapsule les informations qui identifient ou décrivent le lieu et l'heure où la vidéo a été enregistrée. video
recordingDetails.location
object
Cet objet contient les informations de géolocalisation associées à la vidéo. video
recordingDetails.location.latitude
double
Latitude en degrés. video
recordingDetails.location.longitude
double
Longueur en degrés. video
recordingDetails.location.elevation
double
Altitude au-dessus de la Terre, en mètres. video
recordingDetails.locationDescription
string
Texte descriptif du lieu où la vidéo a été enregistrée. video
recordingDetails.recordingDate
datetime
Date et heure d'enregistrement de la vidéo. La valeur est spécifiée au format ISO 8601 ( YYYY-MM-DDThh:mm:ss.sZ
). -
La documentation de plusieurs méthodes d'API identifie désormais les propriétés qui doivent être spécifiées dans le corps de la requête ou celles qui sont mises à jour en fonction des valeurs qu'il contient. Le tableau ci-dessous liste ces méthodes, ainsi que les propriétés obligatoires ou modifiables.
Remarque:Il est possible que la documentation d'autres méthodes répertorie déjà les propriétés obligatoires et modifiables.
Méthode Propriétés activities.insert
Propriétés obligatoires: snippet.description
snippet.description
contentDetails.bulletin.resourceId
playlists.update
Propriétés obligatoires: id
playlistItems.update
Propriétés obligatoires: id
videos.update
Propriétés obligatoires: id
-
L'API ne signale plus une erreur
playlistAlreadyExists
si vous essayez de créer ou de mettre à jour une playlist dont le titre est identique à celui d'une playlist existante sur la même chaîne. -
Plusieurs méthodes d'API prennent en charge de nouveaux types d'erreurs. Le tableau ci-dessous identifie la méthode et les nouvelles erreurs prises en charge:
Méthode Type d'erreur Détails de l'erreur Description guideCategories.list
notFound
notFound
La catégorie de guide identifiée par le paramètre id
est introuvable. Utilisez la méthode guideCategories.list pour récupérer une liste de valeurs valides.playlistItems.delete
forbidden
playlistItemsNotAccessible
La demande n'est pas autorisée pour supprimer l'élément de playlist spécifié. videoCategories.list
notFound
videoCategoryNotFound
La catégorie de la vidéo identifiée par le paramètre id
est introuvable. Utilisez la méthode videoCategories.list pour récupérer une liste de valeurs valides.