Migración a Microsoft Graph desde SDK de Live
Si usa el SDK de Live o las API de Live Connect para conectarse a un perfil, un calendario, contactos o archivos, deberá actualizar la aplicación para mantener la funcionalidad.
El SDK de Live y las API de Live Connect llevan más de un año marcadas como en desuso. Como ya se anunció en el Blog para desarrolladores de Office, estas API han llegado al final del ciclo de vida y no estarán disponibles a partir del 1 de noviembre de 2018.
Los datos del perfil y los contactos ya no estarán disponibles mediante las API de Live Connect a partir del 1 de diciembre de 2017. Los datos del calendario no están disponibles mediante Live Connect desde el 1 de junio de 2017.
Las API de Live Connect se hospedan en https://apis.live.net/v5.0. Este prefijo debe suponerse en todos los ejemplos siguientes.
Cambio a Microsoft Graph
La funcionalidad disponible anteriormente mediante el SDK de Live y las API de Live Connect ahora está disponible a través de Microsoft Graph. Para seguir integrándose con los servicios de Microsoft, los desarrolladores deben actualizar sus aplicaciones para usar Microsoft Graph antes de que se suspenda la escala de tiempo de estos servicios.
De forma similar a las capacidades de Live Connect, Microsoft Graph tiene una gran variedad de recursos disponible en función del tipo de datos de usuario con los que interactúen sus aplicaciones:
- Autenticación de cuentas Microsoft
- Archivos de OneDrive
- Calendario de Outlook
- Mensajes de Outlook
- Contactos personales
- API de perfil e identidad
Bibliotecas
Microsoft Graph ofrece bibliotecas cliente para muchas plataformas que pueden integrarse con su aplicación de forma similar al SDK de Live.
Permisos
Microsoft Graph usa un conjunto de ámbitos de permisos diferente al de Live Connect. Para acceder a las API de Microsoft Graph, su aplicación deberá cambiar de ámbitos de permisos. Para ello, la aplicación tiene que solicitar el consentimiento del usuario para iniciar sesión y aceptar los nuevos permisos.
Consulte Referencia de permisos de Microsoft Graph para obtener todos los detalles.
| Ámbito de Live Connect | Permisos de Microsoft Graph | Descripción |
|---|---|---|
wl.basic |
Contacts.Read |
Permite que la aplicación lea los contactos del usuario. |
wl.offline_access |
offline_access |
Permite que la aplicación lea y actualice los datos del usuario, incluso cuando no están usando en ese momento la aplicación. |
wl.signin |
openid |
Permite que los usuarios inicien sesión en la aplicación con sus cuentas profesionales o educativas y permite que la aplicación vea la información básica del perfil del usuario. |
wl.skydrive |
Files.Read |
Permite que la aplicación lea los archivos del usuario que inició la sesión. |
wl.skydrive_update |
Files.ReadWrite |
Permite que la aplicación lea, cree, actualice y elimine los archivos del usuario que inició la sesión. |
wl.contacts_create |
Contacts.ReadWrite |
Permite que la aplicación cree, lea, actualice y elimine los contactos del usuario. |
wl.contacts_calendar |
Calendars.Read.Shared |
Permite que la aplicación lea los contactos para los que el usuario tiene permisos de acceso, incluidos los contactos propios y compartidos del usuario. |
wl.contacts_photos |
Contacts.Read |
Permite que la aplicación lea los contactos del usuario. |
wl.contacts_skydrive |
Files.ReadWrite.All |
Permite que la aplicación lea, cree, actualice y elimine todos los archivos a los que puede obtener acceso el usuario que inició la sesión. |
wl.calendars |
Calendars.Read |
Permite que la aplicación lea los eventos en los calendarios del usuario. |
wl.calendars_update |
Calendars.ReadWrite |
Permite que la aplicación cree, lea, actualice y elimine eventos de los calendarios del usuario. |
wl.emails |
Mail.Read |
Permite que la aplicación lea el correo electrónico de los buzones del usuario. |
wl.events_create |
Calendars.ReadWrite |
Permite que la aplicación cree, lea, actualice y elimine eventos de los calendarios del usuario. |
wl.photos |
Files.Read |
Permite que la aplicación lea los archivos del usuario que inició la sesión, incluidas las fotos. |
office.onenote_create |
Notes.ReadWrite |
Permite que la aplicación lea, comparta y modifique blocs de notas de OneNote en nombre del usuario que inició la sesión. |
Identificadores únicos
Microsoft Graph usa un esquema de identificadores únicos diferente del de Live Connect o el SDK de Live. No se permite usar los identificadores de Live Connect con Microsoft Graph.
Su aplicación deberá volver a detectar los identificadores de elementos conocidos mediante la búsqueda, la navegación basada en rutas o solicitando al usuario que vuelva a seleccionar los elementos.
API de identidad
La funcionalidad de la API de identidad dejará de devolver los datos de usuario a partir del 1 de diciembre de 2017.
En la tabla siguiente se describen los métodos de la API de Live Connect y su método equivalente en Microsoft Graph. Aunque el formato de la ruta de acceso de REST puede ser similar, los datos de respuesta no tienen el mismo formato. Deberá usar el SDK de Microsoft Graph o actualizar su asignación de JSON para poder usar el formato de recursos de Microsoft Graph.
| API de Live Connect | API de Microsoft Graph | Notas |
|---|---|---|
GET /me |
GET /me |
Pruébelo. Devuelve el perfil del usuario, el nombre para mostrar y otra información. |
GET /me/picture |
GET /me/photo/$value |
Pruébelo. Devuelve la foto de perfil del usuario. |
API de contactos
La funcionalidad de la API de contactos dejará de devolver los datos de usuario a partir del 1 de diciembre de 2017.
En la tabla siguiente se describen los métodos de la API de Live Connect y su método equivalente en Microsoft Graph. Aunque el formato de la ruta de acceso de REST puede ser similar, los datos de respuesta no tienen el mismo formato. Deberá usar el SDK de Microsoft Graph o actualizar su asignación de JSON para poder usar el formato de recursos de Microsoft Graph.
| API de Live Connect | API de Microsoft Graph | Notas |
|---|---|---|
GET /me/contacts |
GET /me/contacts |
Pruébelo. Devuelve una lista de los contactos personales del usuario. |
GET /{contact-id} |
GET /me/contacts/{contact-id} |
Pruébelo. Devuelve los datos de un contacto en concreto. |
POST /{contact-id} |
POST /me/contacts |
Crea un nuevo contacto. |
API del calendario
La API de calendario no devuelve los datos de usuario desde junio de 2017.
En la tabla siguiente se describen los métodos de la API de Live Connect y su método equivalente en Microsoft Graph. Aunque el formato de la ruta de acceso de REST puede ser similar, los datos de respuesta no tienen el mismo formato. Deberá usar el SDK de Microsoft Graph o actualizar su asignación de JSON para poder usar el formato de recursos de Microsoft Graph.
| API de Live Connect | API de Microsoft Graph | Notas |
|---|---|---|
GET /me/calendars |
GET /me/calendars |
Pruébelo. Devuelve una lista de los calendarios del usuario. |
GET /{calendar-id} |
GET /me/events |
Pruébelo. Devuelve los eventos de los calendarios del usuario. |
POST /{calendar-id} |
POST /me/events |
Crea un nuevo evento en el calendario del usuario. |
API de REST de OneDrive
El componente de OneDrive de la API de Live Connect dejará de ser funcional a partir del 1 de noviembre de 2018.
En las tablas siguientes se enumeran los métodos de la API de Live Connect y sus métodos equivalentes en Microsoft Graph.
Aunque el formato de la ruta de acceso de REST puede ser similar, los datos de respuesta no tienen el mismo formato. Deberá usar el SDK de Microsoft Graph o actualizar su asignación de JSON para poder usar el formato de recursos de Microsoft Graph.
Para obtener todos los detalles sobre cómo desplazarse por el contenido de OneDrive de un usuario, consulte Obtener un recurso DriveItem.
| API de Live Connect | API de Microsoft Graph | Notas |
|---|---|---|
GET /folder.a6b2a7e8f2515e5e.A6B2A7E8F2515E5E!110 |
GET /me/drive/items/A6B2A7E8F2515E5E!110 |
Pruébelo. Obtiene los metadatos de una carpeta. |
GET /me/skydrive/camera_roll |
GET /me/drive/special/cameraroll |
Recupera la carpeta de copia de seguridad de álbum de cámara del usuario. |
GET /me/skydrive/files |
GET /me/drive/root/children |
Pruébelo. Enumera el contenido de la carpeta raíz de OneDrive. |
GET /me/skydrive/my_documents |
GET /me/drive/special/documents |
Recupera la carpeta de documentos del usuario. |
GET /me/skydrive/my_photos |
GET /me/drive/special/photos |
Recupera la carpeta de fotos del usuario. |
GET /me/skydrive/public_documents |
N/D | Recupera la carpeta compartida pública del usuario. Este concepto se ha eliminado de OneDrive y no está disponible en Microsoft Graph. |
GET /me/skydrive/quota |
GET /me/drive?$select=quota |
Pruébelo. Devuelve información de cuota de OneDrive de un usuario, incluido el espacio usado y el disponible. |
GET /me/skydrive/recent |
GET /me/drive/recent |
Devuelve una lista de los archivos y las carpetas compartidos con el usuario actual. |
GET /me/skydrive/shared |
GET /me/drive/sharedWithMe |
Devuelve una lista de los archivos y las carpetas compartidos con el usuario actual. |
GET /me/skydrive |
GET /me/drive/root |
Pruébelo. Recupera la carpeta raíz de OneDrive del usuario. |
GET /skydrive/get_item_preview |
GET /me/drive/items/{item-id}/thumbnails |
Devuelve las miniaturas disponibles de un archivo o una carpeta de OneDrive. |
Selector de archivos para aplicaciones web
La funcionalidad del selector de archivos de OneDrive que se proporcionaba como parte del SDK de Live ahora está disponible a través del selector de archivos de OneDrive.
La versión 5 del SDK de Live (el selector de archivos de OneDrive) dejará de funcionar a partir del 1 de noviembre de 2018.
Recursos adicionales
Para obtener más información sobre cómo usar Microsoft Graph, pruebe el Inicio rápido de Microsoft Graph.