Skip to main content
Cloud SQL Admin and Pub/Sub Admin roles (or Owner) on the target GCP project are required to complete this setup.

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, then open the project picker at the top of the page.

  • New project: Click New project, fill in Project name, Organization and Parent resource, then click Create. Select the new project in the project picker.
  • Existing project: Select it in the project picker.
Select a resource dialog listing the projects in the organization, with the New project button highlighted.
2

Enable the Cloud SQL Admin API and Cloud Pub/Sub API

Open APIs & Services > Library.

  • Search for Cloud SQL Admin API.
  • Click Cloud SQL Admin API.
  • Click Enable. If it shows Manage, it’s already enabled.
  • Repeat for Cloud Pub/Sub API.
  • Cloud Pub/Sub requires billing to be enabled on the project. Open Billing to enable it.
3

Enter the app information

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

  • Click Get started. If the OAuth Overview page opens instead, open Branding from the sidebar.
  • App name: A name that identifies this integration
  • User support email: Email address for user inquiries
  • Click Next.
Branding page of the Google Auth Platform with the App information section, highlighting the App name and User support email fields (email redacted).
4

Select the audience

Choose the user type for your application.

  • Internal: Only users within your Google Workspace organization can authorize (no app verification required)
  • External: Any Google account can authorize (requires app verification for production use)
  • Click Next.
Audience page of the Google Auth Platform with the User type section highlighted, showing the current type and the Make internal button.
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.

  • Email addresses: Email addresses for project notices
  • Click Next.
6

Accept the user data policy

Review your settings.

  • Agree to the Google API Services User Data Policy.
  • Click Create.
7

Publish the app

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

  • Check the Publishing status. If it shows Testing, click Publish app.
  • Confirm the dialog.
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.

  • Click Add or Remove Scopes.
  • Under Manually add scopes in the Update selected scopes side panel, paste each scope listed.
  • Click Add to table.
  • Click Update.
  • On the Data Access page, click Save.
Data Access page of the Google Auth Platform with the Add or remove scopes button highlighted above the list of configured scopes.
9

Create the OAuth client

Open APIs & Services > Credentials.

  • Click Create credentials.
  • Select OAuth client ID.
  • Application type: Web application
  • Name: A name that identifies this OAuth client
  • Under Authorized redirect URIs, click Add URI.
  • Enter the Callback URL from your Connector Profile.
  • Click Create.
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.
10

Copy the Client ID and Client Secret

A dialog shows your Client ID and Client Secret.

  • Copy the Client ID and Client Secret into your Connector Profile.

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.

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

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.
2

Link an Account

Once the Connector Profile is created, continue to link an account.