Arrêt de l'API YouTube Data v2 : questions fréquentes

Mon application repose sur des commentaires, des sous-titres ou une autre fonctionnalité qui n'est pas présente dans l'API YouTube Data v3. Que dois-je faire ?

Pour le moment, vous pouvez continuer à utiliser l'API v2 pour les commentaires et l'importation de sous-titres de vidéos. Nous ajouterons bientôt cette fonctionnalité à l'API v3. Nous n'avons pas encore de date précise, mais nous déploierons cette fonctionnalité afin que les développeurs disposent du plus de temps possible pour migrer vers la version 3.

Pour d'autres fonctionnalités, l'évolution globale de YouTube ne permettra pas d'obtenir une parité à 100 % entre les API v2 et v3. Pour en savoir plus sur les fonctionnalités compatibles avec la version 3, veuillez consulter la documentation de l'API v3.

Dans la version 2, je peux m'authentifier à l'aide d'une adresse e-mail et d'un mot de passe via ClientLogin. Comment passer à OAuth 2.0 ?

Veuillez consulter notre guide Passer de ClientLogin à OAuth 2.0.

Quelle est la différence de quota entre les versions 2 et 3 ? Quelles sont les similitudes ?

Les versions 2 et 3 utilisent un système de quotas basé sur les coûts, dans lequel certaines opérations (comme les importations) consomment une plus grande quantité de quota que d'autres (comme les recherches).

La différence la plus importante entre les systèmes v2 et v3 est que v3 fournit un pool de quotas global, ce que v2 ne faisait pas. Dans v2, les requêtes effectuées avec une seule clé de développeur, mais provenant d'adresses IP distinctes ou d'utilisateurs authentifiés distincts, ne pouvaient pas entraîner d'erreurs de quota global pour cette clé de développeur. Le pire qui pouvait arriver était une erreur de quota localisée associée à l'adresse IP ou à la chaîne YouTube.

Dans la version 3, il existe un pool de quotas global (de 50 millions d'unités/jour). Tous les appels d'API associés à un projet spécifique dans la console Developers décrémentent le quota de ce pool. Il est donc théoriquement possible qu'une seule adresse IP ou un seul canal consomme l'intégralité du quota associé à un enregistrement d'API, ce qui pourrait entraîner une panne affectant d'autres utilisateurs.

Toutefois, vous pouvez toujours vous protéger contre un utilisateur unique qui épuise le pool de quotas global. Cette documentation publique explique comment définir et appliquer des limites de fréquence plus strictes par utilisateur.

L'API Data v2 acceptait l'accès anonyme à l'API pour les requêtes en lecture seule, comme les recherches de vidéos. Pourquoi dois-je m'enregistrer pour effectuer des appels en lecture seule dans la version 3 ?

L'API v3 est basée sur l'infrastructure moderne des API Google, dans laquelle l'utilisation de nombreuses API différentes peut être liée à un enregistrement spécifique dans la console pour les développeurs. Les développeurs disposent ainsi d'une vue unifiée des technologies Google qu'ils utilisent.

Pour les appels d'API qui n'accèdent qu'à des données accessibles au public, comme les requêtes de recherche, les clients d'API peuvent spécifier une clé API simple lors de l'envoi d'une requête d'API. Les appels d'API qui accèdent à des données utilisateur privées doivent spécifier des jetons OAuth 2.0.

Les développeurs peuvent obtenir des clés API simples et les identifiants nécessaires pour générer des jetons OAuth 2.0 dans la console Google Developers. Les développeurs peuvent également tester l'API sans créer de projet au préalable à l'aide de l'explorateur d'API.

Puis-je continuer à utiliser les mêmes bibliothèques clientes que celles que j'utilisais avec la version 2 après la migration vers la version 3 ?

L'API v3 est fondamentalement différente de la version 2, et un nouvel ensemble de bibliothèques clientes est disponible. Elles sont toutes disponibles sur https://developers.google.com/youtube/v3/libraries et contiennent toutes une assistance native pour l'autorisation OAuth 2.

J'utilisais auparavant l'API YouTube Insight, qui fait partie de la version 2. Quelle est mon alternative ?

Nous recommandons à tous les développeurs de migrer de l'API YouTube Insight, qui a été abandonnée séparément en septembre 2013, vers la nouvelle API YouTube Analytics.

Je m'appuie sur l'API GData (v1 ou v2) pour les flux RSS/Atom des vidéos YouTube. Existe-t-il une alternative une fois qu'ils sont obsolètes ?

Pour le moment, il n'existe pas d'alternative directe. Nous vous recommandons de permettre aux utilisateurs de votre application de gérer et de récupérer leurs abonnements YouTube à l'aide des méthodes du service subscriptions de l'API YouTube Data v3.

Comme j'utilise encore certaines fonctionnalités de la version 2 qui ne sont pas encore disponibles dans la version 3, je dois accéder aux deux versions de l'API dans la même application. Quelles sont les bonnes pratiques à suivre ?

Vous pouvez utiliser la compatibilité avec OAuth 2.0 dans les bibliothèques clientes v3 pour obtenir des jetons d'autorisation qui fonctionneront pour les opérations d'écriture dans les versions 2 et 3. Tout jeton disposant du champ d'application https://gdata.youtube.com ou https://www.googleapis.com/auth/youtube fonctionnera pour les deux API.

Pour les appels d'API qui ne nécessitent pas de jetons OAuth 2.0, obtenez une clé API v3 sur https://cloud.google.com/console et utilisez-la pour les versions 2 et 3.

Nous vous recommandons de migrer votre application pour qu'elle utilise l'API v3 dans la mesure du possible, même si vous devez toujours appeler l'API v2 pour certaines fonctionnalités. Vous permettrez ainsi à votre application d'utiliser les fonctionnalités plus robustes proposées par la version 3. Vous simplifierez également vos futurs efforts de migration lorsque les fonctionnalités réservées à la version 2 qui seront prises en charge dans la version 3 seront finalement publiées.