client.apps.files. Chaque méthode prend d’abord l’identifiant de l’application, puis un chemin dans l’application. Les chemins font au maximum 256 caractères.
Les exemples utilisent le client présenté dans Créer le client. app_id est l’identifiant de l’une de vos applications : client.account.me() les liste.
Lister un répertoire
files.list(app_id, path=None) liste un répertoire (la racine de l’application quand path est omis). Contrairement aux autres modificateurs optionnels, path peut être passé par position.
Un répertoire inexistant donne 404
FILE_NOT_FOUND. Un chemin que le gestionnaire de fichiers n’expose pas donne 403 BLOCKED_PATH.
Lire un fichier
files.read(app_id, path) renvoie le contenu du fichier sous forme de bytes. Les fichiers sont limités à 10 Mo : un fichier plus volumineux donne 413 FILE_TOO_LARGE.
Écrire un fichier
files.write(app_id, path, content) crée ou écrase un fichier.
- Une
strest envoyée en texte brut. - Des
bytessont envoyés en base64, de sorte que tout contenu binaire est conservé à l’identique. - Un contenu vide (
''oub'') crée un fichier vide.
FILE_TOO_LARGE (statut 0) avant tout envoi. Un contenu de plus de 1 MiB est envoyé sans timeout une fois connecté, comme un envoi. Pour les fichiers plus volumineux, utilisez apps.commit().
L’écriture ne redémarre pas l’application. Appelez
apps.restart() pour appliquer la modification.Déplacer ou renommer un fichier
Supprimer un fichier
Erreurs
Voir Erreurs pour les codes que chaque appel peut renvoyer.
Prochaines étapes
Variables d'environnement
Lisez et modifiez les variables d’une application.
Référence de l'API du gestionnaire de fichiers
Les endpoints REST derrière ces méthodes.
Gérer les fichiers depuis la CLI
Les mêmes actions depuis le terminal.

