Drive
El almacén de archivos que hay detrás de cada proyecto, de tu cuenta y de los recursos de compilación de Studio, y cómo acceder a cada uno mediante la API.
Drive no es un único almacén de archivos, son tres, cada uno con la misma forma de operaciones pero con su propio ámbito. Cada nombre de método indica sobre cuál actúa mediante su propio sufijo.
Una llamada _workspace o _studio recibe el app_id del proyecto; una llamada _user no, siempre se refiere
al drive de la propia cuenta de quien llama.
Métodos
Operaciones principales, una familia cada vez
Todos los ámbitos tienen las mismas operaciones, solo cambia el sufijo:
Listar e inspeccionar
get_drive_files_<scope> lista el contenido de una carpeta; get_drive_file_info_<scope> lee los detalles de un
elemento.
Subir y organizar
upload_drive_file_<scope> sube un archivo; create_drive_folder_<scope> crea una carpeta;
rename_drive_file_<scope> / rename_drive_folder_<scope> renombra cualquiera de los dos;
move_drive_files_<scope> y copy_drive_files_<scope> mueven o copian un lote de elementos
(ámbitos de usuario y de espacio de trabajo) entre carpetas.
Papelera, restaurar, purgar
En los ámbitos de usuario y de espacio de trabajo, trash_drive_files_<scope> hace una eliminación lógica,
get_trashed_files_<scope> lista lo que hay en la papelera, restore_trashed_files_<scope> devuelve un
elemento y purge_trashed_files_<scope> lo elimina para siempre. El ámbito studio no tiene paso de papelera,
delete_drive_files_studio y delete_file_bulk_studio eliminan directamente, igual que
delete_drive_files_<scope> y delete_file_bulk_<scope> en todos los ámbitos para una eliminación
permanente.
Compartir, marcar, etiquetar
update_drive_file_sharing_mode_<scope> cambia quién puede abrir un archivo;
star_drive_file_<scope> activa o desactiva un marcador; update_drive_file_tags_<scope> establece las etiquetas
de un archivo; get_shared_with_me_files_user lista lo que otras personas han compartido contigo.
Almacenamiento
get_drive_size_<scope> devuelve el total de bytes usados; get_drive_breakdown_<scope> (ámbitos de usuario y de
espacio de trabajo) desglosa el uso por tipo de archivo y por grupos de archivos duplicados.
upload_drive_file_workspace y sus equivalentes reciben el propio archivo como una subida, no como un campo
JSON: la solicitud es un formulario multipart en lugar de un cuerpo JSON simple como en la mayoría de los métodos.