Introducción a la API de OneDriveGetting started with OneDrive API with SharePoint Server 2016

En esta página se proporciona información general rápida de los pasos necesarios para usar Microsoft Graph y la API de OneDrive.This page provides a quick overview of the steps required to use Microsoft Graph and the OneDrive API. Para obtener un tutorial más detallado, consulte el Inicio rápido de Microsoft Graph.For a more detailed walk through, check out the Microsoft Graph Quick Start.

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.If you are working with SharePoint Server 2016 or not using Microsoft Graph, see the Using OneDrive API with SharePoint Server 2016 topic.

1. Autenticación de usuarios y autorización de la aplicación1. User authentication and authorizing your app

Microsoft Graph y la API de OneDrive usan OAuth 2.0 para la autorización.Microsoft Graph and OneDrive API use OAuth 2.0 for authorization. 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.By completing an OAuth flow, your app receives an access token that provides access to the Microsoft Graph a particular set of permissions for a user.

La aplicación proporciona el token de acceso en cada solicitud, mediante un encabezado HTTP:Your app provides the access token in each request, through an HTTP header:

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.For more information on authorizing your application and obtaining an access token, see App authorization with Microsoft Graph.

2. Realizar llamadas a un recurso2. Make calls to a resource

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.Once your app is authorized and received an access token, it can make requests to the Microsoft Graph endpoint for OneDrive or SharePoint resources. 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.To construct the URL for a resource, you need to know the relative URL for the root resource (like a user, group, or site) and the drive resource or driveItem resource your request is targeting.

Una dirección URL de solicitud incluye estos componentes:A request URL includes these components:

  • Versión y dirección URL raíz de Microsoft Graph (https://graph.microsoft.com/v1.0)Microsoft Graph root URL and version (https://graph.microsoft.com/v1.0)
  • Un destino de recurso raíz (/users/{id})A root resource target (/users/{id})
  • Un destino de recurso de la API de OneDrive (/drive o /drives/{id}/items/{item-id} o /drive/root:/path/to/item)A OneDrive API resource target (/drive or /drives/{id}/items/{item-id} or /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.Note: Throughout the documentation, only partial syntax such as: GET /drive/items/{item-id} is used for the sake of brevity. 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.Prefix the path with the correct root URL and version number in order to obtain the full resource path or URL.

3. Continuar3. Keep going

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.Check out the OneDrive samples on GitHub and the Microsoft Graph samples on GitHub to learn more about using files in the 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.Read through the OneDrive API HTTP documentation to learn more about working with the drive and item resources in OneDrive API HTTP end point. Para obtener más información sobre todos los recursos de Microsoft Graph, vea la documentación de Microsoft Graph.For more information about all resources in Microsoft Graph, see the Microsoft Graph documentation.

¿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.Questions or need support? You can find us on Stack Overflow and through the GitHub issues page for our documentation.