Introduction to Google Workspace Integration for Administrators

Google Workspace can be integrated with Learn. 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.

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. Register Google Workspace in Learn
  2. Configure Google Workspace in Google Cloud
  3. Turn on Google Workspace integration in Learn

Step two will require you to access Google’s official documentation.

Register Google Workspace in Learn

1. In your institution’s Administrator Panel in Learn, 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.

Table of client IDs for different regions
RegionClient ID
us-east-157dfd374-a957-4352-a6f8-9cf398a554eb
eu-central-1136cad97-f53f-4719-a320-be308424864b
ca-central-14f3043a9-2687-4f2b-8014-7d662142f3eb
ap-southeast-243dcf283-7e70-4594-9caa-30a16ce2b605
ap-southeast-1c4cb2aff-2f3f-4cc3-93a4-2fa7dd317d0d
ap-northeast-2b863c2bb-2b80-45d1-af82-1a3e152eaaa8
af-south-15cf09ba6-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 Learn by default.

  • Google LTI links in the content outline
  • Administrator settings
  • Google LTI links in the Content Market

Configure Google Workspace in Google Cloud

Learn supports multiple domains configured under one primary domain that is registered in Google Cloud. If your institution manages multiple domains (for example, one for instructors and one for students), you can add a user alias domain or secondary domain in Google Cloud. Follow the steps on Google Workplace Admin Help.

You need to configure your institution’s settings in your Google Cloud, also known as your Google Developer Account. Google Cloud is outside of Learn and must be accessed using your credentials for Google. Follow the steps outlined below. 

You can view a worked example of these steps in PDF. Detailed information is provided in the Google documentation linked in each step below.

1. Set up a new project. Visit Google's help site for how to set up a new project for your institution.

2. Set up a consent screen. Visit Google's help site for how to set up a consent screen for your institution. To complete the setup of the consent screen, you will need to add the scope by manually entering the URL https://www.googleapis.com/auth/drive in your Google Developer Account.

3. Google Client Configuration. Visit Google's help site for how to set up Google Client Configuration. Use this table to identify your redirect URI. You need this URI to complete this step. 

Table of client IDs for different regions
Client IDRegionRedirect URI
57dfd374-a957-4352-a6f8-9cf398a554ebus-east-1us.prod.bb-google-service.api.blackboard.com/google-service/api/v1/googleCallback
136cad97-f53f-4719-a320-be308424864beu-central-1eu.prod.bb-google-service.api.blackboard.com/google-service/api/v1/googleCallback
4f3043a9-2687-4f2b-8014-7d662142f3ebca-central-1ca.prod.bb-google-service.api.blackboard.com/google-service/api/v1/googleCallback
43dcf283-7e70-4594-9caa-30a16ce2b605ap-southeast-2au.prod.bb-google-service.api.blackboard.com/google-service/api/v1/googleCallback
c4cb2aff-2f3f-4cc3-93a4-2fa7dd317d0dap-southeast-1sg.prod.bb-google-service.api.blackboard.com/google-service/api/v1/googleCallback
b863c2bb-2b80-45d1-af82-1a3e152eaaa8ap-northeast-2kr.prod.bb-google-service.api.blackboard.com/google-service/api/v1/googleCallback
5cf09ba6-60be-4b5b-aaf9-61f7f3c0be9caf-south-1sa.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

Visit the Google Workspace help site for how to get all of the required information.

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/

Image of the UI for Google Workspace with the folder URL in the URL field of the browser

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

  1. Google Drive API
  2. Google Picker API

Turn on Google Workspace integration in Learn

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

Image of the Administrator Panel in Learn, with the link for Google Integration highlighted at the bottom

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. 

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 button highlighted

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