Choisir les champs d'application de l'API Google Docs

Ce document contient les autorisations spécifiques à l'API Google Docs et d'authentification unique. Avant de lire ce document, veuillez lire les les informations générales d'authentification et d'autorisation de Google Workspace, disponibles sur la page En savoir plus sur l'authentification et l'autorisation

Configurer OAuth 2.0 pour l'autorisation

Configurer l'écran de consentement OAuth et choisir les niveaux d'accès de définir les informations présentées aux utilisateurs et aux examinateurs de l'application, votre application pour pouvoir la publier ultérieurement.

Champs d'application des API Docs

Pour définir le niveau d'accès accordé à votre application, vous devez identifier et déclarer des niveaux d'autorisation ; Un champ d'application d'autorisation est une chaîne d'URI OAuth 2.0 qui contient le nom de l'application Google Workspace, le type de données auxquelles elle accède le niveau d'accès. Les champs d'application correspondent aux demandes de votre application à utiliser les données Google Workspace, y compris des utilisateurs Données du compte Google.

Lorsque votre application est installée, un utilisateur est invité à valider les champs d'application utilisés par l'application. En règle générale, vous devez choisir la portée la plus ciblée et évitez de demander des niveaux d'accès dont votre application n'a pas besoin. Plus d'utilisateurs accorder facilement un accès à des portées limitées et clairement décrites.

Dans la mesure du possible, nous vous recommandons d'utiliser des champs d'application non sensibles, car et restreint l'accès à des fonctionnalités spécifiques nécessaires à une application.

L'API Docs est compatible avec les champs d'application suivants:

Code du champ d'application Description Utilisation
https://www.googleapis.com/auth/documents Consulter, modifier, créer et supprimer tous vos documents Google Docs Contenu à caractère sensible
https://www.googleapis.com/auth/documents.readonly Consultez tous vos documents Google Docs. Contenu à caractère sensible
https://www.googleapis.com/auth/drive.file Consulter, modifier, créer et supprimer uniquement les fichiers Google Drive spécifiques que vous utiliser avec cette application. Recommandé
Non sensible
https://www.googleapis.com/auth/drive Consulter, modifier, créer et supprimer tous vos fichiers Google Drive Limité
https://www.googleapis.com/auth/drive.readonly Consulter et télécharger tous vos fichiers Google Drive Limité

La colonne "Utilisation" du tableau indique le degré de sensibilité de chaque champ d'application, en fonction aux définitions suivantes:

Si votre application a besoin d'accéder à d'autres API Google, vous pouvez ajouter ces niveaux d'accès . Pour plus d'informations sur les champs d'application des API Google, consultez la page Utilisation d'OAuth 2.0 pour Accédez aux API Google.

Pour en savoir plus sur les habilitations OAuth 2.0 spécifiques, consultez la section Champs d'application OAuth 2.0 pour API Google.