Note: This document references views and actions that are only available to Echo Administrators
This document describes how to create a Google Client ID so that Echo users can easily access Google Drive documents (Google docs) as they participate in a course. You will need to have an Echo Admin account to complete this task.
You must have a Google account to accept Google's terms of service for accessing Google Drive from within Echo. As part of the standard Google security and authentication process, Google provides this account's e-mail address to each end-user before they attempt to access Google Drive in Echo.
You can use any account that has Super Admin rights in Google. Our suggested best practice would be to create an account that is only used for authenticating access to Echo. You will need this email address and the password for the next step.
If you use your own account for this project, you run the risk of breaking the integration if your leave and your account is disabled.
Log into Google APIs
Google has a console that allows you to configure any application, such as Echo, to access Google services through their Application Programming Interfaces (APIs). Echo contains code that accesses Google Drive services, but you must enable that code to run in your Echo domain by agreeing to Google's terms of service and setting up a link between Echo and Google by creating a Google API Project.
With the account that you will be using for authentication, log in console.developers.google.com
You will be presented with the following API dashboard. Please note this is an example as your dashboard may appear differently.
Create a Project
- Click on the down arrow from the upper menu bar
- Click on the plus sign to Create Project
Create a name for your project and click Create
Enable Google Drive API
Click on Enable
Under Google Apps APIs, click on Drive API
About this API
In order for Echo to access Google Drive, you will need credentials (Client ID).
- Click on Create credentials
- Click on Help me Choose
Add credentials to your project
Select Google Drive API
- Click on User Data
- Click on What credentials do I need?
1. Use the following URLs, replacing "xxxx" with your school's userspace. (Look at the URL that you use to access Echo - the part before ".echo-ntn.org" is the userspace for your school.
Each URL must be added separately.
NOTE: If you are entering this client ID at the district Domain, you will need to add these Four URLs for each subdomain (School) that is under you.
2. Click on Create client ID
- Enter or update values for Email and Product Name
- Click Continue
- Copy the Client ID to Notepad or Word to use later
- Click on Done
Log into Echo as the Echo Administrator
- From the Domain Tool Details
- Click on Settings (Three Dot's) on the right side
- Select Edit settings
- Click on the Integrations Tab
- Paste the Client ID (If there is already an ID there, paste over it)
Check the Integration
- Log out of Echo (this allows for the new settings to be loaded)
- Log back in and select the Teacher App
- Create a resource using the course editor. Attach a document using the Google Link.
Success will be indicated, when you are ask to agree to the terms of service, and are then allowed access to your Google Drive