Compartilhar via


Transferir conteúdos de um recurso driveItemVersion

Namespace: microsoft.graph

Obtenha o conteúdo de uma versão específica de um driveItem.

Nota: A obtenção do conteúdo da versão atual não é suportada. Para tal, utilize o método Transferir o conteúdo de um driveItem .

Esta API está disponível nas seguintes implementações de cloud nacionais.

Serviço global US Government L4 US Government L5 (DOD) China operada pela 21Vianet

Permissões

Escolha a permissão ou permissões marcadas como menos privilegiadas para esta API. Utilize uma permissão ou permissões com privilégios mais elevados apenas se a sua aplicação o exigir. Para obter detalhes sobre as permissões delegadas e de aplicação, veja Tipos de permissão. Para saber mais sobre estas permissões, veja a referência de permissões.

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

Observação

O SharePoint Embedded requer a FileStorageContainer.Selected permissão para aceder ao conteúdo do contentor. Esta permissão é diferente das mencionadas anteriormente. Além das permissões do Microsoft Graph, a sua aplicação tem de ter as permissões de tipo de contentor necessárias para chamar esta API. Para obter mais informações, veja Autorização e autenticação do SharePoint Embedded.

Solicitação HTTP

GET /drives/{drive-id}/items/{item-id}/versions/{version-id}/content
GET /groups/{group-id}/drive/items/{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

Cabeçalhos de solicitação

Nome Descrição
Autorização {token} de portador. Obrigatório. Saiba mais sobre autenticação e autorização.

Resposta

Devolve um 302 Found redirecionamento de resposta para um URL de transferência pré-autenticado para os bytes do ficheiro.

Para transferir o conteúdo do ficheiro, a sua aplicação tem de seguir o Location cabeçalho na resposta. Várias bibliotecas de cliente HTTP seguirão automaticamente o redirecionamento 302 e começarão a baixar imediatamente o arquivo.

Os URLs de transferência pré-autenticados só são válidos por um curto período de tempo (alguns minutos) e não necessitam de um Authorization cabeçalho para transferir.

Exemplo

Este exemplo recupera uma versão de um arquivo na unidade do usuário atual.

Solicitação

GET /me/drive/items/{item-id}/versions/{version-id}/content

Resposta

A chamada devolve um redirecionamento para o local onde os conteúdos da versão podem ser transferidos.

HTTP/1.1 302 Found
Location: https://onedrive.com/34FF49D6...

Comentários

O OneDrive não preserva os metadados completos para versões anteriores de um ficheiro.

Quando a sua aplicação obtém a lista de versões disponíveis para um ficheiro, é devolvido um recurso driveItemVersion que fornece as informações disponíveis sobre a versão específica.