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

Ce document contient des informations sur l'autorisation et l'authentification spécifiques à l'API Google Agenda. Avant de lire ce document, consultez les informations générales sur l'authentification et l'autorisation dans Google Workspace sur la page 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 autorisations pour définir les informations qui s'affichent auprès des utilisateurs et des examinateurs de l'application, et enregistrez votre application pour pouvoir la publier ultérieurement.

Champs d'application de l'API Calendar

Pour définir le niveau d'accès accordé à votre application, vous devez identifier et déclarer des champs d'application de l'autorisation. Un champ d'application est une chaîne d'URI OAuth 2.0 contenant 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 du compte Google des utilisateurs.

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 le champ d'application le plus ciblé 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 l'écran indique Application non validée lorsque vous testez votre application, vous devez envoyer une demande de validation pour la 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 Agenda est compatible avec les champs d'application suivants:

Portée	Signification
https://www.googleapis.com/auth/calendar	Voir, modifier, partager et supprimer définitivement tous les agendas auxquels vous pouvez accéder à l'aide de Google Agenda
https://www.googleapis.com/auth/calendar.readonly	Consulter et télécharger tous les agendas auxquels vous pouvez accéder à l'aide de votre Agenda
https://www.googleapis.com/auth/calendar.freebusy	Afficher vos disponibilités dans vos agendas
https://www.googleapis.com/auth/calendar.events	Afficher et modifier les événements de tous vos agendas
https://www.googleapis.com/auth/calendar.events.readonly	Afficher les événements de tous vos agendas
https://www.googleapis.com/auth/calendar.settings.readonly	Consultez vos paramètres Agenda.
https://www.googleapis.com/auth/calendar.addons.execute	Exécuter en tant que module complémentaire Agenda
https://www.googleapis.com/auth/calendar.addons.current.event.read	Consulter les événements que vous ouvrez dans Google Agenda
https://www.googleapis.com/auth/calendar.addons.current.event.write	Modifier les événements que vous ouvrez dans Google Agenda
https://www.googleapis.com/auth/calendar.events.owned	Consulter, créer, modifier et supprimer des événements dans les agendas Google dont vous êtes propriétaire
https://www.googleapis.com/auth/calendar.events.owned.readonly	consulter les événements dans les agendas Google dont vous êtes propriétaire ;
https://www.googleapis.com/auth/calendar.events.freebusy	Connaître la disponibilité dans les agendas Google auxquels vous avez accès
https://www.googleapis.com/auth/calendar.app.created	Créer des agendas Google secondaires et afficher, créer, modifier et supprimer des événements y figurant
https://www.googleapis.com/auth/calendar.calendarlist	Consultez, ajoutez et supprimez les agendas Google auxquels vous êtes abonné.
https://www.googleapis.com/auth/calendar.calendarlist.readonly	Consultez la liste des agendas Google auxquels vous êtes abonné.
https://www.googleapis.com/auth/calendar.calendars	Afficher et modifier les propriétés des agendas Google auxquels vous avez accès, et créer des agendas secondaires
https://www.googleapis.com/auth/calendar.calendars.readonly	Consulter le titre, la description, le fuseau horaire par défaut et les autres propriétés des agendas Google auxquels vous avez accès
https://www.googleapis.com/auth/calendar.acls	Consultez et modifiez les autorisations de partage des agendas Google dont vous êtes propriétaire.
https://www.googleapis.com/auth/calendar.acls.readonly	Consulter les autorisations de partage des agendas Google dont vous êtes propriétaire
https://www.googleapis.com/auth/calendar.events.public.readonly	Consulter les événements des agendas publics