This document introduces the Google Apps integration as noted in the Canvas Production Release Notes (2017-01-07).
The Google Apps LTI can be configured manually by users who have permission to add and edit LTI tools.
When enabled, the Google LTI adds functionality to multiple areas in Canvas courses.
Canvas has improved its integration with Google Apps making it easier for instructors to include collaborations, content sharing, engaging course content, and assignment distribution directly within Canvas. The integration also makes it easy for students to collaborate with instructors and fellow students on individual or group assignments.
Google Apps is an external app (LTI) available to institutions with Google Apps for education. However, anyone with a Google account can use this integration.
The Google Apps LTI supports Google Drive in Canvas and can be enabled at the account, sub-account, or course level in a Canvas production environment. The LTI must be configured manually by users who have permission to add and edit LTI tools.
United States: Users can generate their own key and secret to install the LTI tool through the EduAppCenter Google app page. Instructors in Free-for-Teacher accounts can add the LTI to individual courses.
Worldwide Regions: Users should contact their Canvas Customer Success Manager (CSM) for region-specific configuration credentials. Google is not currently available for instructors in Free-for-Teacher accounts.
Note: Once the Google Apps LTI is added to a production environment, the institution's beta environment will adapt the settings from the production environment on the next beta refresh, which will allow users to test the integration in beta. However, please note that the integration is still subject to all feature limitations that may exist in the beta environment.
This integration is not affiliated with the current Google Drive web service in Canvas. If instructors and students already have Google Drive set up as a web service, they will still have to authenticate through the LTI.
The Google Drive web service should be disabled by a Canvas admin in the Account Settings page. Retaining the web service may cause confusion for students, who would otherwise see tabs for both Google Drive and Google Doc when uploading a file submission.
Documentation for the Google Apps LTI and related Google Drive features can be found using the Google Drive tag in the Canvas Guides.
As part of the Canvas integration, some functionality is limited by Google. Users should be aware of the following limitations by Google in Canvas:
Canvas admins can set up Google as an authentication method so users can sign into Canvas using their Google credentials. However, the LTI integration itself does not support single sign-on (SSO) authentication. After users log in to Canvas using Google, they will also have to authenticate into the Google LTI.
The Google LTI adds a link to the user’s Google Drive in the Course Navigation Menu. The name of the link aligns with the name added as part of the Google LTI (most commonly Google Drive). Users can authorize the Google Apps LTI to view their Google Drive account. If authorization to Google Drive is not successful the first time, authorize the application again.
After logging in to Google Drive, users can view everything in their My Drive folder. They can also open files in a new browser window and edit files directly.
Users can only authenticate into one Google Drive account at a time. If users need to authenticate into Google Drive using a different account, users can open the User Settings page, remove the integration, and then authenticate again using the new Google Drive account.
Note: The approved integration shows that the token has a short lifespan, but Canvas gives the app a refresh token that can be used to get new tokens when necessary. Users can still use the integration even if the expiration has passed.
Instructors can create an online embedded assignment through an external tool. With the Google Apps external tool, this assignment type creates a view of the assignment file that acts as a template for a student’s assignment submission. Accepted assignment types are Google Docs, Spreadsheets, and Presentations.
When students open the assignment, Google Drive will create a copy of the file in the student’s Google Drive folder for the course for each student’s submission. Depending on how the document is configured, they may not need to log in. The students can update the document per the assignment instructions and submit it without leaving the page. If students want to view the version of their cloud document submitted for the assignment, they can view the document in the assignment details page.
Instructors view each student’s document copy in SpeedGrader for grading.
Instructors can also continue to create regular file upload assignments. However, when instructor allows file uploads, students can view the Google Drive tab and upload files directly from Google Drive.
Note: When the Google Apps LTI is enabled, this feature no longer requires students to set up Google Drive as a web service. If the web service is still enabled, students will view tabs for both Google Drive and Google Docs.
SpeedGrader displays any uploaded file type that is supported like other Canvas assignments. Some files cannot be previewed in SpeedGrader and have to be downloaded for viewing. However, SpeedGrader does support previews for native Google file types.
Users can create collaborations with documents, spreadsheets, or presentations. The creator can add individual users or groups from the course to participate in the collaboration. Collaborators can be added or removed at any time, but once a user is added to the collaboration, the user always has access to the collaboration in the user’s Google Drive folder. Collaborations require a name before they can be saved.
Google Apps complements Canvas with an updated Collaborations page. The page design update is controlled by the External Collaborations Tool feature option, which can be enabled by a Canvas admin and must be enabled in the same location as the Google LTI app (course or account).
Note: This feature option is not available in the beta environment.
Users can access their Google Drive folder from the Course Navigation Menu. Google Apps does not display a folder directly in a user’s Files page.
Like other uploaded files in Canvas, student submissions are copied to a student’s submissions folder in user files if the file was uploaded using the File Upload or Google Drive upload assignment options. However, cloud assignment submissions are copied into the student’s Google Drive folder.
Google Apps displays as a Modules external tool. Instructors can add links to Google Drive documents as an external tool.
Google Apps displays a Google Drive icon in the Rich Content Editor. The icon displays everything in a user’s Google Drive account and allows users to display documents as inline links or embed them directly. Students and teachers can view the icon anywhere they can access the Rich Content Editor, such as discussions and pages (as allowed).
If the icon does not display directly in the tool bar, the icon is included in the More External Tools drop-down menu.
The following functionality relates to Google Apps in the Canvas by Instructure app and SpeedGrader app:
Canvas by Instructure
For any other contrary behaviors in the production environment, users should submit a Canvas support case for assistance.
This brings up a good point. If students or staff have a similar issue, can Canvas support assist? Are there some recommended fixes we can have our people try? I assume the first step would be to login to their Google account outside of Canvas to ensure the login is correct. After that, however, call Canvas support?
I've seen discussions about this and Canvas support is trying to find the source of the problem. First try and see if you can log in using an incognito window; if you can, the credentials may be misconfigured. If not, let our support team know so they can continue to investigate.
After adding the Google Apps, I started to test to make sure all would go well. The problem I'm running into is if a student is trying to connect to a collaboration with a google doc, they try to login with one of there google accounts and it doesn't work, their connection is broken. They don't get an option to re-authenticate it just fails. They can never connect to that document. logging out and logging back into Canvas doesn't help. There is no way to repair it, or back out. Are others running into this same issue? Any suggestions?
I've sense removed Google Apps until we can get this under control.
It means that existing collaborations can no longer be accessed through Canvas. However, once a collaboration is shared with a user, the collaboration can always be accessed through Google Drive. So users could still access the collaborations in their Google Drive; they just wouldn't be able to get there through Canvas anymore. So if you're in the middle of a course that is actively using a collaboration, you probably wouldn't want to enable that feature option until you are finished with the course, or at least until you are ready to discontinue access to any previous collaborations directly through Canvas.
Hope that helps!
Our team just updated the Google LTI so that now you can use the search function to locate any file in your My Drive folder, not just within the folder you are currently viewing.
Hope that helps!
CanvasLIVE has launched a series of presentations on the new Google Apps LTI, and you'll find the complete lineup of events here. (And we'll promote each individual event in this space as its date approaches.) RSVP “yes” to an event if you will be there--and if you’re interested, but your schedule doesn’t allow you to attend in real time, RSVP "no" or "maybe" to receive all event updates. Your RSVP ensures that you will receive a notification should the event be cancelled or changed.
I tried logging in using an incognito window, and it worked! Now, because this worked, you said the "credentials may be misconfigured." Does this mean something with Canvas or the Google Apps LTI is still not working right? Or is the problem on my end?
It may be a conflict such as being logged into another Google app. Incognito windows don't have any existing login data so it shows that the configuration is working. So perhaps in your non-incognito window, compare your active logins in Google and see if one conflicts with another.