Note: You are currently viewing documentation for Moodle 3.7. Up-to-date documentation for the latest stable version of Moodle may be available here: Google Drive repository.

Google Drive repository: Difference between revisions

From MoodleDocs
No edit summary
 
(38 intermediate revisions by 4 users not shown)
Line 1: Line 1:
{{Repositories}}
{{Repositories}}
Google Docs can serve both as a Repository from which users can "pull" files they need for their course and also a Portfolio into which they can "push" files they want to keep. Both options need to be enabled by the administrator before they are available for teachers and students.
Google Drive can serve both as a repository from which users can "pull" files they need for their course and also a [[Google Docs portfolio|portfolio]] into which they can "push" files they want to keep. Both options need to be enabled by the administrator before they are available for teachers and students.


== Google Docs as a repository ==
==Enabling the Google Drive repository==
===Enabling the Google Docs repository===
* Go to Site Administration>Plugins>Repositories>Manage Repositories;
* Select from the drop down next to Google Docs "Enabled and visible";
* If desired,click on "Settings" and give Google Docs a customised name (not essential)
[[File:Googledocsrepoenable.png]]


===Getting ("pulling") your files from Google Docs===
To use the Google Drive repository, an administrator must first create a Google service (a new requirement in Moodle 3.3 onwards).
* From the file picker, click on the Google Docs link and a prompt to log in will appear:
[[File:Googledocsfilepicker.png]]
* Click the "grant access" button to log in
* Your files will display for you to choose from:
[[File:Googledocsview.png]]


== Google Docs as a portfolio ==
# Go to 'OAuth 2 services' in Site administration and click the button to create a new Google service.
===Enabling the Google Docs portfolio===
# Follow the instructions in [[OAuth 2 Google service]] and obtain a client ID and secret.
* Go to Site Administration>Advanced features and ensure "Enable portfolios" is checked/ticked
# Enter the client ID and secret and save changes.
* Go to Site Administration>Plugins>Portfolios>Manage Portfolios
# Go to 'Manage repositories' in Site administration and enable the Google Drive repository.
* Select from the drop down next to Google Docs "Enabled and visible";
# On the Google Drive configuration page, make sure that Google is selected as the OAuth 2 service then save changes.
*If desired,click on "Settings" and give Google Docs a customised name (not essential)
 
[[File:Googledocsrepoenable.png]]
In Moodle 3.3 onwards, an admin can set default import file formats on the Google Drive configuration page. For example, the default document import format can be chosen from rtf, docx, html, odt, pdf and txt.
===Sending ("pushing") your files to Google Docs===
 
===Troubleshooting===
 
If you obtain a 'This app isn't verified' message, you will need to complete a [https://support.google.com/code/contact/oauth_app_verification OAuth Developer Verification Form]. The list of scopes that Moodle requires are: <code><nowiki>openid profile email https://www.googleapis.com/auth/drive</nowiki></code>.
 
See the discussion [https://moodle.org/mod/forum/discuss.php?d=356871 Google Drive Repository and Moodle 3.3.1] for more details.
 
==Access controlled links==
 
Students may submit files from Google Drive as 'access controlled links' in [[Using Assignment|assignments]]. Once submitted, the student may no longer change them, but the teacher is allowed to edit them.
 
Teachers may display files from Google Drive as 'access controlled links'. The teacher can then continue updating the files, but students can only view them.
 
To enable this feature, ensure that:
 
# A system account has been connected in [[OAuth 2 services]] in Site administration. This account will own and control access to files submitted by students and teachers. Teachers will be able to edit the files but students will not. This should be a dedicated account for this purpose.
# "Supported files" is set  to "Internal and External".
# "Default return type" is set  to "External (only links stored in Moodle)".
 
==Getting ("pulling") your files from Google Drive==
 
* From the file picker, click on the Google Drive link and a prompt to log in will appear:
 
* If it is your first time, the click the "Allow access" button to log in
 
{|
| [[File:newgoogledocs.png|thumb|Log into your account]]
| [[File:newgooglepermission.png|thumb|Allow access]]
|}
 
* Your files will display for you to choose from.
*You can view them in three ways by clicking one of the options at the top right.
 
{|
| [[File:googledocsrepothumb.png|thumb|Icon view]]
| [[File:googledocstableview.png|thumb|Table view]]
| [[File:googledocslistview.png|thumb|List view]]
|}
 
==Repository capabilities==
 
There is just one capability, [[Capabilities/repository/googledocs:view|View Google Drive repository]], which is allowed for the default authenticated user role.
 
==See also==
 
* [[OAuth 2 authentication]] for enabling users to log in to Moodle with their Google account
* [https://moodle.org/mod/forum/discuss.php?d=355716 Google Drive repository in 3.3 with non-institutional accounts] forum discussion
* [https://moodle.org/mod/forum/discuss.php?d=356871 Google Drive Repository and Moodle 3.3.1] forum discussion
 
[[Category:Site administration]]
[[Category:OAuth 2]]
 
[[de:Google Drive Repository]]
[[es:Repositorio Google Drive]]
[[fr:Google Drive]]

Latest revision as of 14:47, 27 May 2019

Google Drive can serve both as a repository from which users can "pull" files they need for their course and also a portfolio into which they can "push" files they want to keep. Both options need to be enabled by the administrator before they are available for teachers and students.

Enabling the Google Drive repository

To use the Google Drive repository, an administrator must first create a Google service (a new requirement in Moodle 3.3 onwards).

  1. Go to 'OAuth 2 services' in Site administration and click the button to create a new Google service.
  2. Follow the instructions in OAuth 2 Google service and obtain a client ID and secret.
  3. Enter the client ID and secret and save changes.
  4. Go to 'Manage repositories' in Site administration and enable the Google Drive repository.
  5. On the Google Drive configuration page, make sure that Google is selected as the OAuth 2 service then save changes.

In Moodle 3.3 onwards, an admin can set default import file formats on the Google Drive configuration page. For example, the default document import format can be chosen from rtf, docx, html, odt, pdf and txt.

Troubleshooting

If you obtain a 'This app isn't verified' message, you will need to complete a OAuth Developer Verification Form. The list of scopes that Moodle requires are: openid profile email https://www.googleapis.com/auth/drive.

See the discussion Google Drive Repository and Moodle 3.3.1 for more details.

Access controlled links

Students may submit files from Google Drive as 'access controlled links' in assignments. Once submitted, the student may no longer change them, but the teacher is allowed to edit them.

Teachers may display files from Google Drive as 'access controlled links'. The teacher can then continue updating the files, but students can only view them.

To enable this feature, ensure that:

  1. A system account has been connected in OAuth 2 services in Site administration. This account will own and control access to files submitted by students and teachers. Teachers will be able to edit the files but students will not. This should be a dedicated account for this purpose.
  2. "Supported files" is set to "Internal and External".
  3. "Default return type" is set to "External (only links stored in Moodle)".

Getting ("pulling") your files from Google Drive

  • From the file picker, click on the Google Drive link and a prompt to log in will appear:
  • If it is your first time, the click the "Allow access" button to log in
Log into your account
Allow access
  • Your files will display for you to choose from.
  • You can view them in three ways by clicking one of the options at the top right.
Icon view
Table view
List view

Repository capabilities

There is just one capability, View Google Drive repository, which is allowed for the default authenticated user role.

See also