For teachers and students to utilize Writable’s Google integration, your district will need to set Writable up as a third-party app with access to different parts of the Google Accounts. This will allow teachers and students to use Google Single Sign On and embedded Google Docs.
On this page:
Set up Writable's App Access
To add Writable as an app for your Google users, browse to the App Access Control page for Apps in the Google Admin Console: https://admin.google.com/ac/owl/list?tab=apps
Find Writable in your list of Connected apps. If Writable is already listed, skip to the section titled Trust Writable. If Writable is not listed, proceed to the section titled Add Writable.
Add Writable as an App
1. To add Writable, click the 'Add app' button next to the Connected Apps header, then select 'OAuth App Name or Client ID' from the dropdown menu:
2. Paste the following value into the field labeled Search OAuth app name or client ID:
4484613952-qcp2tgtlm9m5vs7j3ea69e486fcrl16p.apps.googleusercontent.com
3. Click 'SEARCH' and select the Writable app. Then click 'ADD'.
4. After a moment you will see a confirmation message: “Writable is now trusted to access all Google services”.
Adjust Writable Access
If the Writable app is already listed but the Access column reports “Limited” rather than “Trusted” you will need to adjust this to take advantage of all Writable's Google integration features.
1. Hover over the Writable row and click the 'Change access' link.
2. Select Trusted: Can access all Google services and click 'CHANGE'.
Note: At the end of this doc is a detailed listing of the Restricted Google Scopes which we may request for your domain users on-demand depending on which features are utilized.
That’s it. Your domain users should now be able to access all of our Google-related features!
About Google Scopes
Writable is a web-based K-12 Education app with a significant depth of Google Drive and Google Classroom integration. Scopes that Google deems “restricted” are those that require the app to be marked as Trusted within your domain.
The following is a comprehensive listing of the restricted scopes we may request for your students and teachers to access certain features and how we use them. Just so you know, we never request Offline access, as such these permissions are only available while users are actively using Writable.
Note: This list is subject to change as new integration points are developed.
Used to retrieve the current list of Courses for the logged in teacher and display them within our app. If the teacher selects a course to be synchronized, the course is imported as a group within Writable and additional APIs are required as follows.
Used to retrieve the current list of students associated with the selected course as it’s being imported. The API is used subsequently to continuously re-synchronize the list of students.
Used to supply email addresses while generating new Writable users from the list of students retrieved for synchronized courses.
Used to supply profile photos while generating new Writable users from the list of students retrieved for synchronized courses.
Used to generate new Coursework assignments in students' Classroom streams when a teacher opts to synchronize a Writable assignment with Classroom. This scope also allows for reading turned-in student docs while logged in as the teacher, which are then imported into Writable as student submissions.
Used to allow student users to mark their classroom assignments as Submitted (Turned-In) directly from the Writing and Reviewing pages of our app.
Used by teacher users to attach new Coursework template documents for assignments and by student users to export their work from Writable to Google Docs either for turning in a Classroom assignment or for sharing as a standalone GDoc. Also used by teachers apart from Classroom to generate an exported Google Sheet containing a list of rubrics associated with their assignments so they can be modified and/or shared.
Used by teacher users to retrieve the list of files in their drive (displayed via File Picker Dialog) to select Google Sheets containing rubrics to import into Writable. Also used by student users to find “notes” (any Google Doc) which can be attached to their work in Writable for their own reference while they write.
Used by teacher users to read the contents of Google Sheets containing rubrics to import into Writable. Also used by student users to read the contents of GDocs associated with classroom assignments.
Set up Google Docs SDK API
To allow students and teachers to use embedded Google Docs in Writable assignments, you'll need to make sure the Drive SDK is enabled.
1. Browse the Features and Applications page for Drive and Docs settings in the Google Admin Console:
2. If the entry for Drive SDK shows OFF, click the pencil icon to the right of it. That will bring up an expanded view.
3. Check the option to 'Allow users to access Google Drive with the Drive SDK API' and then click 'SAVE'.
[Optional] Some organizations may not wish to make the Google Drive SDK available to all third-party apps. In that case, you can follow these steps to restrict Drive access to only Trusted apps, that you have explicitly permitted at the domain level.
1. Browse the App Access Control page for Google Services:
2. Hover over the Drive row and click 'Change Access'.
3. Select the option labeled Restricted: Only trusted apps can access a service and click 'CHANGE'.