Zum Inhalt springen
Geprüft

Drive

Der Dateispeicher hinter jedem Projekt, deinem Konto und den Build-Assets von Studio, und wie du jeden über die API erreichst.

Drive ist nicht ein Dateispeicher, sondern drei, jeder mit derselben Form von Operationen, aber eigenem Geltungsbereich. Jeder Methodenname sagt mit seinem eigenen Suffix, auf welchen er wirkt.

Ein _workspace- oder _studio-Aufruf nimmt die app_id des Projekts; ein _user-Aufruf nicht, er meint immer den eigenen Konto-Drive des Aufrufers.

Methoden

Zentrale Operationen, eine Familie nach der anderen

Jeder Geltungsbereich bietet dieselben Operationen, nur das Suffix ändert sich:

Auflisten und ansehen

get_drive_files_<scope> listet den Inhalt eines Ordners auf; get_drive_file_info_<scope> liest die Details eines Elements.

Hochladen und organisieren

upload_drive_file_<scope> lädt eine Datei hoch; create_drive_folder_<scope> legt einen Ordner an; rename_drive_file_<scope> / rename_drive_folder_<scope> benennt beides um; move_drive_files_<scope> und copy_drive_files_<scope> verschieben oder kopieren einen Stapel von Elementen (Geltungsbereiche user und workspace) zwischen Ordnern.

Papierkorb, wiederherstellen, endgültig löschen

In den Geltungsbereichen user und workspace löscht trash_drive_files_<scope> weich, get_trashed_files_<scope> listet auf, was im Papierkorb liegt, restore_trashed_files_<scope> holt ein Element zurück, und purge_trashed_files_<scope> entfernt es endgültig. Der Geltungsbereich studio hat keinen Papierkorb-Schritt, delete_drive_files_studio und delete_file_bulk_studio löschen sofort, genauso wie delete_drive_files_<scope> und delete_file_bulk_<scope> in jedem Geltungsbereich für ein endgültiges Entfernen.

Teilen, mit Stern markieren, taggen

update_drive_file_sharing_mode_<scope> ändert, wer eine Datei öffnen kann; star_drive_file_<scope> schaltet ein Lesezeichen um; update_drive_file_tags_<scope> setzt die Tags einer Datei; get_shared_with_me_files_user listet auf, was andere Personen mit dir geteilt haben.

Speicher

get_drive_size_<scope> gibt die insgesamt belegten Bytes zurück; get_drive_breakdown_<scope> (Geltungsbereiche user und workspace) schlüsselt die Nutzung nach Dateityp auf und liefert dazu Gruppen doppelter Dateien.

Eine Datei hochladen

upload_drive_file_workspace und seine Geschwister nehmen die Datei selbst als Upload, nicht als JSON-Feld, die Anfrage ist ein Multipart-Formular und kein einfacher JSON-Body, wie bei den meisten Methoden.