KurlesHS/rclone
1
0
Fork 0
forked from TrueCloudLab/rclone
Code Pull requests Activity

update drive.md

Browse source 
* Updates OAuth consent screen instructions to include adding scopes for backup purposes (create, edit and delete files).
* Updates instructions to keep app in testing mode (appropriate for most users). The previous instructions suggested this, but we don't need to "publish" the app at all in order to proceed with this step.
This commit is contained in:
Simmon Li (he/him) 2023-01-25 23:47:46 -05:00 committed by Nick Craig-Wood
parent dc5d5de35c
commit 82e2801aae
1 changed files with 22 additions and 16 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

38
docs/content/drive.md
View file

@ -1508,9 +1508,15 @@ to the next step; if not, click on "CONFIGURE CONSENT SCREEN" button
(near the top right corner of the right panel), then select "External" (near the top right corner of the right panel), then select "External"
and click on "CREATE"; on the next screen, enter an "Application name" and click on "CREATE"; on the next screen, enter an "Application name"
("rclone" is OK); enter "User Support Email" (your own email is OK); ("rclone" is OK); enter "User Support Email" (your own email is OK);
enter "Developer Contact Email" (your own email is OK); then click on "Save" (all other data is optional). enter "Developer Contact Email" (your own email is OK); then click on
Click again on "Credentials" on the left panel to go back to the "Save" (all other data is optional). You will also have to add some scopes,
"Credentials" screen. including `.../auth/docs` and `.../auth/drive` in order to be able to edit,
create and delete files with RClone. You may also want to include the
`../auth/drive.metadata.readonly` scope. After adding scopes, click
"Save and continue" to add test users. Be sure to add your own account to
the test users. Once you've added yourself as a test user and saved the
changes, click again on "Credentials" on the left panel to go back to
the "Credentials" screen.
(PS: if you are a GSuite user, you could also select "Internal" instead (PS: if you are a GSuite user, you could also select "Internal" instead
of "External" above, but this will restrict API use to Google Workspace of "External" above, but this will restrict API use to Google Workspace
@ -1523,24 +1529,24 @@ then select "OAuth client ID".
8. It will show you a client ID and client secret. Make a note of these. 8. It will show you a client ID and client secret. Make a note of these.
(If you selected "External" at Step 5 continue to "Publish App" in the Steps 9 and 10. (If you selected "External" at Step 5 continue to Step 9.
If you chose "Internal" you don't need to publish and can skip straight to If you chose "Internal" you don't need to publish and can skip straight to
Step 11.) Step 11.)
9. Go to "Oauth consent screen" and press "Publish App" 9. Go to "Oauth consent screen" and confirm that your intended email is shown
as a test user, and that "Publishing status" is shown as "Testing".
10. Click "OAuth consent screen", then click "PUBLISH APP" button and 10. Provide the noted client ID and client secret to rclone.
confirm, or add your account under "Test users".
11. Provide the noted client ID and client secret to rclone. Be aware that, due to the "enhanced security" introduced by Google, you are
theoretically expected to "submit your app for verification" and then wait a
Be aware that, due to the "enhanced security" recently introduced by few weeks(!) for their response; in practice, if you keep your app in testing,
Google, you are theoretically expected to "submit your app for verification" then you can go right ahead and use the client ID and client secret with rclone,
and then wait a few weeks(!) for their response; in practice, you can go right the only issue will be a very scary confirmation screen shown when you connect
ahead and use the client ID and client secret with rclone, the only issue will via your browser for rclone to be able to get its token-id (but as this only
be a very scary confirmation screen shown when you connect via your browser happens during the remote configuration, it's not such a big deal). Because we
for rclone to be able to get its token-id (but as this only happens during anticipate that we will be the only user on this client-id, testing should be
the remote configuration, it's not such a big deal). sufficient for most use cases.
(Thanks to @balazer on github for these instructions.) (Thanks to @balazer on github for these instructions.)