Cargar un elemento en OneDrive desde una dirección URL (versión preliminar)

  • Artículo

Su aplicación puede cargar un elemento en OneDrive proporcionando una dirección URL. OneDrive descargará el archivo directamente desde un servidor remoto de manera que la aplicación no tenga que cargar los bytes del archivo. Esto es especialmente útil para los clientes móviles o los complementos de explorador, donde el contenido de los archivos no está disponible, o es caro de transferir.

Para cargar archivos grandes, consulte Cargar archivos de gran tamaño con una sesión de carga.

Nota: Solo puede cargar elementos desde una dirección URL en OneDrive Personal.

Permisos

Se requiere uno de los permisos siguientes para llamar a esta API. Para obtener más información, incluido cómo elegir permisos, vea Permisos.

Tipo de permiso Permisos (de menos a más privilegiados)
Delegado (cuenta profesional o educativa) N/D
Delegado (cuenta personal de Microsoft) Files.ReadWrite, Files.ReadWrite.All
Aplicación N/D

Solicitud HTTP

POST /me/drive/items/{parent-item}/children

Encabezados de solicitud

Nombre Tipo Descripción
Prefer string Se establece en respond-async para habilitar la transferencia de elementos asincrónica. En caso contrario, la solicitud se anula.

Cuerpo de la solicitud

El contenido del cuerpo de la solicitud debe ser la representación JSON del elemento que se va a crear desde la dirección URL remota. Tenga en cuenta que, cuando el servicio descarga el archivo desde la dirección URL remota, no se autenticará como el usuario, por lo que la dirección URL debe ser accesible públicamente.

Respuesta

Este método devuelve detalles sobre cómo supervisar el progreso de la descarga tras aceptar la solicitud.

HTTP/1.1 202 Accepted
Location: https://api.onedrive.com/monitor/4A3407B5-88FC-4504-8B21-0AABD3412717

Ejemplo

POST /drive/items/{parent-item}/children
Content-Type: application/json
Prefer: respond-async

{
  "@microsoft.graph.sourceUrl": "http://wscont2.apps.microsoft.com/winstore/1x/e33e38d9-d138-42a1-b252-27da1924ca87/Screenshot.225037.100000.jpg",
  "name": "halo-screenshot.jpg",
  "file": { }
}

Respuesta

El servicio se devolverá inmediatamente tras aceptar la solicitud y proporcionará detalles sobre cómo supervisar el progreso de la copia.

HTTP/1.1 202 Accepted
Location: https://api.onedrive.com/monitor/4A3407B5-88FC-4504-8B21-0AABD3412717

El valor del encabezado Location proporciona una dirección URL que puede usarse para obtener el estado actual de la operación y permitirle conocer cuándo ha finalizado la carga.

Comentarios

Cargar un elemento en OneDrive para la Empresa, SharePoint Online y SharePoint Server 2016 con una dirección URL no se admite.