Implémenter l'autorisation OAuth 2.0

YouTube Reporting API et YouTube Analytics API sont compatibles avec le protocole OAuth 2.0 pour autoriser l'accès aux données utilisateur privées. La liste ci-dessous explique certains concepts de base de OAuth 2.0:

  • Lorsqu'un utilisateur tente pour la première fois d'utiliser une fonctionnalité de votre application qui nécessite qu'il soit connecté à un Google Account or YouTube account, votre application lance le processus d'autorisation OAuth 2.0.

  • Votre application redirige l'utilisateur vers le serveur d'autorisation de Google. Le lien vers cette page spécifie le scope d'accès que votre application demande pour le compte de l'utilisateur. Le scope spécifie les ressources que votre application peut récupérer, insérer, mettre à jour ou supprimer lorsqu'elle agit en tant qu'utilisateur authentifié.

  • Si l'utilisateur accepte d'autoriser votre application à accéder à ces ressources, Google renvoie un jeton à votre application. Selon son type, votre application valide le jeton ou l'échange contre un autre type.

    Par exemple, une application Web côté serveur échange le jeton renvoyé contre un jeton d'accès et un jeton d'actualisation. Le jeton d'accès permet à l'application d'autoriser les requêtes au nom de l'utilisateur, tandis que le jeton d'actualisation permet à l'application de récupérer un nouveau jeton lorsque le jeton d'accès d'origine arrive à expiration.

Important:Pour utiliser l'autorisation OAuth 2.0, vous devez obtenir des identifiants d'autorisation dans la console Google APIs.

Flux OAuth 2.0

Les API Google sont compatibles avec plusieurs cas d'utilisation d'OAuth 2.0:

  • Le flux d'applications Web côté serveur est compatible avec les applications Web qui peuvent stocker des informations persistantes de manière sécurisée.
  • Le flux d'applications Web JavaScript est compatible avec les applications JavaScript exécutées dans un navigateur.
  • Le parcours Applications mobiles et de bureau est compatible avec les applications installées sur un appareil, comme un téléphone ou un ordinateur.
  • Le flux OAuth 2.0 pour les téléviseurs et les périphériques d'entrée à accès limité est compatible avec les appareils aux capacités d'entrée limitées, tels que les consoles de jeu et les caméras vidéo. The YouTube Reporting and YouTube Analytics APIs do not currently support the OAuth 2.0 flow for devices.
  • Le flux OAuth 2.0 pour le flux de compte de service accepte les interactions de serveur à serveur qui n'accèdent pas aux informations utilisateur. Toutefois, YouTube Reporting API et YouTube Analytics API ne sont pas compatibles avec ce flux. Since there is no way to link a Service Account to a YouTube account, attempts to authorize requests with this flow will generate an error.

Identifier les niveaux d'accès

Les champs d'application permettent à votre application de ne demander l'accès qu'aux ressources dont elle a besoin, tout en permettant aux utilisateurs de contrôler le niveau d'accès qu'ils accordent à votre application. Ainsi, il peut y avoir une relation inverse entre le nombre de champs d'application demandés et la probabilité d'obtenir le consentement de l'utilisateur.

Avant de commencer à implémenter l'autorisation OAuth 2.0, nous vous recommandons d'identifier les champs d'application auxquels votre application aura besoin d'une autorisation d'accès.

L'API YouTube Analytics utilise les champs d'application suivants:

Portées
https://www.googleapis.com/auth/youtube Gérez votre compte YouTube
https://www.googleapis.com/auth/youtube.readonly Affichez votre compte YouTube
https://www.googleapis.com/auth/youtubepartner Affichez et gérez vos actifs et le contenu associé sur YouTube
https://www.googleapis.com/auth/yt-analytics-monetary.readonly Affichez des rapports YouTube Analytics monétaires et non monétaires pour votre contenu YouTube
https://www.googleapis.com/auth/yt-analytics.readonly Afficher les rapports YouTube Analytics pour votre contenu YouTube

L'API YouTube Reporting utilise les champs d'application suivants:

Portées
https://www.googleapis.com/auth/yt-analytics-monetary.readonly Affichez des rapports YouTube Analytics monétaires et non monétaires pour votre contenu YouTube
https://www.googleapis.com/auth/yt-analytics.readonly Afficher les rapports YouTube Analytics pour votre contenu YouTube

Le document Champs d'application des API OAuth 2.0 contient la liste complète des champs d'application que vous pouvez utiliser pour accéder aux API Google.