A service account is a special type of Google account that represents a non-human user that needs to authenticate and be authorized to access data in Google APIs.

In this guide, you'll learn how to set up your service account and authorize users.

Why does Semana need a Service Account ?

Semana allows user to get calendar information directly into the app (collaborator availabilities, meeting room, etc…).

In order to proceed, the Semana app uses Google API to retrieve those informations. The API requires an authenticated user.

The Service Account is used to trade users token in order to access data as they would do directly from the Google services (See rooms, see other user schedule).

This method is called “Domain wide delegation” and it is recommended by Google for those use cases.

Thanks to the Service Account, the feature could be integrated seamlessly regarding the user point of view and in order to avoid each user to have to consent.

Requirements:

• An admin account on the Google Workspace
• An admin account on the Semana Workspace

Google Workspace Service Accounts Setup

Create Service Account

1. Open Service Accounts in Google Cloud Platform.
2. Select your project and click Create Service Account.

Service Account Details

1. Fill in the Service account name, Service account ID, and Service account description fields.
2. Click Create and Continue.
3. You can also complete the two optional steps if you'd like to grant the account access to a project or grant users access to the account.