Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
L'API Calendar propose plusieurs concepts qui sont principalement utiles aux clients Google Workspace. Ces clients disposent souvent de ressources (salles, projecteurs, etc.) qu'ils souhaitent réserver pour des événements spécifiques. Il est également courant de créer des applications internes qui ont besoin d'accéder à tous les agendas des utilisateurs 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 à des événements en tant que participants, à l'aide de leur adresse e-mail. Lorsqu'ils reçoivent l'invitation, ils acceptent ou refusent automatiquement l'événement en fonction de la disponibilité et des droits d'accès de l'utilisateur qui les a invités.
Accéder aux agendas de domaine en tant qu'application
Une application peut accéder aux agendas appartenant au domaine sans avoir besoin des identifiants de l'utilisateur si elle s'authentifie à l'aide d'un compte de service. Le compte de service doit disposer de l'accès nécessaire grâce à la délégation de l'autorité au niveau du domaine. Pour usurper l'identité d'un compte utilisateur, spécifiez l'adresse e-mail du compte utilisateur avec la méthode setServiceAccountUser de la fabrique GoogleCredential.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/08/29 (UTC).
[null,null,["Dernière mise à jour le 2025/08/29 (UTC)."],[],[],null,["# Domain resources, rooms & calendars\n\nCalendar API offers several concepts that are primarily useful for\n[Google Workspace](https://workspace.google.com/)\ncustomers. These customers often have\nresources---rooms, projectors, and so forth---that they may wish to\nbook for specific events. Furthermore, it's common to build internal apps that\nneed access to all user calendars in a domain, for example to add corporate\nevents to them.\n\nDomain resources \\& rooms\n-------------------------\n\nYou can book resources and rooms by adding them to events as attendees, using\ntheir email address. When they receive the invitation, they automatically\naccept or decline the event based on the availability and access right of the\ninviting user.\n| **Note:** The Calendar API does not offer a way to create resource calendars. To do this, you need to use the Directory API's [Calendar Resource](/workspace/admin/directory/reference/rest/v1/resources.calendars) object. The calendarId corresponds to the resourceEmail field of the Calendar Resource representation.\n\nAccessing domain calendars as an app\n------------------------------------\n\nAn app can access domain-owned calendars without requiring\nuser credentials if it authenticates using a [service\naccount](/identity/protocols/OAuth2ServiceAccount). The service account must\nhave the necessary access using [domain-wide authority\ndelegation](/identity/protocols/OAuth2ServiceAccount#delegatingauthority). In\norder to impersonate a user account, specify the email address of the user\naccount with the `setServiceAccountUser` method of the `GoogleCredential`\nfactory."]]
