Set up Google Hangouts spoke

  • Release version: Washingtondc
  • Updated August 3, 2023
  • 2 minutes to read

    • Integrate a ServiceNow instance and Google Hangouts by using G Suite credentials to authenticate ServiceNow requests.

    Before you begin

    • Request Integration Hub subscription.
    • Activate the Google Hangouts spoke.
    • Role required: admin

    Configure the Google Hangouts application

    Create a custom OAuth application from your G Suite account to enable OAuth 2.0 authentication with the Google Hangouts spoke.

    Before you begin

    Google Hangouts integration requirements:
    • A domain and an email address associated with the domain. For example, www.mydomain.com and jane-admin@mydomain.com. You can only register one email address per domain in G Suite.
    • A Google G Suite or login created with the domain.

    Role required: admin

    About this task

    Complete these steps from your Google G Suite account. See the G Suite product documentation for instructions on creating and configuring custom applications.

    Procedure

    1. Register a new custom application.
      1. Navigate to https://console.developers.google.com.
      2. Create a project with your G Suite administrator credentials, and open the project.
    2. From the APIs & Services menu, select OAuth consent screen, enter the application name, specify the Authorized domain service-now.com, and then select Save.
    3. Search for the Google Hangouts API and enable it.
    4. From the APIs & Services menu, select Credentials, and select Create OAuth client ID from the Create credentials list.
    5. Select the application type Web application.
    6. Enter the following Authorized redirect URI: https://<instance>.service-now.com/oauth_redirect.do and select Create.
      This redirect URI must match the Redirect URL you provide when you configure a connection for the Google Hangouts spoke.
    7. In the OAuth client window, copy your client ID and client secret to a text file so that you can use them when you configure a connection for the Google Hangouts spoke.
      The client ID and secret can be accessed in the Google APIs & Services interface. Select Credentials and select the OAuth 2.0 client ID name.

    Configure a connection for the Google Hangouts spoke

    Add and configure a Google Hangouts connection to authenticate ServiceNow requests in Google Hangouts spoke.

    Before you begin

    Role required: admin

    Procedure

    1. Navigate to Process Automation > Workflow Studio.
    2. Select the Integrations tab.
    3. Select the Connections tab.
    4. In the Search all connections field, enter Google_Hangouts.
    5. On the Google_Hangouts card, select View Details.
      Google Hangouts spoke alias card.
    6. Select Configure.
      Button to open Google Hangout connection form.
    7. On the Connection form, fill in the fields.
      Field Description
      Connection Name Name to identify the connection record. For example, Google_Hangouts.
      Connection URL Enter the URL https://www.googleapis.com/.
      OAuth Entity Name Name to identify the OAuth entity record. For example, Google Hangout entity.1.
      OAuth Client ID Enter the Client ID of the Google Hangouts application you created in G Suite.
      OAuth Client Secret Enter the Client Secret you generated when you created the application in G Suite.
      OAuth Redirect URL Redirect URL of your ServiceNow instance in this format: https://<ServiceNow-Instance-Name>.service-now.com/oauth_redirect.do.
      Google Hangout connection form.
    8. Click Configure and Get OAuth Token.
    9. Log in to Google to get the OAuth token.

    Result

    The spoke connection is configured and ready to be used.