Baixar conteúdo de um recurso DriveItemVersion
Recuperar o conteúdo de uma versão específica de um DriveItem.
Permissões
Uma das permissões a seguir é necessária para chamar essa 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}/versions/{version-id}/content
GET /groups/{group-id}/drive/{item-id}/versions/{version-id}/content
GET /me/drive/items/{item-id}/versions/{version-id}/content
GET /sites/{site-id}/drive/items/{item-id}/versions/{version-id}/content
GET /users/{user-id}/drive/items/{item-id}/versions/{version-id}/content
Resposta
Retorna uma resposta 302 Found que redireciona para uma URL de download previamente autenticada para os bytes do arquivo.
Para baixar o conteúdo do arquivo, seu aplicativo precisa seguir o cabeçalho Location na resposta.
Várias bibliotecas de cliente HTTP seguirão automaticamente o redirecionamento 302 e começarão a baixar imediatamente o arquivo.
URLs de download previamente autenticadas são válidas apenas por um curto período de tempo (alguns minutos) e não exigem um cabeçalho Authorization para download.
Exemplo
Este exemplo recupera uma versão de um arquivo na unidade do usuário atual.
Solicitação HTTP
GET /me/drive/items/{item-id}/versions/{version-id}/content
Resposta
Isso retorna um redirecionamento para onde o conteúdo da versão pode ser baixado.
HTTP/1.1 302 Found
Location: https://onedrive.com/34FF49D6...
Comentários
O OneDrive não preserva os metadados completos de versões anteriores de um arquivo.
Quando seu aplicativo recupera a lista de versões disponíveis de um arquivo, um recurso DriveItemVersion é retornado e fornece as informações disponíveis sobre a versão específica.