L'API Agenda propose plusieurs concepts principalement utiles aux clients Google Workspace. Ces clients disposent souvent de ressources (salles, projecteurs, etc.) qu'ils peuvent souhaiter réserver pour des événements spécifiques. De plus, il est courant de créer des applications internes qui ont besoin d'accéder à tous les agendas utilisateur d'un domaine, par exemple pour y ajouter des événements d'entreprise.
Ressources et salles du domaine
Vous pouvez réserver des ressources et des salles en les ajoutant aux événements en tant que participants à l'aide de leur adresse e-mail. Lorsqu'il reçoit l'invitation, il accepte ou refuse automatiquement l'événement en fonction de la disponibilité et des droits d'accès de l'utilisateur invité.
Accéder aux agendas de domaine en tant qu'application
Une application peut accéder aux agendas appartenant au domaine sans demander d'identifiants utilisateur si elle s'authentifie à l'aide d'un compte de service. Le compte de service doit disposer de l'accès nécessaire à l'aide de la délégation d'autorité au niveau du domaine. Pour emprunter l'identité d'un compte utilisateur, spécifiez son adresse e-mail avec la méthode setServiceAccountUser de la fabrique GoogleCredential.