Saltar al contenido
Verificada

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.

Subir un archivo

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.