Ce document contient des informations spécifiques à l'autorisation et à l'authentification de l'API Google Docs. Avant de lire ce document, assurez-vous de consulter les informations générales sur l'authentification et l'autorisation de Google Workspace dans la section En savoir plus sur l'authentification et l'autorisation.
Configurer OAuth 2.0 pour l'autorisation
Configurez l'écran de consentement OAuth et choisissez des champs d'application pour définir les informations affichées aux utilisateurs et aux évaluateurs d'applications. Enregistrez votre application pour pouvoir la publier ultérieurement.
Champs d'application de l'API Docs
Pour définir le niveau d'accès accordé à votre application, vous devez identifier et déclarer des champs d'application 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 et le niveau d'accès. Les champs d'application correspondent aux demandes de votre application pour utiliser les données Google Workspace, y compris les données de compte Google des utilisateurs.
Lorsque votre application est installée, l'utilisateur est invité à valider les champs d'application utilisés par l'application. En règle générale, vous devez choisir le champ d'application le plus précis possible et éviter de demander des champs d'application dont votre application n'a pas besoin. Les utilisateurs accordent plus facilement l'accès à des champs d'application limités et clairement décrits.
Lorsque cela est possible, nous vous recommandons d'utiliser des niveaux d'accès non sensibles, car ils accordent un niveau d'accès par fichier et limitent l'accès aux fonctionnalités spécifiques dont une application a besoin.
L'API Docs est compatible avec les champs d'application suivants :
| Code du champ d'application | Description | Utilisation |
|---|---|---|
https://www.googleapis.com/auth/documents |
Afficher, modifier, créer et supprimer tous vos documents Google Docs. | Sensible |
https://www.googleapis.com/auth/documents.readonly |
Afficher tous vos documents Google Docs. | Sensible |
https://www.googleapis.com/auth/drive.file |
Afficher, modifier, créer et supprimer uniquement les fichiers Google Drive spécifiques que vous utilisez avec cette application. | Recommandé Non sensible |
https://www.googleapis.com/auth/drive |
Afficher, modifier, créer et supprimer tous vos fichiers Google Drive. | Limité |
https://www.googleapis.com/auth/drive.readonly |
Afficher et télécharger tous vos fichiers Google Drive. | Limité |
La colonne "Utilisation" du tableau indique la sensibilité de chaque champ d'application, conformément aux définitions suivantes :
Non sensible : ces champs d'application fournissent le plus petit champ d'application d'accès à l'autorisation et ne nécessitent qu'une validation de base de l'application. Pour en savoir plus sur cette exigence, consultez Envoyer votre application pour validation.
Sensible : ces champs d'application permettent d'accéder à des données utilisateur Google spécifiques autorisées par l'utilisateur pour votre application. Vous devez passer par une validation supplémentaire de l'application. Pour en savoir plus sur cette exigence, consultez Exigences concernant les champs d'application sensibles et limités.
Limité : ces champs d'application offrent un large accès aux données utilisateur Google et vous obligent à suivre une procédure de validation des champs d'application limités. Pour en savoir plus sur cette exigence, consultez Règles relatives aux données utilisateur dans les services des API Google et Exigences supplémentaires pour des champs d'application d'API spécifiques. Si vous stockez des données de champ d'application limité sur des serveurs (ou si vous les transmettez), vous devez passer par une évaluation de la sécurité.
Si votre application nécessite d'accéder à d'autres API Google, vous pouvez également ajouter ces champs d'application. Pour en savoir plus sur les champs d'application des API Google, consultez Utiliser OAuth 2.0 pour accéder aux API Google.
Pour en savoir plus sur les champs d'application OAuth 2.0 spécifiques, consultez Champs d'application OAuth 2.0 pour les API Google.
Articles associés
- Choisir les habilitations de l'API Google Drive
- Centre d'aide sur la validation OAuth des applications
- Questions fréquentes sur la validation des applications OAuth