Le dossier de données d'application est un dossier masqué spécial que votre application peut utiliser pour stocker des données spécifiques à l'application, telles que des fichiers de configuration. Le dossier de données d'application est créé automatiquement lorsque vous tentez d'y créer un fichier. Utilisez ce dossier pour stocker tous les fichiers avec lesquels l'utilisateur ne doit pas interagir directement. Ce dossier n'est accessible que par votre application, et son contenu est masqué pour l'utilisateur et les autres applications Drive.
Les fichiers de appDataFolder
ne peuvent pas se déplacer entre les emplacements de stockage (espaces). Pour en savoir plus, consultez la section Organisation des fichiers.
Le dossier de données de l'application est supprimé lorsqu'un utilisateur désinstalle votre application de son dossier MonDrive. Les utilisateurs peuvent également supprimer manuellement le dossier de données de votre application.
Champ d'application du dossier des données d'application
Avant de pouvoir accéder au dossier de données de l'application, vous devez demander l'accès au champ d'application https://www.googleapis.com/auth/drive.appdata
. Pour en savoir plus sur les champs d'application et sur la manière de demander l'accès à ceux-ci, consultez les informations d'autorisation et d'authentification spécifiques aux API. Pour en savoir plus sur les champs d'application OAuth 2.0 spécifiques, consultez Champs d'application OAuth 2.0 pour les API Google.
Créer un fichier dans le dossier de données de l'application
Pour créer un fichier dans le dossier de données de l'application, spécifiez appDataFolder
dans la propriété parents
du fichier et utilisez la méthode files.create
pour importer le fichier dans le dossier. L'exemple de code suivant montre comment insérer un fichier dans un dossier à l'aide d'une bibliothèque cliente.
Java
Python
Node.js
PHP
.NET
Pour en savoir plus sur la création de fichiers dans des dossiers, consultez Créer et insérer des dossiers.
Rechercher des fichiers dans le dossier de données de l'application
Pour rechercher des fichiers dans le dossier de données de l'application, définissez le champ spaces
sur appDataFolder
et utilisez la méthode files.list
. L'exemple de code suivant montre comment rechercher des fichiers dans le dossier de données de l'application à l'aide d'une bibliothèque cliente.
Java
Python
Node.js
PHP
.NET
Télécharger des fichiers depuis le dossier de données de l'application
Pour télécharger un fichier à partir du dossier de données de l'application, utilisez la méthode files.get
. Pour en savoir plus et afficher des exemples de code, consultez la section Télécharger le contenu du fichier blob.