Descargar contenido de driveItem

Espacio de nombres: microsoft.graph

Descargue el contenido de la secuencia principal (archivo) de un objeto driveItem. Solo se pueden descargar los objetos driveItem con la propiedad file .

Para obtener el identificador del elemento que se va a descargar, consulte Obtener driveItem.

Esta API está disponible en las siguientes implementaciones en la nube nacional.

Permissions

Elija el permiso o los permisos marcados como con privilegios mínimos para esta API. Use uno o varios permisos con privilegios más altos solo si la aplicación lo requiere. Para obtener más información sobre los permisos delegados y de aplicación, consulte Tipos de permisos. Para obtener más información sobre estos permisos, consulte la referencia de permisos.

Solicitud HTTP

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

Encabezados de solicitud

Ejemplo

En el siguiente ejemplo se muestra una solicitud sobre cómo descargar un archivo completo.

Solicitud

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

// Code snippets are only available for the latest version. Current version is 5.x

// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
await graphClient.Drives["{drive-id}"].Items["{driveItem-id}"].Content.GetAsync();

// Code snippets are only available for the latest major version. Current major version is $v0.*

// Dependencies
import (
	  "context"
	  msgraphsdk "github.com/microsoftgraph/msgraph-beta-sdk-go"
	  //other-imports
)


// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=go
graphClient.Drives().ByDriveId("drive-id").Items().ByDriveItemId("driveItem-id").Content().Get(context.Background(), nil)

// Code snippets are only available for the latest version. Current version is 6.x

GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);

graphClient.drives().byDriveId("{drive-id}").items().byDriveItemId("{driveItem-id}").content().get();

const options = {
	authProvider,
};

const client = Client.init(options);

let stream = await client.api('/me/drive/items/{item-id}/content')
	.version('beta')
	.get();

<?php
use Microsoft\Graph\Beta\GraphServiceClient;


$graphServiceClient = new GraphServiceClient($tokenRequestContext, $scopes);


$graphServiceClient->drives()->byDriveId('drive-id')->items()->byDriveItemId('driveItem-id')->content()->get()->wait();

Import-Module Microsoft.Graph.Beta.Files

Get-MgBetaDriveItemContent -DriveId $driveId -DriveItemId $driveItemId

# Code snippets are only available for the latest version. Current version is 1.x
from msgraph_beta import GraphServiceClient
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python

await graph_client.drives.by_drive_id('drive-id').items.by_drive_item_id('driveItem-id').content.get()

Respuesta

En el ejemplo siguiente se muestra la respuesta.

Devuelve una 302 Found respuesta que redirige a una dirección URL de descarga previamente autenticada para el archivo. Es la misma dirección URL disponible a través de la @microsoft.graph.downloadUrl propiedad en DriveItem.

Para descargar el contenido del archivo, la aplicación debe seguir el encabezado de Location la respuesta. Muchas bibliotecas cliente HTTP siguen la redirección 302 y comienzan a descargar el archivo inmediatamente.

Las direcciones URL de descarga autenticadas previamente solo son válidas durante un breve período de tiempo (unos minutos) y no requieren un Authorization encabezado para descargarse.

HTTP/1.1 302 Found
Location: https://b0mpua-by3301.files.1drv.com/y23vmagahszhxzlcvhasdhasghasodfi

Descargar archivos en aplicaciones de JavaScript

Para descargar archivos en una aplicación JavaScript, no puede usar la /content API, ya que responde con una 302 redirección. Una 302 redirección está explícitamente prohibida cuando se requiere una comprobación previade Uso compartido de recursos entre orígenes (CORS), como cuando se proporciona el encabezado de autorización.

En su lugar, la aplicación debe seleccionar la propiedad @microsoft.graph.downloadUrl que devuelve la misma URL a la que dirige /content. Esta dirección URL puede solicitarse después directamente con XMLHttpRequest. Dado que estas direcciones URL están autenticadas previamente, se pueden recuperar sin una solicitud preparatoria de CORS.

Ejemplo

Para recuperar la dirección URL de descarga de un archivo, primero realice una solicitud que incluya la propiedad @microsoft.graph.downloadUrl:

GET /drive/items/{item-ID}?select=id,@microsoft.graph.downloadUrl

La llamada devuelve el id. y la dirección URL de descarga de un archivo:

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

{
  "id": "12319191!11919",
  "@microsoft.graph.downloadUrl": "https://..."
}

Después, puede realizar una solicitud XMLHttpRequest para la dirección URL proporcionada en @microsoft.graph.downloadUrl para recuperar el archivo.

Descargas de rango parcial

Para descargar un rango parcial de bytes del archivo, la aplicación puede usar el encabezado Range como se especifica en RFC 2616. Debe anexar el Range encabezado a la dirección URL real @microsoft.graph.downloadUrl y no a la solicitud de /content.

GET https://b0mpua-by3301.files.1drv.com/y23vmag
Range: bytes=0-1023

La llamada devuelve una HTTP 206 Partial Content respuesta con el intervalo de solicitudes de bytes del archivo. Si no se puede generar el rango, se puede ignorar el encabezado de rango y se devolverá una HTTP 200 respuesta con el contenido completo del archivo.

HTTP/1.1 206 Partial Content
Content-Range: bytes 0-1023/2048

<first 1024 bytes of file>

Respuestas de error

Consulta Respuestas de error para obtener más información sobre cómo se devuelven los errores.