Drive
L'archivio di file dietro ogni progetto, il tuo account e gli asset di build di Studio, e come raggiungere ciascuno tramite API.
Drive non è un solo archivio di file, ne sono tre, ciascuno con la stessa forma di operazioni ma un proprio ambito. Ogni nome di metodo indica su quale agisce con il proprio suffisso.
Una chiamata _workspace o _studio accetta l'app_id del progetto; una chiamata _user no, indica sempre
il drive dell'account di chi chiama.
Metodi
Operazioni principali, una famiglia alla volta
Ogni ambito ha le stesse operazioni, cambia solo il suffisso:
Elenca e ispeziona
get_drive_files_<scope> elenca il contenuto di una cartella; get_drive_file_info_<scope> legge i dettagli di un
elemento.
Carica e organizza
upload_drive_file_<scope> carica un file; create_drive_folder_<scope> crea una cartella;
rename_drive_file_<scope> / rename_drive_folder_<scope> rinomina l'una o l'altra;
move_drive_files_<scope> e copy_drive_files_<scope> spostano o copiano un gruppo di elementi
(ambiti user e workspace) tra cartelle.
Cestino, ripristino, eliminazione definitiva
Sugli ambiti user e workspace, trash_drive_files_<scope> elimina in modo non definitivo,
get_trashed_files_<scope> elenca cosa c'è nel cestino, restore_trashed_files_<scope> riporta indietro un
elemento e purge_trashed_files_<scope> lo rimuove per sempre. L'ambito studio non ha il passaggio del
cestino, delete_drive_files_studio e delete_file_bulk_studio eliminano subito, allo stesso modo in cui
delete_drive_files_<scope> e delete_file_bulk_<scope> fanno su ogni ambito per una rimozione definitiva.
Condividi, contrassegna, assegna tag
update_drive_file_sharing_mode_<scope> cambia chi può aprire un file;
star_drive_file_<scope> attiva o disattiva un segnalibro; update_drive_file_tags_<scope> imposta i tag di un file;
get_shared_with_me_files_user elenca ciò che altre persone hanno condiviso con te.
Spazio di archiviazione
get_drive_size_<scope> restituisce i byte totali usati; get_drive_breakdown_<scope> (ambiti user e
workspace) suddivide l'utilizzo per tipo di file più gruppi di file duplicati.
upload_drive_file_workspace e i suoi simili accettano il file stesso come caricamento, non come campo
JSON, la richiesta è un modulo multipart invece di un semplice corpo JSON come per la maggior parte dei metodi.