tipo de recurso specialFolder
Namespace: microsoft.graph
Importante
As APIs na versão /beta
no Microsoft Graph estão sujeitas a alterações. Não há suporte para o uso dessas APIs em aplicativos de produção. Para determinar se uma API está disponível na v1.0, use o seletor Versão.
Agrupa itens de dados especiais relacionados à pasta em uma única estrutura.
Se um driveItem tiver uma faceta especial não nula doFolder , 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.
Os nomes de pastas especiais a seguir estão disponíveis no OneDrive e OneDrive for Business.
Nome | ID da pasta | Descrição |
---|---|---|
Documentos | documents |
A pasta Documentos. |
Fotos | photos |
A pasta Fotos. |
Imagens da Câmera | cameraroll |
A pasta de Backup de Imagens da Câmera. |
Raiz de Aplicativo | approot |
Pasta pessoal do aplicativo. Normalmente em /Apps/{Application Name} . |
Música | music |
A pasta Música. |
Gravações | recordings |
A pasta Gravações. Essa opção só está disponível no OneDrive for Business e no SharePoint Online. |
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
.
Propriedades
Propriedade | Tipo | Descrição |
---|---|---|
name | string | O identificador exclusivo deste item na coleção /drive/special |
Representação JSON
{
"name": "string"
}
Conteúdo relacionado
Para obter mais informações sobre as facetas em um driveItem, consulte driveItem.