A pasta de dados do aplicativo é uma pasta oculta especial que o app pode usar para armazenar dados específicos do aplicativo, como arquivos de configuração. A pasta de dados do aplicativo é criada automaticamente quando você tenta criar um arquivo nela. Use essa pasta para armazenar arquivos com os quais o usuário não pode interagir diretamente. Essa pasta só é acessível pelo seu app, e o conteúdo dela fica oculto do usuário e de outros apps do Google Drive.
A pasta de dados do aplicativo é excluída quando um usuário desinstala seu app do Meu Drive. Os usuários também podem excluir a pasta de dados do app manualmente.
Escopo da pasta de dados do aplicativo
Antes de acessar a pasta de dados do aplicativo, solicite acesso ao
escopo não sensível https://www.googleapis.com/auth/drive.appdata
. Para
mais informações sobre os escopos e como solicitar acesso a eles, consulte
Escolher escopos da API Google Drive. Para mais
informações sobre escopos específicos do OAuth 2.0, consulte Escopos do OAuth 2.0 para APIs
do Google.
Qual é a diferença entre a pasta de dados do aplicativo e as pastas de backup do Drive
A pasta de dados do aplicativo é separada da pasta de backup do Drive.
A pasta de dados do aplicativo é uma pasta de configuração criada por
app de terceiros, e cada um deles pode armazenar dados nela. Somente o
aplicativo que criou os dados no appDataFolder
pode acessá-los. Não é possível acessar a
pasta usando a interface do usuário (IU) do Drive.
A pasta de backup do Drive é uma pasta reservada em que o Drive grava backups do dispositivo e que fica visível na interface do Drive.
Restrições na pasta de dados do aplicativo
As restrições a seguir são aplicadas ao trabalhar com a pasta de dados do aplicativo:
Não é possível compartilhar arquivos ou pastas dentro da pasta de dados do aplicativo. A tentativa de fazer isso gera um erro
notSupportedForAppDataFolderFiles
com a seguinte mensagem de erro: "O método não é compatível com arquivos na pasta "Dados do aplicativo".Não é possível mover arquivos no
appDataFolder
entre locais de armazenamento (espaços). A tentativa de fazer isso gera um erronotSupportedForAppDataFolderFiles
com a seguinte mensagem de erro: "O método não é compatível com arquivos na pasta "Dados do aplicativo". Para mais informações, consulte Organização de arquivos.Não é possível excluir arquivos ou pastas dentro da pasta de dados do aplicativo. A tentativa de fazer isso gera um erro
notSupportedForAppDataFolderFiles
com a seguinte mensagem de erro: "Os arquivos na pasta "Dados do aplicativo" não podem ser excluídos."
Criar um arquivo na pasta de dados do aplicativo
Para criar um arquivo na pasta de dados do aplicativo, especifique appDataFolder
na
propriedade parents
do arquivo e use o método
files.create
para criar o arquivo na
pasta.
O exemplo de código abaixo mostra como inserir um arquivo em uma pasta usando uma biblioteca de cliente e um comando curl.
Java
Python
Node.js
PHP
.NET
curl
Request:
curl --request POST \
'https://content.googleapis.com/drive/v3/files' \
-H 'authorization: Bearer ACCESS_TOKEN' \
-H 'content-type: application/json' \
-H 'x-origin: https://explorer.apis.google.com' \
--data-raw '{"name": "config.json", "parents":["appDataFolder"]}'
Substitua ACCESS_TOKEN pelo token OAuth 2.0 do seu app.
Resposta:
{
"kind": "drive#file",
"id": FILE_ID,
"name": "config.json",
"mimeType": "application/json"
}
Para mais informações sobre a criação de arquivos em pastas, consulte Criar e preencher pastas.
Pesquisar arquivos na pasta de dados do aplicativo
Para pesquisar arquivos na pasta de dados do aplicativo, defina o campo spaces
como
appDataFolder
e use o método
files.list
.
O exemplo de código abaixo mostra como pesquisar arquivos na pasta de dados do aplicativo usando uma biblioteca de cliente e um comando curl.
Java
Python
Node.js
PHP
.NET
curl
Request:
curl \
-X GET \
-H "Authorization: Bearer ACCESS_TOKEN" \
"https://www.googleapis.com/drive/v3/files?spaces=appDataFolder&fields=files(id,name,mimeType,size,modifiedTime)"
Substitua ACCESS_TOKEN pelo token OAuth 2.0 do seu app.
Resposta:
{
"files": [
{
"mimeType": "application/json",
"size": "256",
"id": FILE_ID,
"name": "config.json",
"modifiedTime": "2025-04-03T23:40:05.860Z"
},
{
"mimeType": "text/plain",
"size": "128",
"id": FILE_ID,
"name": "user_settings.txt",
"modifiedTime": "2025-04-02T17:52:29.020Z"
}
]
}
Fazer o download de arquivos da pasta de dados do aplicativo
Para fazer o download de um arquivo da pasta de dados do aplicativo, use o método files.get
com o parâmetro de URL alt=media
para
extrair o conteúdo do arquivo no corpo da resposta. Para mais informações e
para conferir exemplos de código, acesse Fazer o download do conteúdo
do blob de arquivo.
O exemplo de código abaixo mostra como fazer o download de arquivos na pasta de dados do aplicativo usando um comando curl. O corpo da resposta varia de acordo com o que é salvo.
curl
Request:
curl \
-X GET \
-H "Authorization: Bearer ACCESS_TOKEN" \
"https://www.googleapis.com/drive/v3/files/FILE_ID?alt=media"
Substitua:
- ACCESS_TOKEN: o token OAuth 2.0 do app.
- FILE_ID: o ID do arquivo que você quer fazer o download.