Referencia del punto de conexión de la API de REST v1.0 de Microsoft Graph
Le damos la bienvenida a la referencia de la API REST de Microsoft Graph para el punto de v1.0
conexión.
Los conjuntos de API en el v1.0
punto de conexión (https://graph.microsoft.com/v1.0
) han alcanzado la disponibilidad general (GA) y han pasado por un riguroso proceso de revisión y comentarios con los clientes para satisfacer las necesidades prácticas de producción. Las actualizaciones de las API en este punto de conexión son aditivas por naturaleza y no interrumpen los escenarios de aplicación existentes.
Casos de uso común
El poder de Microsoft Graph está en facilitar la navegación de entidades y relaciones en los diferentes servicios que se exponen en un único punto de conexión de REST de Microsoft Graph.
Algunos de estos servicios están diseñados para habilitar escenarios enriquecidos en torno a un usuario y a un grupo.
Casos de uso de la versión 1.0 enfocados al usuario
- Obtener el perfil y la foto de un usuario.
- Obtenga la información de perfil para el administrador de un usuario y los identificadores de sus informes directos, todos ellos almacenados en Microsoft Entra ID.
- Acceda a los archivos de un usuario en OneDrive, busque la identidad de la última persona que modificó allí un archivo y vaya al perfil de esa persona.
- Acceda al calendario de un usuario en Exchange Online y determine el mejor momento para reunirse con su equipo en las próximas dos semanas.
- Suscríbase yrealice un seguimiento de los cambios en el calendario de un usuario e indique al usuario cuándo pasa más del 80 % de su tiempo en reuniones.
- Establezca respuestas automáticas cuando un usuario esté fuera de la oficina.
- Obtenga las personas más relevantes para un usuario, en función de la comunicación, la colaboración y las relaciones empresariales.
- Obtenga la proyección de ventas más reciente de un gráfico en un archivo de Excel en OneDrive de un usuario.
- Busque las tareas asignadas a un usuario en Planner.
Casos de uso de grupo de Microsoft 365 en v 1.0
- Ejecute un informe en grupos de Microsoft 365 de una organización e identifique el grupo con más comunicación entre miembros.
- Encuentre los planes de este grupo de Microsoft 365 y la asignación de tareas en ese plan.
- Inicie una nueva conversación en el grupo de Microsoft 365 para determinar si los miembros quieren crear otro grupo para compartir la carga de trabajo.
- Acceda al bloc de notas predeterminado del grupo y cree una página para mostrar el resultado de la investigación.
Llamar al punto de conexión v1.0
Las solicitudes de la API de Microsoft Graph al punto de conexión v1.0 usan el siguiente patrón:
https://graph.microsoft.com/v1.0/{resource}?[query_parameters]
Para obtener más información sobre las llamadas a la API REST de Microsoft Graph, consulte Uso de Microsoft Graph API.
Punto de conexión beta de Microsoft Graph
Actualmente, hay disponibles dos versiones de las API REST de Microsoft Graph: v1.0 y beta.
Si está interesado en las API nuevas o mejoradas que aún estén en estado de vista previa, conlsulte Referencia de punto de conexión beta de Microsoft Graph.
Precaución
Las API en estado de versión preliminar están sujetas a cambios y pueden interrumpir los escenarios existentes sin previo aviso. No tome una dependencia de producción en las API del punto de beta
conexión.
Para obtener más información, consulte Control de versiones y compatibilidad.
Novedades
Descubra las novedades del punto de conexión v1.0.
Para obtener más información sobre los cambios en las API de Microsoft Graph en la versión 1.0, explore el registro de cambios de API.