termino una versión razonable de configuración de Google Drive

rclone/README.md

@@ -48,7 +48,7 @@ La sintáxis del comando `rclone` es:
 
 **`rclone`** **_`subcomando`_** _`argumentos y opciones del subcomando`_
 
-El comando **`rclone help`** da un listado de todos los subcomandos disponibles
+El comando **`rclone help`** da un listado de todos los [subcomandos disponibles](https://rclone.org/commands/)
 
 ### Configuración inicial / creación y modificación del archivo de configuración (`rclone.conf`)
 
@@ -74,14 +74,222 @@ En https://rclone.org/#providers está la lista de proveedores de almacenamiento
 
 Por ahora voy a ir poniendo algunas notas sobre lo que yo configuré, pero las instrucciones hay que tomarlas de [allí](https://rclone.org/#providers).
 
-#### [Drive](https://rclone.org/drive/) (Google Drive)
+#### [drive](https://rclone.org/drive/) (Google Drive)
 
-Si bien las instrucciones básicas funcionan bien, es recomendable [crear tu propio client_id para usar la API de Google Drive](GoogleDriveClientID.md) porque la API de Google limita la frecuencia de consultas por client-id y, si no creás y utilizás el tuyo propio, vas a estar usando el propio de rclone que, si bien tiene un límite bastante alto, es compartido por la mayoría de los usuarios de rclone.
+Si bien las instrucciones básicas funcionan bien, es recomendable [crear tu propio client_id para usar la API de Google Drive](GoogleDriveClientID.md) porque la API de Google limita la frecuencia de consultas por client_id y, si no creás y utilizás el tuyo propio, vas a estar usando el propio de rclone que, si bien tiene un límite bastante alto, es compartido por la mayoría de los usuarios de rclone (los que _no_ se toman el laburo de crear su client_id).
 
+Vamos a crear un nuevo remoto llamado **GoogleDriveRemote** usando el comando `rclone config` en forma interactiva:
+```
+$ rclone config
+
+No remotes found - make a new one
+n) New remote
+s) Set configuration password
+q) Quit config
+n/s/q> n
+name> GoogleDriveRemote
+```
+
+Ahora nos muestra un listado completo de todos los _backends_ disponibles para elegir (recorto un poco). Tipeo "_drive_" que es el identificador para Google Drive (el número podría cambiar en una versión distinta de rclone, pero el identificador difícilmente cambie).
+```
+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 / 1Fichier
+   \ "fichier"
+ 2 / Alias for an existing remote
+   \ "alias"
+<SNIP>
+13 / FTP Connection
+   \ "ftp"
+14 / Google Cloud Storage (this is not Google Drive)
+   \ "google cloud storage"
+15 / Google Drive
+   \ "drive"
+16 / Google Photos
+   \ "google photos"
+17 / Hadoop distributed file system
+   \ "hdfs"
+<SNIP>
+41 / http Connection
+   \ "http"
+42 / premiumize.me
+   \ "premiumizeme"
+43 / seafile
+   \ "seafile"
+Storage> drive
+Google Application Client Id
+Setting your own is recommended.
+See https://rclone.org/drive/#making-your-own-client-id for how to create your own.
+If you leave this blank, it will use an internal key which is low performance.
+Enter a string value. Press Enter for the default ("").
+client_id> 
+
+```
+Acá es donde tenemos que poner los datos que obtuvimos al [crear nuestro propio client_id](GoogleDriveClientID.md) (si no lo hicimos, dejamos en blanco).
+```
+Enter a string value. Press Enter for the default ("").
+client_id> 123456789012-unasarasaconl3tr4synum3r0s.apps.googleusercontent.com
+OAuth Client Secret
+Leave blank normally.
+Enter a string value. Press Enter for the default ("").
+client_secret> MuyS3cret03Zto-abcd
+Scope that rclone should use when requesting access from drive.
+Enter a string value. Press Enter for the default ("").
+Choose a number from below, or type in your own value
+ 1 / Full access all files, excluding Application Data Folder.
+   \ "drive"
+ 2 / Read-only access to file metadata and file contents.
+   \ "drive.readonly"
+   / Access to files created by rclone only.
+ 3 | These are visible in the drive website.
+   | File authorization is revoked when the user deauthorizes the app.
+   \ "drive.file"
+   / Allows read and write access to the Application Data folder.
+ 4 | This is not visible in the drive website.
+   \ "drive.appfolder"
+   / Allows read-only access to file metadata but
+ 5 | does not allow any access to read or download file content.
+   \ "drive.metadata.readonly"
+scope> drive
+ID of the root folder
+Leave blank normally.
+
+Fill in to access "Computers" folders (see docs), or for rclone to use
+a non root folder as its starting point.
+
+Enter a string value. Press Enter for the default ("").
+root_folder_id> 
+Service Account Credentials JSON file path 
+Leave blank normally.
+Needed only if you want use SA instead of interactive login.
+
+Leading `~` will be expanded in the file name as will environment variables such as `${RCLONE_CONFIG_DIR}`.
+
+Enter a string value. Press Enter for the default ("").
+service_account_file> 
+Edit advanced config?
+y) Yes
+n) No (default)
+y/n> n
+Use auto config?
+ * Say Y if not sure
+ * Say N if you are working on a remote or headless machine
+
+y) Yes (default)
+n) No
+y/n> y
+2021/08/13 19:43:58 NOTICE: Make sure your Redirect URL is set to "urn:ietf:wg:oauth:2.0:oob" in your custom config.
+2021/08/13 19:43:58 NOTICE: If your browser doesn't open automatically go to the following link: http://127.0.0.1:53682/auth?state=brGZPUOXjAtMBxzMifrDUw
+2021/08/13 19:43:58 NOTICE: Log in and authorize rclone for access
+2021/08/13 19:43:58 NOTICE: Waiting for code...
+```
+Acá va a abrirse una ventana en el navegador para autorizar el acceso al google drive. Si no estás logueado en Google, tenés que loguearte con la cuenta de la cual querés usar el Google Drive.
+
+Si usaste un client_id propio, recién creado, lo primero que te aparece es una ventana diciendo que la aplicación **no está verificada**. Esto es porque no hiciste el proceso de verificación de la aplicación (no tiene sentido hacerlo, ni sé cómo se hace). Si dejaste el campo client_id en blanco, esto no te va a aparecer. Apretá "**Continue**" aunque te recomiende hacer lo contrario.
+
+![continuar con app no verificada](google-auth-allow-00.png)
+
+A continuación te aparece la ventana pidiendo que selecciones qué cosas puede acceder rclone en tu cuenta, con un único ítem que es acceso a leer, modificar, crear y borrar todos los archivos de tu Google Drive. Tenés que seleccionar el _checkbox_ y apretar "**Continue**"
+
+![dar acceso a archivos de Google Drive](google-auth-allow-01.png)
+
+Si todo está bien, te aparece una pantalla diciéndote que vuelvas a rclone (ya podés cerrar la ventana del navegador que estuviste usando)
+
+![fin autorización Google Drive](google-auth-allow-02.png)
+
+De regreso en la consola linux:
+```
+2021/08/13 19:43:58 NOTICE: Make sure your Redirect URL is set to "urn:ietf:wg:oauth:2.0:oob" in your custom config.
+2021/08/13 19:43:58 NOTICE: If your browser doesn't open automatically go to the following link: http://127.0.0.1:53682/auth?state=brGZPUOXjAtMBxzMifrDUw
+2021/08/13 19:43:58 NOTICE: Log in and authorize rclone for access
+2021/08/13 19:43:58 NOTICE: Waiting for code...
+2021/08/13 20:03:01 NOTICE: Got code
+Configure this as a Shared Drive (Team Drive)?
+
+y) Yes
+n) No (default)
+y/n> n
+--------------------
+[GoogleDriveRemote]
+type = drive
+client_id = 123456789012-unasarasaconl3tr4synum3r0s.apps.googleusercontent.com
+client_secret = MuyS3cret03Zto-abcd
+scope = drive
+token = {"access_token":"aca.van_UNmontónDeLetrasYnúm3r0sQueFormanEl_TOKEN-queLeDevolvióGúguelCuandoLoAutorizasteAtenerAccesoAtuGoogleDrive-ESTO_es_IMPORTANTÍSIMO_queNoLoVeaNadie","token_type":"Bearer","refresh_token":"1//másCosasRelacionadasConElToken-queNoTengoMuyEnClaroParaQuéSON-peroIgualEstoQueNoLoVeaNadie1234567890","expiry":"2021-08-13T21:03:00.885058093-03:00"}
+team_drive =
+--------------------
+y) Yes this is OK (default)
+e) Edit this remote
+d) Delete this remote
+y/e/d> y
+Current remotes:
+
+Name                 Type
+====                 ====
+GoogleDriveRemote    drive
+
+e) Edit existing remote
+n) New remote
+d) Delete remote
+r) Rename remote
+c) Copy remote
+s) Set configuration password
+q) Quit config
+e/n/d/r/c/s/q> q
+```
+
+Esto creó (o modificó) el archivo de configuración **`~/.config/rclone/rclone.conf`** y puso los datos para acceder al remoto que mostró al final del proceso allí:
+```
+[GoogleDriveRemote]
+type = drive
+client_id = 123456789012-unasarasaconl3tr4synum3r0s.apps.googleusercontent.com
+client_secret = MuyS3cret03Zto-abcd
+scope = drive
+token = {"access_token":"aca.van_UNmontónDeLetrasYnúm3r0sQueFormanEl_TOKEN-queLeDevolvióGúguelCuandoLoAutorizasteAtenerAccesoAtuGoogleDrive-ESTO_es_IMPORTANTÍSIMO_queNoLoVeaNadie","token_type":"Bearer","refresh_token":"1//másCosasRelacionadasConElToken-queNoTengoMuyEnClaroParaQuéSON-peroIgualEstoQueNoLoVeaNadie1234567890","expiry":"2021-08-13T21:03:00.885058093-03:00"}
+team_drive =
+```
+
+Es **MUY IMPORTANTE** que **_nadie_** tenga acceso a ese archivo, ya que, en particular, la información que está allí es suficiente para entrar al Google Drive sin que pueda volver a pedir autenticación ni autorización (de hecho, podríamos copiar ese pedazo a otra computadora y utilizar rclone directamente).
+
+Ahora puedo usar los subcomandos de `rclone` para acceder al Google Drive usando el nombre del remoto que creé recién (`GoogleDriveRemote`) usando la [sintaxis de los _paths_ remotos](https://rclone.org/docs/#syntax-of-remote-paths).
+
+Para listar las carpetas del primer nivel del drive:
+```
+$ rclone lsd GoogleDriveRemote:
+          -1 2020-09-29 08:35:48        -1 Capacitacion
+          -1 2021-06-04 10:36:25        -1 Entretenimiento
+          -1 2018-06-24 09:52:53        -1 Personal
+          -1 2019-03-05 09:13:16        -1 Trabajo
+```
+
+Para listar todos los archivos en todas las carpetas:
+```
+$ rclone ls GoogleDriveRemote:
+   323014 Archivo en la raíz del drive.pdf
+       -1 Otro archivo en la raíz.docx
+ 12114285 Capacitacion/Curso_aburrido.pptx
+223346379 Entretenimiento/Otra película.mov
+335161310 Entretenimiento/Una película.mp4
+<SNIP>
+  4613162 Capacitacion/No está ordenado.pdf
+```
+
+Para copiar un directorio del disco local al Google Drive:
+```
+rclone copy ~/devel/proyecto_interesante GoogleDriveRemote:Trabajo/proyectoX
+```
+
+
+#### [onedrive](https://rclone.org/onedrive/) (Microsoft OneDrive)
+
+**[Microsoft OneDrive](https://rclone.org/onedrive/)**: Del mismo modo que en Google Drive, se recomienda [crear tu propio client_id](https://rclone.org/onedrive/#getting-your-own-client-id-and-key).
+
+#### [crypt](https://rclone.org/crypt/) (pseudo-remoto para encriptar _otros_ remotos)
+
+**[Crypt](https://rclone.org/crypt/)**: Crypt no es un _backend_ remoto, sino que se usa como una **capa** _encima_ de _otro_ "remoto".
 
-* **[Microsoft OneDrive](https://rclone.org/onedrive/)**: Del mismo modo que en Google Drive, se recomienda [crear tu propio client_id](https://rclone.org/onedrive/#getting-your-own-client-id-and-key).
 
-* **[Crypt](https://rclone.org/crypt/)**: Crypt no es un _backend_ remoto, sino que se usa como una **capa** _encima_ de _otro_ "remoto".
 ___
 <!-- LICENSE -->
 ___