Compartilhar via

Usar uma pasta de aplicativo para armazenar conteúdo de usuário sem acesso a todos os arquivos

  • Artigo

A Pasta de aplicativos é uma pasta dedicada especial para o aplicativo. O nome da Pasta de Aplicativos normalmente segue o nome do aplicativo e está na pasta Aplicativos do OneDrive do usuário. Se você solicitar o escopo de permissão Files.ReadWrite.AppFolder e o usuário o autorizar, o aplicativo receberá acesso de leitura e gravação para essa pasta. Como ela se comporta como qualquer outra pasta no OneDrive do usuário, os usuários podem adicionar, modificar e remover conteúdo dela. O aplicativo não precisa manter uma lógica exclusiva para o usuário, o que permite ao usuário renomeá-la ou movê-la.

Receber autorização do usuário

Para ter sua própria pasta de aplicativo, você deve solicitar o escopo de permissão Files.ReadWrite.AppFolder ou Files.ReadWrite ao obter um token de acesso. Para saber mais, consulte autenticação.

Criar a pasta do aplicativo

O OneDrive cria a pasta do aplicativo na pasta Apps do usuário, localizada na raiz do OneDrive do usuário, quando o aplicativo faz a primeira chamada para a pasta usando o namespace pasta especial. Abaixo estão as chamadas mais comuns que o aplicativo pode fazer para criar a pasta pela primeira vez.

Nomear a pasta do aplicativo

Quando o OneDrive cria a pasta do aplicativo, ele usa o nome do Aplicativo definido nesse ponto para a ID de aplicativo de chamada. Você pode alterar o nome da pasta do aplicativo na página de registros de Aplicativos do Azure. Se optar por fazer isso, você poderá localizar o nome da pasta do aplicativo acessando a página de registros dos Aplicativos do Azure e editando as configurações de localização do aplicativo. Alterar o nome da pasta do aplicativo na página Azure App registros não renomeará pastas especiais existentes associadas ao seu aplicativo.

Trabalhar com pastas do aplicativo

A pasta do aplicativo dá suporte a todas as operações item padrão.

Tarefa comum Método HTTP (pelo caminho)
Recuperar metadados de um Item GET /drive/special/approot:/{path}
Listar filhos de um Item GET /drive/special/approot:/{path}:/children
Criar um Item PUT /drive/special/approot:/{parent-path}/{name}
Carregar conteúdo do Item PUT /drive/special/approot:/{parent-path}/{name}:/content
Atualizar conteúdo do Item PATCH /drive/special/approot:/{path}
Excluir um Item DELETE /drive/special/approot:/{path}
Mover um Item PATCH /drive/special/approot:/{path}
Copiar um Item POST /drive/special/approot:/{path}:/action.copy
Baixar o conteúdo do Item GET /drive/special/approot:/{path}:/content
Baixar o formato de arquivo específico GET /drive/special/approot:/{path}:/content?format={format}
Procurar um Item GET /drive/special/approot:/{path}:/search
Exibir alterações em um Item GET /drive/special/approot:/{path}:/delta
Obter miniaturas para um Item GET /drive/special/approot:/{path}:/thumbnails