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

Ce document contient des informations spécifiques sur l'autorisation et l'authentification pour l'API Google Agenda. 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 Agenda

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.

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

Champ d'application 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 les 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 Afficher 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 Consulter, ajouter et supprimer les agendas Google auxquels vous êtes abonné
https://www.googleapis.com/auth/calendar.calendarlist.readonly Consulter 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 Afficher et modifier les autorisations de partage des agendas Google dont vous êtes propriétaire
https://www.googleapis.com/auth/calendar.acls.readonly Afficher 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