Skip to main content
Project Owner or Editor privileges in Google Cloud are required to complete this setup. The Google account that connects needs Logging and/or Monitoring Viewer (read) or Admin (write) on the target project.

Create a Google Cloud OAuth client

Set up a Google Cloud project with the Cloud Logging API and Cloud Monitoring 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 Logging API and Cloud Monitoring API

Open APIs & Services > Library.

  • Search for Cloud Logging API.
  • Click Cloud Logging API.
  • Click Enable. If it shows Manage, it’s already enabled.
  • Repeat for Cloud Monitoring API.
Product details page for the Cloud Logging API in the API Library, showing the API Enabled status with the Enable/Manage button highlighted.
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

Add the scopes

Enables actions: Create Alert Policy, Create Dashboard, Create Exclusion, Create Group, Create Log Metric, Create Notification Channel, Create Service, Create Service Level Objective, Create Sink, Create Uptime Check Config, Delete Alert Policy, Delete Dashboard, Delete Exclusion, Delete Group, Delete Log, Delete Log Metric, Delete Notification Channel, Delete Service, Delete Service Level Objective, Delete Sink, Delete Uptime Check Config, Get Alert Policy, Get Dashboard, Get Exclusion, Get Group, Get Log Metric, Get Metric Descriptor, Get Notification Channel, Get Service, Get Service Level Objective, Get Sink, Get Uptime Check Config, List Alert Policies, List Dashboards, List Exclusions, List Group Members, List Groups, List Log Entries, List Log Metrics, List Logs, List Metric Descriptors, List Monitored Resource Descriptors, List Notification Channels, List Service Level Objectives, List Services, List Sinks, List Time Series, List Uptime Check Configs, Send Notification Channel Verification Code, Test Auth (Cloud Logging), Test Auth (Cloud Monitoring), Update Alert Policy, Update Dashboard, Update Exclusion, Update Group, Update Log Metric, Update Notification Channel, Update Service, Update Service Level Objective, Update Sink, Update Uptime Check Config, Verify Notification Channel, Write Log Entries

In Google Auth Platform, open Data Access. Add https://www.googleapis.com/auth/cloud-platform.read-only and every scope listed.

  • Click Add or Remove Scopes.
  • Under Manually add scopes in the Update selected scopes side panel, paste each scope.
  • 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.
8

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

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.

Exempt the app from session control

Google Workspace administrators can enforce a Google Cloud session control window of 1 to 24 hours on Google Cloud OAuth scopes, which requires interactive re-authentication.

  • Never expires: In the Google Admin console, open Security > Access and data control > Google Cloud session control and select Session never expires.
  • Trusted app: In the Google Admin console, 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.