Introducción a la API de OneDrive
En esta página se proporciona información general rápida de los pasos necesarios para usar Microsoft Graph y la API de OneDrive. Para obtener un tutorial más detallado, consulte el Inicio rápido de Microsoft Graph.
Si está trabajando con SharePoint Server 2016 o no está usando Microsoft Graph, vea el tema Introducción a la API de OneDrive con SharePoint Server 2016.
1. Autenticación de usuarios y autorización de la aplicación
Microsoft Graph y la API de OneDrive usan OAuth 2.0 para la autorización. Al terminar un flujo de OAuth, la aplicación recibe un token de acceso que proporciona acceso a Microsoft Graph a un conjunto determinado de permisos para un usuario.
La aplicación proporciona el token de acceso en cada solicitud, mediante un encabezado HTTP:
Authorization: bearer {token}
Para obtener más información sobre cómo autorizar la aplicación y obtener un token de acceso, vea Autenticación de aplicaciones con Microsoft Graph.
2. Realizar llamadas a un recurso
Una vez que la aplicación está autorizada y ha recibido el token de acceso, puede realizar solicitudes al punto de conexión de Microsoft Graph para los recursos de OneDrive o SharePoint. Para crear una dirección URL para un recurso, necesita conocer la URL relativa para el recurso raíz (como un usuario, grupo o sitio) y el recurso de unidad o recurso driveItem al que se dirige su solicitud.
Una dirección URL de solicitud incluye estos componentes:
- Versión y dirección URL raíz de Microsoft Graph (
https://graph.microsoft.com/v1.0) - Un destino de recurso raíz (
/users/{id}) - Un destino de recurso de la API de OneDrive (
/driveo/drives/{id}/items/{item-id}o/drive/root:/path/to/item)
Nota: En toda la documentación, solo se usa sintaxis parcial como GET /drive/items/{item-id} por razones de brevedad.
Agregue un prefijo a la ruta con el destino de recurso raíz y la dirección URL raíz correcta para obtener la dirección URL o la ruta de acceso a recursos completa.
3. Continuar
Consulte los ejemplos de OneDrive en GitHub y los ejemplos de Microsoft Graph en GitHub para obtener información sobre el uso de archivos en Microsoft Graph.
Lea la documentación HTTP de la API de OneDrive para obtener información sobre cómo trabajar con los recursos drive y driveItem. Para obtener más información sobre todos los recursos de Microsoft Graph, vea la documentación de Microsoft Graph.
¿Tiene alguna pregunta o necesita ayuda? Puede ponerse en contacto con nosotros en Stack Overflow y en la página de problemas de GitHub para ver nuestra documentación.