Obter um recurso DriveItem

  • Artigo

Recupere os metadados de um DriveItem em um Drive por ID ou caminho do sistema de arquivos.

Permissões

Uma das seguintes permissões é necessária para chamar esta API. Para saber mais, incluindo como escolher permissões, confira Permissões.

Tipo de permissão Permissões (da com menos para a com mais privilégios)
Delegado (conta corporativa ou de estudante) Files.Read, Files.ReadWrite, Files.Read.All, Files.ReadWrite.All, Sites.Read.All, Sites.ReadWrite.All
Delegado (conta pessoal da Microsoft) Files.Read, Files.ReadWrite, Files.Read.All, Files.ReadWrite.All
Aplicativo Files.Read.All, Files.ReadWrite.All, Sites.Read.All, Sites.ReadWrite.All

Solicitação HTTP

GET /drives/{drive-id}/items/{item-id}
GET /drives/{drive-id}/root:/{item-path}
GET /groups/{group-id}/drive/items/{item-id}
GET /groups/{group-id}/drive/root:/{item-path}
GET /me/drive/items/{item-id}
GET /me/drive/root:/{item-path}
GET /sites/{siteId}/drive/items/{itemId}
GET /sites/{siteId}/drive/root:/{item-path}
GET /users/{userId}/drive/items/{itemId}
GET /users/{userId}/drive/root:/{item-path}

Parâmetros de consulta opcionais

Este método suporta os $expandparâmetros de consulta OData e $select para personalizar a resposta.

É possível usar o parâmetro de cadeia de caracteres de consulta $expand para incluir os filhos de um item na mesma chamada de recuperação de metadados de um item se item tiver um relacionamento children.

Cabeçalhos de solicitação opcionais

Nome Valor Descrição
if-none-match String Se este cabeçalho de solicitação estiver incluso e a eTag (ou cTag) fornecida corresponder à marca atual do arquivo, uma resposta HTTP 304 Not Modified será exibida.

Resposta

Se bem sucedido, este método retorna o código de resposta 200 OK e o recurso DriveItem no corpo da resposta.

Exemplo

Solicitação

Eis um exemplo de solicitação para a pasta raiz do OneDrive do usuário.

GET /me/drive/root

Resposta

Veja a seguir um exemplo da resposta.

HTTP/1.1 200 OK
Content-type: application/json

{
  "createdBy": {
      "user": {
          "id": "efee1b77-fb3b-4f65-99d6-274c11914d12",
          "displayName": "Ryan Gregg"
      }
  },
  "createdDateTime": "2016-03-21T20:01:37Z",
  "cTag": "\"c:{86EB4C8E-D20D-46B9-AD41-23B8868DDA8A},0\"",
  "eTag": "\"{86EB4C8E-D20D-46B9-AD41-23B8868DDA8A},1\"",
  "folder": { "childCount": 120 },
  "id": "01NKDM7HMOJTVYMDOSXFDK2QJDXCDI3WUK",
  "lastModifiedBy": {
      "user": {
          "id": "efee1b77-fb3b-4f65-99d6-274c11914d12",
          "displayName": "Ryan Gregg"
      }
  },
  "lastModifiedDateTime": "2016-03-21T20:01:37Z",
  "name": "OneDrive",
  "root": { },
  "size": 157286400,
  "webUrl": "https://contoso-my.sharepoint.com/personal/rgregg_contoso_com/Documents"
}

Solicitações HEAD

Na maioria dos casos, uma solicitação HEAD terá o mesmo comportamento que uma solicitação GET.

Existem algumas diferenças:

  1. Solicitações HEAD retornarão apenas os cabeçalhos das solicitações GET correspondentes. Essa é uma prática padrão para uma resposta HEAD.
  2. As solicitações CABEÇALHO não provisionam automaticamente uma pasta especial. Em vez disso, se uma pasta especial não estiver presente, um erro 404 será retornado.

Neste exemplo, você pode ver que, se solicitar a raiz do OneDrive, a resposta será simplesmente 200 OK.

Solicitação HTTP

HEAD /drive/root
Accept: application/json

Resposta

HTTP/1.1 200 OK

Comentários

Confira mais informações sobre como os erros são retornados em Respostas de Erros.