client.apps.files. Jede Methode nimmt zuerst die App-ID und dann einen Pfad innerhalb der App. Pfade sind höchstens 256 Zeichen lang.
Die Beispiele verwenden den client aus Client erstellen. app_id ist die ID einer deiner Apps: client.account.me() listet sie auf.
Ein Verzeichnis auflisten
files.list(app_id, path=None) listet ein Verzeichnis auf (das Stammverzeichnis der App, wenn path fehlt). Anders als andere optionale Modifikatoren kann path als Positionsargument übergeben werden.
Ein Verzeichnis, das nicht existiert, ergibt 404
FILE_NOT_FOUND. Ein Pfad, den der Dateimanager nicht freigibt, ergibt 403 BLOCKED_PATH.
Eine Datei lesen
files.read(app_id, path) gibt den Inhalt der Datei als bytes zurück. Dateien sind auf 10 MB begrenzt: Eine größere ergibt 413 FILE_TOO_LARGE.
Eine Datei schreiben
files.write(app_id, path, content) erstellt oder überschreibt eine Datei.
- Ein
strwird als reiner Text gesendet. byteswerden als Base64 gesendet, sodass jeder Binärinhalt unverändert ankommt.- Leerer Inhalt (
''oderb'') erstellt eine leere Datei.
FILE_TOO_LARGE (Status 0) fehl, bevor etwas gesendet wird. Inhalt über 1 MiB wird wie ein Upload nach dem Verbindungsaufbau ohne Timeout gesendet. Für größere Dateien verwende apps.commit().
Das Schreiben startet die App nicht neu. Rufe
apps.restart() auf, um die Änderung anzuwenden.Eine Datei verschieben oder umbenennen
Eine Datei löschen
Fehler
Unter Fehler findest du die Codes, die jeder Aufruf zurückgeben kann.
Nächste Schritte
Umgebungsvariablen
Die Variablen einer App lesen und ändern.
API-Referenz des Dateimanagers
Die REST-Endpunkte hinter diesen Methoden.
Dateien über die CLI verwalten
Dieselben Aktionen im Terminal.

