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:
Non sensible: ces champs d'application offrent le plus petit champ d'autorisation. et ne nécessite qu'une vérification de base de l'application. Pour en savoir plus exigence, consultez la section Soumettre votre application pour validation.
Sensible: ces niveaux d'accès permettent d'accéder à des données utilisateur Google spécifiques autorisé par l'utilisateur pour votre application. Cela nécessite de passer par une validation supplémentaire de l'application. Pour en savoir plus sur cette exigence, consultez Champ d'application sensible et restreint Conditions requises
Limité: ces niveaux d'accès offrent un large accès aux données utilisateur Google et vous obligeront à suivre une procédure de validation du champ d'application restreint. Pour à ce sujet, reportez-vous à la page Données utilisateur des services d'API Google Règlement et exigences supplémentaires pour une API spécifique Champs d'application. Si vous stockez des données à champ d'application restreint sur des serveurs (ou si vous les transmettez), vous devez passer une évaluation de sécurité.
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.
Articles associés
- Choisir les champs d'application des API Google Drive
- Centre d'aide sur la validation des applications OAuth
- Questions fréquentes sur la validation des applications OAuth