> ## Documentation Index
> Fetch the complete documentation index at: https://docs.stackone.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Google Cloud Data OAuth 2.0 (Multiple Companies) connector profile – StackOne setup guide

> Set up a connector profile using OAuth 2.0 (Multiple Companies) for Google Cloud Data in StackOne to allow users to link their accounts.

> [!WARNING]
>
> Cloud SQL Admin and Pub/Sub Admin roles (or Owner) on the target GCP project are required to complete this setup.

Select Actions to adjust the guideSome actions may require additional configuration in the provider to be accessible. Choose the actions you need and the guide will be updated.

Select all
Clear

ActionScope(s)

Loading actions...No actions match your search.

Dynamic Guide URL

Copy URL

Scopes Selected

<pre role="textbox" aria-readonly="true" tabIndex="0" />

Separator

Copy scopes

## Create a Google Cloud OAuth client

Set up a Google Cloud project with the Cloud SQL Admin API and Cloud Pub/Sub API enabled and an OAuth client for StackOne.

**1. Create or select a project**

Sign in to your [Google Cloud Console](https://console.cloud.google.com/), then open the project picker at the top of the page.

<ul>
  <li>**New project:** Click **New project**, fill in **Project name**, **Organization** and **Parent resource**, then click **Create**. Select the new project in the project picker.</li>
  <li>**Existing project:** Select it in the project picker.</li>
</ul>

![Select a resource dialog listing the projects in the organization, with the New project button highlighted.](https://mintcdn.com/stackone-60/QOr5dejwqpPC0eS2/connectors/googleclouddata/images/oauth2-setup-create-project.png?fit=max\&auto=format\&n=QOr5dejwqpPC0eS2\&q=85\&s=688a21951e36c7930d4eaa2ae2ca59f3)

**2. Enable the Cloud SQL Admin API and Cloud Pub/Sub API**

Open **APIs & Services** > **Library**.

<ul>
  <li>Search for `Cloud SQL Admin API`.</li>
  <li>Click **Cloud SQL Admin API**.</li>
  <li>Click **Enable**. If it shows **Manage**, it's already enabled.</li>
  <li>Repeat for `Cloud Pub/Sub API`.</li>
  <li>Cloud Pub/Sub requires billing to be enabled on the project. Open **Billing** to enable it.</li>
</ul>

**3. Enter the app information**

Open **APIs & Services** > **OAuth consent screen** to open the Google Auth Platform dashboard.

<ul>
  <li>Click **Get started**. If the **OAuth Overview** page opens instead, open **Branding** from the sidebar.</li>
  <li>**App name**: A name that identifies this integration</li>
  <li>**User support email**: Email address for user inquiries</li>
  <li>Click **Next**.</li>
</ul>

![Branding page of the Google Auth Platform with the App information section, highlighting the App name and User support email fields (email redacted).](https://mintcdn.com/stackone-60/QOr5dejwqpPC0eS2/connectors/googleclouddata/images/oauth2-setup-branding-info.png?fit=max\&auto=format\&n=QOr5dejwqpPC0eS2\&q=85\&s=5c875c745e5a8793b246adae32d5a074)

**4. Select the audience**

Choose the user type for your application.

<ul>
  <li>**Internal**: Only users within your Google Workspace organization can authorize (no app verification required)</li>
  <li>**External**: Any Google account can authorize (requires app verification for production use)</li>
  <li>Click **Next**.</li>
</ul>

![Audience page of the Google Auth Platform with the User type section highlighted, showing the current type and the Make internal button.](https://mintcdn.com/stackone-60/QOr5dejwqpPC0eS2/connectors/googleclouddata/images/oauth2-setup-select-audience.png?fit=max\&auto=format\&n=QOr5dejwqpPC0eS2\&q=85\&s=7eb65d93fea39559d87341e5cc0aab32)

**5. Enter contact information**

Google sends notices about changes to your project to these addresses. If you opened **Branding**, the field is under **Developer contact information** on the same page.

<ul>
  <li>**Email addresses**: Email addresses for project notices</li>
  <li>Click **Next**.</li>
</ul>

**6. Accept the user data policy**

Review your settings.

<ul>
  <li>Agree to the Google API Services User Data Policy.</li>
  <li>Click **Create**.</li>
</ul>

**7. Publish the app**

For **External** apps, open **Audience** in Google Auth Platform. **Internal** (Google Workspace) apps do not need this step.

<ul>
  <li>Check the **Publishing status**. If it shows **Testing**, click **Publish app**.</li>
  <li>Confirm the dialog.</li>
</ul>

**8. Add the scopes**

Enables actions: Acknowledge Pub/Sub Messages, Clone Cloud SQL Instance, Commit Pub/Sub Schema Revision, Create Cloud SQL Backup, Create Cloud SQL Database, Create Cloud SQL Instance, Create Cloud SQL User, Create Pub/Sub Schema, Create Pub/Sub Subscription, Create Pub/Sub Topic, Delete Cloud SQL Backup, Delete Cloud SQL Database, Delete Cloud SQL Instance, Delete Cloud SQL User, Delete Pub/Sub Schema, Delete Pub/Sub Subscription, Delete Pub/Sub Topic, Detach Pub/Sub Subscription, Failover Cloud SQL Instance, Get Cloud SQL Backup Run, Get Cloud SQL Database, Get Cloud SQL Instance, Get Cloud SQL User, Get Pub/Sub Schema, Get Pub/Sub Subscription, Get Pub/Sub Topic, List Cloud SQL Backup Runs, List Cloud SQL Databases, List Cloud SQL Instances, List Cloud SQL Operations, List Cloud SQL Users, List Pub/Sub Schemas, List Pub/Sub Subscriptions, List Pub/Sub Topics, List Topic Subscriptions, Modify Ack Deadline, Publish Pub/Sub Messages, Pull Pub/Sub Messages, Restart Cloud SQL Instance, Restore Cloud SQL Backup, Seek Pub/Sub Subscription, Start Cloud SQL Replica, Stop Cloud SQL Replica, Test Auth, Update Cloud SQL Database, Update Cloud SQL Instance, Update Cloud SQL User, Update Pub/Sub Subscription, Update Pub/Sub Topic, Validate Pub/Sub Schema

In Google Auth Platform, open **Data Access**.

<ul>
  <li>Click **Add or Remove Scopes**.</li>
  <li>Under **Manually add scopes** in the **Update selected scopes** side panel, paste each scope listed.</li>
  <li>Click **Add to table**.</li>
  <li>Click **Update**.</li>
  <li>On the **Data Access** page, click **Save**.</li>
</ul>

![Data Access page of the Google Auth Platform with the Add or remove scopes button highlighted above the list of configured scopes.](https://mintcdn.com/stackone-60/QOr5dejwqpPC0eS2/connectors/googleclouddata/images/oauth2-setup-select-scopes.png?fit=max\&auto=format\&n=QOr5dejwqpPC0eS2\&q=85\&s=1d361e471d078c82489fd22d0ec1ee4a)

<ul>
  <li>
    [https://www.googleapis.com/auth/sqlservice.admin](https://www.googleapis.com/auth/sqlservice.admin)
  </li>

  <li>
    [https://www.googleapis.com/auth/pubsub](https://www.googleapis.com/auth/pubsub)
  </li>
</ul>

**9. Create the OAuth client**

Open **APIs & Services** > **Credentials**.

<ul>
  <li>Click **Create credentials**.</li>
  <li>Select **OAuth client ID**.</li>
  <li>**Application type**: **Web application**</li>
  <li>**Name**: A name that identifies this OAuth client</li>
  <li>Under **Authorized redirect URIs**, click **Add URI**.</li>
  <li>Enter the **Callback URL** from your Connector Profile.</li>
  <li>Click **Create**.</li>
</ul>

![Create OAuth client ID form with Application type set to Web application, a Name filled in, the StackOne callback URL under Authorized redirect URIs, and the Create button highlighted.](https://mintcdn.com/stackone-60/QOr5dejwqpPC0eS2/connectors/googleclouddata/images/oauth2-setup-create-oauth-form.png?fit=max\&auto=format\&n=QOr5dejwqpPC0eS2\&q=85\&s=d441556f492b51ea2b74845232634bb2)

**10. Copy the Client ID and Client Secret**

A dialog shows your **Client ID** and **Client Secret**.

<ul>
  <li>Copy the **Client ID** and **Client Secret** into your Connector Profile.</li>
</ul>

## Google Cloud session control

Google Workspace administrators can enforce a **Google Cloud session control** window of 1 to 24 hours that applies to Google Cloud OAuth scopes. Once the window elapses, the refresh token for this connection stops working until a user re-authenticates.

<ul>
  <li>In the Google Admin console, go to **Security** > **Access and data control** > **Google Cloud session control**.</li>
  <li>Select **Session never expires**, or add this OAuth app to the trusted (exempted) apps list.</li>
</ul>

## Create the StackOne Connector Profile

**1. Create a Connector Profile**

Enable the connector and create a Connector Profile in your project. See [Setup Connector Profile](https://docs.stackone.com/gateway/quickstart.md#setup-connector-profile).

**2. Link an Account**

Once the Connector Profile is created, continue to [link an account](https://docs.stackone.com/connectors/googleclouddata/guides/link-account/oauth-2-0-multiple-companies.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.