📝 Overview
This guide walks you through the process of integrating Google Chat with Yoom using OAuth on the Google Cloud Platform (GCP). Follow these step-by-step instructions to successfully register your app and complete the integration.
📋 Prerequisites
Google Chat integration with Yoom requires administrator privileges on the Google Cloud Platform(GCP).
If you are not an admin, please request an administrator to complete this process.
🛠️ Integration Process
Step 1. Enable Google Chat API
Log in to Google Cloud Platform (make sure the account has administrator privilege).
Click New Project and set a project name (e.g., GoogleChat or Yoom for easy identification).
Select the appropiate Organization and Location, and click Create.
In the left sidebar, navigate APIs & Services → Library.
In the API Library, search for Google Chat.
Select Google Chat API from the results and click Enable.
Once the API is enabled, go to the Configuration tab.
Fill in the following details:
App Status
Live, available to users (no changes needed if already set.)
Application Info
Field | Value |
App Name | Yoom |
Avatar URL | |
Description | Any text |
Interactive Features
Turn ON Enable interactive features
Check the following options:
Receive 1:1 messages
Participate in space and group conversations
Connection Settings
Field | Value |
HTTP endpoint URL | |
Authentication Audience | HTTP endpoint URL |
Slash Commands & Link Previews
No configuration is required.
Publishing Settings
Check "Make this chat app available to specific users and groups in {organization name}".
Specify users who can use the Google Chat API.
Logging
Check "Log errors to Logging".
Step 2. Set Up OAuth Data Access
Open the "APIs & Services > OAuth consent screen" from the left sidebar menu.
At next page, fill out the Project Configuration Form.
App Information
Field | Value |
App Name | Yoom |
User Support Email | Any valid internal support email |
Audience
Select "Internal".(This makes the app available only within your organization.)
Contact Information
Please set any email address.
Finish
Please check the checkbox.
Click "Create".
Open the "Data Access" from the left sidebar menu.
On the Data Access page, click "Add or remove scopes".
In the search field, add the following scopes:
Scope | Descriptions |
/auth/userinfo.email | View user email address |
/auth/chat.spaces | View chat spaces |
/auth/chat.delete | Delete chat messages |
/auth/chat.messages | View and send chat messages |
/auth/chat.memberships | Manage chat memberships |
Click Save and continue.
Step 3. Create OAuth Credentials
Open the "Clients" from the left sidebar menu.
Click "+ CREATE CLIENT".
Configure as follows:
Field | Value |
Application Type | Web application |
Name | Yoom |
Authorized JavaScript origins | No configuration required. |
Authorized redirect URI |
Click Create.
Click the created OAuth Client.
At next page, copy the Client ID and Client Secret - you'll need these for Yoom integration.
⚠️ Treat the Client ID and Client Secret like passwords. Keep them confidential.
Step 4. Integrate Yoom with Google Chat
Log in to Yoom and navigate to My Apps → select Google Chat (OAuth).
Enter the Client ID and Client Secret from GCP.
Click Register.
🎉 The integration is now complete! You can now use Google Chat through Yoom.