In Google Calendar, users can specify a working location so people know their location when sending invitations to an event. This feature is only available to some Google Calendar users. For more details, go to Turn working location on or off for users.
You can read and set a user working location with the Calendar User Availability API. Working hours cannot currently be managed programmatically.
Before you begin
To use the Calendar User Availability API, you must configure a service account in the Cloud Console, associated with a Google Cloud project. End-user authentication isn't supported.
Your service account needs to either be authorized to access user calendars directly – that is, each user needs to explicitly share their calendar with the service account – or be authorized to access user calendars via domain-wide delegation, so the service account can impersonate users within a Workspace organization, acting on their behalf.
Follow the steps below to get started:
Enable the Calendar User Availability API in your Google Cloud project.
Create service account access credentials to authenticate your integration's requests.
Review code samples to learn how to make an authorized API call.
You're now ready to make and receive calls with the Calendar User Availability API.
Read & update user working locations
- To read working location information from a calendar, use
workinglocations.day.read
. - To update working location information for a calendar, use
workinglocations.day.write
.
For more details, go to the Calendar User Availability API resource summary.