10.14. Google Cloud Connector Settings

This guide outlines the step-by-step process for connecting Alga PSA with Google Cloud services to enable Gmail, Calendar, and Pub/Sub integrations.

Phase 1: Google Cloud Project Setup

1. In Alga PSA, navigate to Settings > General > Providers.
2. Open the Google Cloud Console in an adjacent tab.
3. In the cloud console, open the project picker in the top bar and select "New Project".
4. Name it (e.g., "Alga PSA Connector") and click Create.
   • Tip: Make sure you switch to this new project after creating it.
5. Go to APIs & Services > Library.
6. Search for and Enable the following three APIs:
   • Gmail API
   • Google Calendar API
   • Cloud Pub/Sub API

Phase 2: Service Account & Keys

1. Go to IAM & Admin > Service Accounts.
2. Click + Create Service Account.
3. Name: Enter a name (e.g., "Alga Service Account") and click Create and Continue.
4. Roles: Grant the following roles to ensure full functionality:
   • Project > Owner (Easiest for setup) OR ensure you have at least:
     • Pub/Sub Admin
     • Service Account User
     • Project IAM Admin
5. Click Done.
6. Click on the newly created Service Account email to open its details.
7. Go to the Keys tab.
8. Click Add Key > Create new key.
9. Select JSON and click Create.
   • Action: This will download a file to your computer. Open this file in a text editor (like Notepad or TextEdit) and copy the entire text content. You will need this for Alga.

Phase 3: OAuth Consent Screen

1. Go to APIs & Services > OAuth consent screen.
2. User Type: Select Internal (if available/for your org only) or External. Click Create.
3. App Info: Fill in the App Name (e.g., "Alga PSA"), User Support Email, and Developer Contact Info.
4. Scopes: Click Add or Remove Scopes and select the following:
   • .../auth/gmail.readonly
   • .../auth/calendar
   • .../auth/pubsub
5. Click Save and Continue through the remaining steps (Test Users can be skipped if "Internal").

Phase 4: Create OAuth Credentials

Note: This is where you need the Redirect URI from Alga.

1. Get Redirect URI:
   • Open Alga PSA in a new tab.
   • Navigate to Admin > General > Providers > Google.
   • Copy the URL listed under "Redirect URIs".
2. Create Client ID in Google:
   • Back in Google Cloud Console, go to APIs & Services > Credentials.
   • Click + Create Credentials > OAuth client ID.
   • Application Type: Select Web application.
   • Name: "Alga Web Client".
   • Authorized redirect URIs: Click + Add URI and paste the URL you copied from Alga.
   • Click Create.
3. Copy Credentials:
   • A popup will show your Client ID and Client Secret. Keep this open or copy them to a safe place.

Phase 5: Final Configuration in Alga PSA

1. Return to the Alga PSA Google Provider settings page.
2. Fill in the fields using the data you just generated:
   • Google Cloud project ID: Found on your Google Cloud dashboard home.
   • OAuth App > Client ID: Paste the Client ID from Phase 4.
   • OAuth App > Client Secret: Paste the Client Secret from Phase 4.
   • Pub/Sub service account: Paste the full JSON text you copied from the key file in Phase 2.
3. Click Save or Update.

Phase 6: Connect Integrations

Now that the backend is connected, you can activate the user-facing features.

Email Integration:

1. Go to Communication > Inbound Email Integration.
2. Click + Add Email Provider.
3. Select Gmail, fill in the address, and click Connect. You will be prompted to sign in with Google.

Calendar Integration:

1. Go to Calendar > Calendar Integrations.
2. Click + Add Google Calendar.
3. Select the calendar ID (usually "primary") and click Connect.