Tipo de unidade de recurso
O recurso drive é o objeto de nível superior que representa o OneDrive de um usuário ou uma biblioteca de documentos no SharePoint.
Os usuários do OneDrive sempre terão pelo menos uma unidade disponível, sua unidade padrão. Usuários sem uma licença do OneDrive talvez não tenham uma unidade padrão disponível.
Representação JSON
Veja a seguir uma representação JSON de um recurso Drive.
O recurso drive é derivado de baseItem e herda propriedades desse recurso.
{
"activities": [{"@odata.type": "microsoft.graph.itemActivity"}],
"id": "string",
"createdBy": { "@odata.type": "microsoft.graph.identitySet" },
"createdDateTime": "string (timestamp)",
"description": "string",
"driveType": "personal | business | documentLibrary",
"items": [ { "@odata.type": "microsoft.graph.driveItem" } ],
"lastModifiedBy": { "@odata.type": "microsoft.graph.identitySet" },
"lastModifiedDateTime": "string (timestamp)",
"name": "string",
"owner": { "@odata.type": "microsoft.graph.identitySet" },
"quota": { "@odata.type": "microsoft.graph.quota" },
"root": { "@odata.type": "microsoft.graph.driveItem" },
"sharepointIds": { "@odata.type": "microsoft.graph.sharepointIds" },
"special": [ { "@odata.type": "microsoft.graph.driveItem" }],
"system": { "@odata.type": "microsoft.graph.systemFacet" },
"webUrl": "url"
}
Propriedades
| Propriedade | Tipo | Descrição |
|---|---|---|
| createdBy | identitySet | Identidade do usuário, dispositivo ou aplicativo que criou o item. Somente leitura. |
| createdDateTime | dateTimeOffset | Data e hora de criação do item. Somente leitura. |
| description | String | Fornecer uma descrição visível para os usuários da unidade. Leitura e gravação. |
| driveType | String | Descreve o tipo de unidade representado por esse recurso. As unidades pessoais do OneDrive retornarão personal. O OneDrive for Business retornará business. As bibliotecas de documentos do SharePoint retornarão documentLibrary. Somente leitura. |
| id | String | O identificador exclusivo da unidade. Somente leitura. |
| lastModifiedBy | identitySet | Identidade do usuário, dispositivo e aplicativo que modificou o item pela última vez. Somente leitura. |
| lastModifiedDateTime | dateTimeOffset | Data e hora em que o item foi modificado pela última vez. Somente leitura. |
| name | string | O nome do item. Leitura e gravação. |
| owner | identitySet | Opcional. A conta do usuário que é proprietário da unidade. Somente leitura. |
| quota | quota | Opcional. Informações sobre a cota de espaço de armazenamento da unidade. Somente leitura. |
| sharepointIds | sharepointIds | Retorna os identificadores úteis para fins de compatibilidade do REST do SharePoint. Somente leitura. |
| sistema | systemFacet | Se estiver presente, indica que se trata de uma unidade gerenciada pelo sistema. Somente leitura. |
| webUrl | string (url) | URL que exibe o recurso no navegador. Somente leitura. |
Relações
| Relação | Tipo | Descrição |
|---|---|---|
| activities | Conjunto itemActivity | A lista de atividades recentes que ocorreram nesta unidade. |
| items | Coleção DriveItem | Todos os itens contidos na unidade. Somente leitura. Anulável. |
| root | DriveItem | A pasta raiz da unidade. Somente leitura. |
| special | Coleção DriveItem | Coleção de pastas comuns disponíveis no OneDrive. Somente leitura. Anulável. |
| list | List | Para unidades no SharePoint, a lista de biblioteca de documentos subjacentes. Somente leitura. Anulável. |
Métodos
| Tarefa comum | Método HTTP |
|---|---|
| Recuperar metadados de outra Unidade | GET /drives/{drive-id} |
| Recuperar a pasta raiz da Unidade padrão do usuário | GET /drive/root |
| Liste as atividades na Unidade | GET /drive/activities |
| Listar filhos na Unidade | GET /drive/root/children |
| Listar alterações de todos os Itens na Unidade | GET /drive/root/delta |
| Pesquisar Itens na Unidade | GET /drive/root/search |
| Acessar pasta especial | GET /drive/special/{name} |
Na tabela anterior, os exemplos usam /drive, mas outros caminhos também são válidos.