Skip to content
Release: Australia · Updated: 2026-03-12 · Official documentation · View source

Set up the Google Cloud Pub Sub Spoke

Integrate the ServiceNow instance and Google Cloud Pub Sub by creating a custom OAuth application in Google Cloud account to authenticate ServiceNow requests.

Before you begin

  • Request an Integration Hub subscription.
  • Activate the Google Cloud Pub Sub spoke.
  • Role required: admin.

Create a custom application

Create a custom OAuth application in your Google Cloud Platform account to enable OAuth 2.0 authentication with the Google Cloud Pub Sub spoke.

Before you begin

Role required: admin

Procedure

  1. Register a new custom application by navigating to https://console.cloud.google.com/.

  2. Create a project with your administrator credentials, and open the project.

  3. From the APIs & Services menu, select OAuth consent screen, enter the application name, and specify the Authorized domain service-now.com.

  4. Click Save.

  5. From the APIs & Services menu, select Credentials, and select Create OAuth client ID from the Create credentials list.

  6. Select the application type OAuth client ID.

  7. Enter the following Authorized redirect URI: https://<instance>.service-now.com/oauth_redirect.do and click Create.

    The OAuth client window shows your client ID and client secret.

  8. Copy these two values to a text file so that you can use them when you Register Google Cloud Pub Sub as an OAuth provider.

    The client ID and secret can always be accessed in the Google APIs & Services interface. Click Credentials and select the OAuth 2.0 client ID name.

Register Google Cloud Pub Sub as an OAuth provider

Use the information generated during the Google Cloud Pub Sub application configuration to register Google Cloud as an OAuth provider and allow the ServiceNow instance to request OAuth 2.0 tokens.

Before you begin

Role required: admin.

Configure the Google Identity and Access Spoke.

Procedure

  1. Navigate to System OAuth > Application Registry.

  2. Open for the record, Google Cloud Pub Sub.

  3. On the form, fill these values.

    FieldDescription
    Client IDClient ID of the Google Cloud Pub Sub application.
    Client SecretClient Secret of the Google Cloud Pub Sub application.
    OAuth API ScriptOauthGooglePubSubUtils is selected by default.
    Authorization URLThe OAuth authorization code endpoint: https://accounts.google.com/o/oauth2/auth.
    Token URLThe OAuth server token endpoint: https://oauth2.googleapis.com/token.
    Redirect URLOAuth callback endpoint in this format: https://<instance>.service-now.com/oauth_redirect.do. If left blank, the instance auto-generates the URL.
  4. Right-click the form header, and click Save.

Create a credential record for the Google Cloud Pub Sub spoke

Create a credential record for the Google Cloud account. The Google Cloud Pub Sub spoke connection and credential alias uses these credentials to authorize actions.

Before you begin

Role required: admin.

Procedure

  1. Navigate to All > Integration Hub > Connections & Credentials.

  2. Open the record, GoogleCloudPubSub.

  3. In the Credentials tab, click New.

    The system displays this message: What type of Credentials would you like to create?

  4. Select OAuth 2.0 Credentials.

  5. On the form, fill these values.

    FieldDescription
    NameName to identify the credential record. For example, Google Cloud Pub Sub Cred.
    OAuth Entity ProfileSelect the default OAuth entity profile, Google Cloud Pub Sub default_profile.
    Credential aliasCredential alias associated with this record. The default alias record, sn_gc_pubsub_spoke.GoogleCloudPubSub is selected.
Image omitted: gcloud-pub-sub-cred.png
Credential record for the Google Pub Sub spoke.
  1. Right-click the form header and click Save.

  2. To generate the OAuth token, click the Get OAuth Token related link.