community
/
rclone
3
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

drive: update docs to clarify access to "Computers" tab #1773

This commit is contained in:
Nick Craig-Wood 2018-01-30 10:31:49 +00:00
parent cf6d522d2f
commit 11fe3fdc16
2 changed files with 23 additions and 12 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

2
backend/drive/drive.go
View File

@ -158,7 +158,7 @@ func init() {
}}, }},
}, { }, {
Name: "root_folder_id", Name: "root_folder_id",
Help: "ID of the root folder - leave blank normally. Fill in to access Backup and Sync folders.", Help: "ID of the root folder - leave blank normally. Fill in to access \"Computers\" folders. (see docs).",
}, { }, {
Name: "service_account_file", Name: "service_account_file",
Help: "Service Account Credentials JSON file path - leave blank normally.\nNeeded only if you want use SA instead of interactive login.", Help: "Service Account Credentials JSON file path - leave blank normally.\nNeeded only if you want use SA instead of interactive login.",

33
docs/content/drive.md
View File

@ -58,7 +58,7 @@ Choose a number from below, or type in your own value
5 | does not allow any access to read or download file content. 5 | does not allow any access to read or download file content.
\ "drive.metadata.readonly" \ "drive.metadata.readonly"
scope> 1 scope> 1
ID of the root folder - leave blank normally. Fill in to access Backup and Sync folders. ID of the root folder - leave blank normally. Fill in to access "Computers" folders. (see docs).
root_folder_id> root_folder_id>
Service Account Credentials JSON file path - needed only if you want use SA instead of interactive login. Service Account Credentials JSON file path - needed only if you want use SA instead of interactive login.
service_account_file> service_account_file>
@ -162,25 +162,36 @@ directories.
### Root folder ID ### ### Root folder ID ###
You can set the `root_folder_id` for rclone. This is the directory You can set the `root_folder_id` for rclone. This is the directory
that rclone considers to be a the root of your drive. Normally you (identified by its `Folder ID`) that rclone considers to be a the root
will leave this blank and rclone will determine the correct root to of your drive.
use itself.
However you can set this to restrict rclone to a specific folder or to Normally you will leave this blank and rclone will determine the
access the Backup and Sync "Computers" Folders/Files. In order to do correct root to use itself.
this you will have to find the Folder ID of the folder you wish rclone
to display. This will be the last segment of the URL when you open However you can set this to restrict rclone to a specific folder
the folder. So if the folder/computer backup you want to show looks hierarchy or to access data within the "Computers" tab on the drive
like web interface (where files from Google's Backup and Sync desktop
program go).
In order to do this you will have to find the `Folder ID` of the
directory you wish rclone to display. This will be the last segment
of the URL when you open the relevant folder in the drive web
interface.
So if the folder you want rclone to use has a URL which looks like
`https://drive.google.com/drive/folders/1XyfxxxxxxxxxxxxxxxxxxxxxxxxxKHCh` `https://drive.google.com/drive/folders/1XyfxxxxxxxxxxxxxxxxxxxxxxxxxKHCh`
in the browser, then you use `1XyfxxxxxxxxxxxxxxxxxxxxxxxxxKHCh` as in the browser, then you use `1XyfxxxxxxxxxxxxxxxxxxxxxxxxxKHCh` as
the `root_folder_id` in the config. the `root_folder_id` in the config.
**NB** the "Computers" Folders seem to be read only. **NB** folders under the "Computers" tab seem to be read only (drive
gives a 500 error) when using rclone.
There doesn't appear to be an API to discover the folder IDs of the There doesn't appear to be an API to discover the folder IDs of the
"Computers" tab - please contact us if you know otherwise! "Computers" tab - please contact us if you know otherwise!
Note also that rclone can't access any data under the "Backups" tab on
the google drive web interface yet.
### Service Account support ### ### Service Account support ###
You can set up rclone with Google Drive in an unattended mode, You can set up rclone with Google Drive in an unattended mode,