API Scopes

Each app requires a particular set of permissions to access various parts of your Google account. These are called scopes and are visible when you first sign into an app, or from your connected apps page. By authorising an app, the token that grants access will remain on your device only - nowhere else!


Great tools take a lot of building.

Our tools are free for everyone, but we want to make more and make these ones even better. If you want amazing technical support, feature requests and a say in what we build next, please consider supporting us.

Here are all the scopes we use, broken down by app, with a short description of why each permission is needed, and what it is used for. Sometimes, scopes are only required when you try to use a certain part or function within an app. These scopes are only requested at that point in time, and are not required for core functionality. We believe in asking for the minimum number of scopes to allow our apps to function. Extra scopes are only required if you want to use that feature (such as sending an email from one of our apps, for example). These scopes are marked as OPTIONAL in the list below.

View

Producing customised views of your Google Sheets, with easy filtering and sharing

  • Google

    • email - View your email address
    • Why? In order to display the address of your logged in account on the navigation menu, once you have signed in.

    • profile - View your basic profile info
    • Why? In order to display your name on the navigation menu, once you have signed in.

    • https://www.googleapis.com/auth/drive.file - View and manage Google Drive files and folders that you have opened or created with this app
    • Why? In order to display the Google Drive Picker, at least one ‘Drive’ scope is required, and this is the lowest privilege one.

    • https://www.googleapis.com/auth/spreadsheets.readonly - View your Google Spreadsheets
    • Why? This app needs to load data from your spreadsheets in order to display it, but not to write to them.

    • https://www.googleapis.com/auth/drive.readonly - View the files in your Google Drive
    • Why? In order to read previously saved view files, this ‘readonly’ permissions is required.

    • https://www.googleapis.com/auth/urlshortener - Manage your goo.gl short URLs OPTIONAL
    • Why? Once you have created a link to share in this app, you have the option of using the Google Link Shortener to ‘compress’ it. This scope allows access to that feature.

    • https://www.googleapis.com/auth/drive.install - Special scope used to let users approve installation of an app. OPTIONAL
    • Why? Allows you to install the app into your Google Drive, making opening it faster and easier from within the Google Drive Web App.
Folders

Search folders individually, view sizes, starred files and perform bulk conversions

  • Google

    • email - View your email address
    • Why? In order to display the address of your logged in account on the navigation menu, once you have signed in.

    • profile - View your basic profile info
    • Why? In order to display your name on the navigation menu, once you have signed in.

    • https://www.googleapis.com/auth/drive - View and manage the files in your Google Drive
    • Why? In order to search, manage and convert your Drive files.

    • https://www.googleapis.com/auth/drive.install - Special scope used to let users approve installation of an app. OPTIONAL
    • Why? Allows you to install the app into your Google Drive, making opening it faster and easier from within the Google Drive Web App.
Events

Tag and filter your Google Calendar Events

  • Google

    • email - View your email address
    • Why? In order to display the address of your logged in account on the navigation menu, once you have signed in.

    • profile - View your basic profile info
    • Why? In order to display your name on the navigation menu, once you have signed in.

    • https://www.googleapis.com/auth/calendar - Manage your calendars
    • Why? In order to display and manage events from your Google Calendars.
Docket

Organise your days with this simple, diary style, task list that stores your data in your own Google Sheet

  • Google

    • email - View your email address
    • Why? In order to display the address of your logged in account on the navigation menu, once you have signed in.

    • profile - View your basic profile info
    • Why? In order to display your name on the navigation menu, once you have signed in.

    • https://www.googleapis.com/auth/drive.appdata - View and manage its own configuration data in your Google Drive
    • Why? In order to record your settings in Google Drive.

    • https://www.googleapis.com/auth/drive.file - View and manage Google Drive files and folders that you have opened or created with this app
    • Why? In order to create, and read/write data from a Docket Google Sheet, we need access to it.

    • https://www.googleapis.com/auth/calendar.readonly - View your calendars OPTIONAL
    • Why? In order to overlay events from your Google Calendar.

    • https://www.googleapis.com/auth/classroom.courses.readonly - View Classroom courses OPTIONAL
    • Why? In order to read your classes to choose which ones you would like to display deadlines for.

    • https://www.googleapis.com/auth/classroom.coursework.students.readonly - View assignments and questions and the work and grades for the courses that the current user teaches or administers. OPTIONAL
    • Why? In order to read your class assignments and deadlines to display.
© 2015-2018 educ.io