Choisir les champs d'application de l'API revendeur

Ce document contient des informations spécifiques sur l'autorisation et l'authentification de l'API Reseller. 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 pour les utilisateurs et les évaluateurs d'applications. Enregistrez votre application pour pouvoir la publier ultérieurement.

Champs d'application de l'API Reseller

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.

Lorsqu'un utilisateur installe votre application, il est invité à valider les champs d'application utilisés par celle-ci. En règle générale, vous devez choisir le champ d'application le plus spécifique 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.

Si votre application publique utilise des champs d'application qui autorisent l'accès à certaines données utilisateur, elle doit passer par une procédure de validation. Si le message Application non validée s'affiche à l'écran lorsque vous testez votre application, vous devez envoyer une demande de validation pour le supprimer. Pour en savoir plus sur les applications non validées et obtenir des réponses aux questions fréquentes sur la validation des applications, consultez le Centre d'aide.

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

Champ d'application	Signification
https://www.googleapis.com/auth/apps.order	Champ d'application global pour accéder à toutes les opérations de l'API Reseller.
https://www.googleapis.com/auth/admin.directory.user	Champ d'application global pour accéder à toutes les opérations liées aux utilisateurs et aux alias d'utilisateur.
https://www.googleapis.com/auth/siteverification	Champ d'application global pour un accès en lecture complet aux sites validés existants et la possibilité de valider de nouveaux sites.