onedrive: graph: update docs

docs/content/onedrive.md

@@ -22,51 +22,36 @@ Here is an example of how to make a remote called `remote`.  First run:
 This will guide you through an interactive setup process:
 
 ```
-No remotes found - make a new one
+e) Edit existing remote
 n) New remote
+d) Delete remote
+r) Rename remote
+c) Copy remote
 s) Set configuration password
-n/s> n
+q) Quit config
+e/n/d/r/c/s/q> n
 name> remote
 Type of storage to configure.
+Enter a string value. Press Enter for the default ("").
 Choose a number from below, or type in your own value
- 1 / Amazon Drive
+...
-   \ "amazon cloud drive"
+17 / Microsoft OneDrive
- 2 / Amazon S3 (also Dreamhost, Ceph, Minio)
-   \ "s3"
- 3 / Backblaze B2
-   \ "b2"
- 4 / Dropbox
-   \ "dropbox"
- 5 / Encrypt/Decrypt a remote
-   \ "crypt"
- 6 / Google Cloud Storage (this is not Google Drive)
-   \ "google cloud storage"
- 7 / Google Drive
-   \ "drive"
- 8 / Hubic
-   \ "hubic"
- 9 / Local Disk
-   \ "local"
-10 / Microsoft OneDrive
    \ "onedrive"
-11 / Openstack Swift (Rackspace Cloud Files, Memset Memstore, OVH)
+...
-   \ "swift"
+Storage> 17
-12 / SSH/SFTP Connection
+Microsoft App Client Id
-   \ "sftp"
+Leave blank normally.
-13 / Yandex Disk
+Enter a string value. Press Enter for the default ("").
-   \ "yandex"
-Storage> 10
-Microsoft App Client Id - leave blank normally.
 client_id>
-Microsoft App Client Secret - leave blank normally.
+Microsoft App Client Secret
+Leave blank normally.
+Enter a string value. Press Enter for the default ("").
 client_secret>
+Edit advanced config? (y/n)
+y) Yes
+n) No
+y/n> n
 Remote config
-Choose OneDrive account type?
- * Say b for a OneDrive business account
- * Say p for a personal OneDrive account
-b) Business
-p) Personal
-b/p> p
 Use auto config?
  * Say Y if not sure
  * Say N if you are working on a remote or headless machine
@@ -77,11 +62,32 @@ If your browser doesn't open automatically go to the following link: http://127.
 Log in and authorize rclone for access
 Waiting for code...
 Got code
+Choose a number from below, or type in an existing value
+ 1 / OneDrive Personal or Business
+   \ "onedrive"
+ 2 / Sharepoint site
+   \ "sharepoint"
+ 3 / Type in driveID
+   \ "driveid"
+ 4 / Type in SiteID
+   \ "siteid"
+ 5 / Search a Sharepoint site
+   \ "search"
+Your choice> 1
+Found 1 drives, please select the one you want to use:
+0: OneDrive (business) id=b!Eqwertyuiopasdfghjklzxcvbnm-7mnbvcxzlkjhgfdsapoiuytrewqk
+Chose drive to use:> 0
+Found drive 'root' of type 'business', URL: https://org-my.sharepoint.com/personal/you/Documents
+Is that okay?
+y) Yes
+n) No
+y/n> y
 --------------------
 [remote]
-client_id =
+type = onedrive
-client_secret =
+token = {"access_token":"youraccesstoken","token_type":"Bearer","refresh_token":"yourrefreshtoken","expiry":"2018-08-26T22:39:52.486512262+08:00"}
-token = {"access_token":"XXXXXX"}
+drive_id = b!Eqwertyuiopasdfghjklzxcvbnm-7mnbvcxzlkjhgfdsapoiuytrewqk
+drive_type = business
 --------------------
 y) Yes this is OK
 e) Edit this remote
@@ -112,20 +118,23 @@ To copy a local directory to an OneDrive directory called backup
 
     rclone copy /home/source remote:backup
 
-### OneDrive for Business ###
+### Getting your own Client ID and Key ###
 
-There is additional support for OneDrive for Business.
+rclone uses a pair of Client ID and Key shared by all rclone users when performing requests by default.
-Select "b" when ask
+If you are having problems with them (E.g., seeing a lot of throttling), you can get your own
-```
+Client ID and Key by following the steps below:
-Choose OneDrive account type?
+
- * Say b for a OneDrive business account
+1. Open https://apps.dev.microsoft.com/#/appList, then click `Add an app` (Choose `Converged applications` if applicable)
- * Say p for a personal OneDrive account
+2. Enter a name for your app, and click continue. Copy and keep the `Application Id` under the app name for later use.
-b) Business
+3. Under section `Application Secrets`, click `Generate New Password`. Copy and keep that password for later use.
-p) Personal
+4. Under section `Platforms`, click `Add platform`, then `Web`. Enter `http://localhost:53682/` in
-b/p>
+`Redirect URLs`.
-```
+5. Under section `Microsoft Graph Permissions`, `Add` these `delegated permissions`:
-After that rclone requires an authentication of your account. The application will first authenticate your account, then query the OneDrive resource URL
+`Files.Read`, `Files.ReadWrite`, `Files.Read.All`, `Files.ReadWrite.All`, `offline_access`, `User.Read`.
-and do a second (silent) authentication for this resource URL.
+6. Scroll to the bottom and click `Save`.
+
+Now the application is complete. Run `rclone config` to create or edit a OneDrive remote.
+Supply the app ID and password as Client ID and Secret, respectively. rclone will walk you through the remaining steps.
 
 ### Modified time and hashes ###