Compartilhar via


Tipo de recurso SpecialFolder

O recurso SpecialFolder agrupa itens de dados relacionados a pastas especiais em uma única estrutura.

Se um DriveItem tiver uma faceta specialFolder não nula, o item representará uma pasta especial (nomeada). Pastas especiais que podem ser acessadas diretamente por meio da coleção de pastas especiais.

Pastas especiais fornecem aliases simples para acessar pastas conhecidas sem a necessidade de pesquisar a pasta pelo caminho (o que exigiria a localização) ou fazer referência à pasta com uma ID. Se uma pasta especial for renomeada ou movida para outro local na unidade de disco, esta sintaxe continuará a retornar a pasta.

As pastas especiais são criadas automaticamente na primeira vez que um aplicativo tenta gravar em uma, caso ainda não existam. Se um usuário excluir uma, ela será recriada quando algo for gravado nela novamente.

Observação: Se seu aplicativo solicitou apenas o escopo Files.Read e solicitar uma pasta especial que não exista, a resposta será um erro 403 Forbidden.

Representação JSON

{
  "name": "string"
}

Propriedades

Propriedade Tipo Descrição
name string O identificador exclusivo deste item na coleção /drive/special

Pastas especiais

Aqui estão as pastas especiais disponíveis no OneDrive e OneDrive for Business.

Nome Id da pasta Descrição
Raiz de Aplicativo approot Pasta pessoal do aplicativo. Geralmente em /Apps/{Application Name}
Imagens da Câmera cameraroll A pasta de Backup de Imagens da Câmera.
Área de trabalho desktop A pasta Área de trabalho.
Documentos documents A pasta Documentos.
Música music A pasta Música.
Fotos photos A pasta Fotos.

Comentários

Para saber mais sobre as facetas de um DriveItem, confira DriveItem.