Instruction
Difficulty level:
Implementing the Google Calendar integration: test and production checklist
This article is the practical implementation guide for the Google Calendar integration, with a checklist for both a test environment and production. The same Google Cloud project and OAuth client apply to both; in test you want a throw-away environment in which you can freely create, change and delete appointments. The numbered steps below describe the order; then use the per-environment checklists.
Checklist — test environment
- ☐ Google Cloud project created/selected.
- ☐ Google Calendar API enabled.
- ☐ OAuth consent screen configured with scopes
calendar.readonly+calendar.events. - ☐ For an External app: the signing-in user added as a test user.
- ☐ OAuth client (Web application) created; Client ID + secret noted.
- ☐ Redirect URI
{base_url}/integrations/redirect/{int_id}registered in the OAuth client. - ☐ Dedicated Google account available to sign in with (not a personal account).
- ☐ Auth screen filled + Step 1 consent + Step 2 connect done.
- ☐ Object → calendar mapping filled (incl. any
*default). - ☐ Outbound and inbound fields set; integration active; watch channel created.
- ☐ End-to-end tested: booking status change → event in Google; and event in Google → booking in i-Reserve.
Checklist — production environment
- ☐ Production OAuth client with production redirect URI on the production base url; secret managed separately.
- ☐ OAuth consent screen published if needed (not in testing mode) so the refresh token does not expire prematurely.
- ☐ Real object → calendar mapping (no test calendars/objects).
- ☐ First live sync verified + watch channel status checked on the diagnostics screen.
- ☐ Rollback known: setting the integration inactive stops sync without losing data.
Create or select a project in the Google Cloud Console and enable the Google Calendar API.
Configure the OAuth consent screen (Internal or External), add the scopes calendar.readonly and calendar.events, and for External add the signing-in user as a test user.
Create an OAuth client ID (Web application), register the redirect URI i-Reserve shows and note the Client ID and secret.
In i-Reserve fill the authentication screen (client/secret/return url), run consent + connect, fill the object-calendar mapping and the outbound/inbound fields.
Set the integration active, verify on the diagnostics screen that the watch channel was created, test inbound and outbound end-to-end and complete the per-environment checklist.
