Nota
O acesso a esta página requer autorização. Podes tentar iniciar sessão ou mudar de diretório.
O acesso a esta página requer autorização. Podes tentar mudar de diretório.
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.
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 utilizadores do OneDrive têm sempre, pelo menos, uma unidade disponível, a unidade predefinida. Usuários sem uma licença do OneDrive talvez não tenham uma unidade padrão disponível.
Métodos
| Método | Tipo de retorno | Descrição |
|---|---|---|
| List drive | Coleção drive | Obtenha a lista de recursos de unidade disponíveis para um utilizador de destino, grupo ou site. |
| Obter unidade | unidade | Obtenha metadados sobre uma unidade. |
| Obter raiz da unidade | driveItem | Obtenha a pasta raiz de uma unidade. |
| Listar atividades | Coleção de itemActivity | Liste as atividades que ocorreram na unidade. |
| Listar itens seguidos | Coleção de driveItem | Liste os driveItems seguidos do utilizador. |
| Listar secundários | Coleção de driveItem | Listar subordinados da pasta raiz de uma unidade. |
| Listar alterações | Coleção de driveItem | Liste as alterações para todos os driveItems na unidade. |
| Pesquisa | Coleção de driveItem | Procure driveItems numa unidade. |
| Obter pasta especial | driveItem | Aceda a uma pasta especial com o respetivo nome canónico. |
| Recente (preterido) | Coleção driveItem | Liste um conjunto de itens utilizados recentemente pelo utilizador com sessão iniciada. |
| Partilhado comigo (preterido) | Coleção driveItem | Obtenha uma lista de objetos driveItem partilhados com o proprietário de uma unidade. |
Propriedades
| Propriedade | Tipo | Descrição |
|---|---|---|
| createdBy | identitySet | Identidade do utilizador, dispositivo ou aplicação 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 devolvem personal. OneDrive for Business devolve business. As bibliotecas de documentos do SharePoint devolvem documentLibrary. Somente leitura. |
| id | String | O identificador exclusivo da unidade. Somente leitura. |
| lastModifiedBy | identitySet | Identidade do utilizador, dispositivo e aplicação que modificaram 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. Esta propriedade não é devolvida por predefinição e tem de ser selecionada com o $select parâmetro de consulta. |
| sistema | systemFacet | Se estiver presente, indica que é uma unidade gerida 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. |
| pacotes | Coleção de driveItem | Coleção de pacotes (álbuns e conjuntos de itens compartilhados com seleção múltipla). Somente no OneDrive pessoal. |
| following | Coleção driveItem | A lista de itens que o usuário está seguindo. Somente no OneDrive for Business. |
| 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. |
Representação JSON
Eis uma representação JSON de um recurso de Unidade.
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",
"following": [{"@odata.type": "microsoft.graph.driveItem"}],
"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": "string",
}