Skip to main content

Google Workspace

Introduction to Google Workspace Integration for Administrators

Google Workspace can be integrated with Blackboard. When Google Workspace is enabled at your institution, instructors can access files from their Google Drives and link the files to their Ultra courses. Files include documents, slides, and sheets created in Google Drive.

Instructors can link Google Workspace files to the course content area, learning modules, and folders. Any changes instructors make to the Google Workspace file are applied to every link the instructor has added.

Note

Only files in an instructor's My Drive folder can be linked to a course through Google Workspace.

To integrate Google Workspace, you need to

  1. Configure Google Workspace in Google Cloud

  2. Register Google Workspace in Blackboard

  3. Turn on Google Workspace integration in Blackboard

Configure Google Workspace in Google Cloud

You need to configure your institution’s settings in your Google Cloud, also known as your Google Developer Account. Google Cloud is outside of Blackboard and must be accessed using your credentials for Google.  Follow the steps provided in Configure Google Workspace in Google Cloud (PDF). The linked PDF contains a worked example for Google Cloud configuration.

Use this table to identify your redirect URI. You need this URI to complete the Google Cloud configuration.

Table 58. Table of client IDs for different regions

Client ID

Region

Redirect URI

57dfd374-a957-4352-a6f8-9cf398a554eb

us-east-1

us.prod.bb-google-service.api.blackboard.com/google-service/api/v1/googleCallback

136cad97-f53f-4719-a320-be308424864b

eu-central-1

eu.prod.bb-google-service.api.blackboard.com/google-service/api/v1/googleCallback

4f3043a9-2687-4f2b-8014-7d662142f3eb

ca-central-1

ca.prod.bb-google-service.api.blackboard.com/google-service/api/v1/googleCallback

43dcf283-7e70-4594-9caa-30a16ce2b605

ap-southeast-2

au.prod.bb-google-service.api.blackboard.com/google-service/api/v1/googleCallback

c4cb2aff-2f3f-4cc3-93a4-2fa7dd317d0d

ap-southeast-1

sg.prod.bb-google-service.api.blackboard.com/google-service/api/v1/googleCallback

b863c2bb-2b80-45d1-af82-1a3e152eaaa8

ap-northeast-2

kr.prod.bb-google-service.api.blackboard.com/google-service/api/v1/googleCallback

5cf09ba6-60be-4b5b-aaf9-61f7f3c0be9c

af-south-1

sa.prod.bb-google-service.api.blackboard.com/google-service/api/v1/googleCallback



The following information must be created in Google Cloud to complete your institution’s integration with Google:

  • Client ID

  • API Key

  • Client Secret

  • Service account name

  • Service account credential file

  • Shared drive ID

You can get the Shared drive ID by copying the folder ID for your institution’s Workspace. You can find the folder ID by copying what appears in the URL field of your browser when you access the folder. Copy everything that appears after drive.google.com/drive/u/1/folders/

The UI for Google Workspace with the folder URL in the URL field of the browser highlighted in blue. The part of the URL that should be copied is highlighted in green.

Enable APIs from the APP Library. Visit Google's help site to enable Google APIs. You must select the following APIs:

  • Google Drive API

  • Google Picker API

Register Google Workspace in Blackboard

  1. In your institution’s Administrator Panel in Blackboard, select LTI Tool Providers in the Integrations category.

  2. Select Register LTI 1.3 Tool.

  3. In the Client ID field, type or copy and paste the Client ID for your region.

    Region

    Client ID

    us-east-1

    57dfd374-a957-4352-a6f8-9cf398a554eb

    eu-central-1

    136cad97-f53f-4719-a320-be308424864b

    ca-central-1

    4f3043a9-2687-4f2b-8014-7d662142f3eb

    ap-southeast-2

    43dcf283-7e70-4594-9caa-30a16ce2b605

    ap-southeast-1

    c4cb2aff-2f3f-4cc3-93a4-2fa7dd317d0d

    ap-northeast-2

    b863c2bb-2b80-45d1-af82-1a3e152eaaa8

    af-south-1

    5cf09ba6-60be-4b5b-aaf9-61f7f3c0be9c

  4. Select Submit.

  5. Review all settings that were automatically filled in the Tool Status view. Make sure that the Tool Status button is set to Approved.

  6. In Institution Policies, all settings are on by default. We recommend leaving all settings on, in case your institution decides to use more settings later.

  7. Select Submit to finish LTI 1.3 registration. Google Integration now displays as an option on the Administrator Panel under the Tools and Utilities category.

Adding the client ID configures different Google integration placements in Blackboard by default.

  • Google LTI links in the content outline

  • Administrator settings

  • Google LTI links in the Content Market

Turn on Google Workspace integration in Blackboard

  1. Select the Google Integration page under Tools and Utilities in the Administrator Panel in Blackboard.

    The Administrator Panel in Blackboard, with the link for Google Integrations highlighted at the bottom right

  2. Complete all the required fields with the information that you got from Google Cloud when you configured your Workspace. If your institution has two Google Workspaces, select Connect another Google Workspace to enter information for the second Google Workspace.

    Note

    All students need to have the institution role of Student to be able to access Google content added to the course by the instructor.

    Google Integration page, showing the required fields for completing integration, with the Connect another Google Workspace toggle highlighted

  3. Select Submit to turn on Google Workspace integration for your institution.