Referencia de la API de REST de Microsoft Graph versión 1.0Microsoft Graph REST API v1.0 reference

Bienvenido a la referencia de la API de REST de Microsoft Graph del punto de conexión de la versión 1.0.Welcome to Microsoft Graph REST API reference for the v1.0 endpoint.

Los conjuntos de API del punto de conexión de la versión 1.0 (https://graph.microsoft.com/v1.0) tienen un estado de disponibilidad general (GA) y han pasado por un proceso riguroso de revisión y comentarios con clientes para satisfacer necesidades prácticas y de producción.API sets on the v1.0 endpoint (https://graph.microsoft.com/v1.0) are in general availability (GA) status, and have gone through a rigorous review-and-feedback process with customers to meet practical, production needs. Las actualizaciones de las API de este punto de conexión son adicionales por naturaleza y no interfieren con los escenarios de aplicación existentes.Updates to APIs on this endpoint are additive in nature and do not break existing app scenarios.

Casos de uso comúnCommon use cases

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.The power of Microsoft Graph lies in easy navigation of entities and relationships across different services exposed on a single Microsoft Graph REST endpoint.

Varios de estos servicios están diseñados para habilitar escenarios enriquecidos en un entorno de usuario o grupo.A number of these services are designed to enable rich scenarios around a user and around a group.

Casos de uso de la versión 1.0 enfocados al usuarioUser-centric use cases in v1.0

  1. Encuentre el perfil y la foto de una usuaria, Elisa.Get the profile and photo of a user, Lisa.
  2. Encuentre la información de perfil del administrador de Elisa y los Id. de sus subordinados directos, todo almacenado en Azure Active Directory.Get the profile information about Lisa's manager and IDs of her direct reports, all stored in Azure Active Directory.
  3. Acceda a archivos de Elisa en OneDrive para la Empresa, busque la identidad de la última persona que modificó un archivo y navegue hasta el perfil de esa persona.Access Lisa's files on OneDrive for Business, find the identity of the last person who modified a file there, and navigate to that person's profile.
  4. Acceda al calendario de Elisa en Exchange Online y determine el mejor momento para que se reúna con su equipo en las próximas dos semanas.Access Lisa's calendar on Exchange Online and determine the best time for Lisa to meet with her team in the next two weeks.
  5. Suscríbase a al calendario de Elisa y controle los cambios que se realicen en él para informarle a Lisa cuándo pasa más de 80 % de su tiempo en reuniones.Subscribe to and track changes in Lisa's calendar, tell Lisa when she is spending more than 80% of her time in meetings.
  6. Establezca respuestas automáticas cuando Elisa deja la oficina.Set automatic replies when Lisa is away from the office.
  7. Obtenga acceso a las personas más importantes para Elisa en función de relaciones de negocios, colaboraciones y comunicaciones.Get the people who are most relevant to Lisa, based on communication, collaboration, and business relationships.
  8. Obtenga la última proyección de ventas de un gráfico en un archivo de Excel de Elisa en OneDrive para la Empresa.Get the latest sales projection from a chart in an Excel file in Lisa's OneDrive for Business.
  9. Busque las tareas asignadas a Elisa en Planner.Find the tasks assigned to Lisa in Planner.

Casos de uso de grupo de Microsoft 365 en v 1.0Microsoft 365 group use cases in v1.0

  1. Ejecute un informe en grupos de Microsoft 365 de una organización e identifique el grupo con más comunicación entre miembros.Run a report on Microsoft 365 groups in an organization and identify the group with the most communication among group members.
  2. Encuentre los planes de este grupo de Microsoft 365 y la asignación de tareas en ese plan.Find the plans of this Microsoft 365 group, and the assignment of tasks in that plan.
  3. 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.Start a new conversation in the Microsoft 365 group to determine if members want to create another group to share the workload.
  4. Acceda al bloc de notas predeterminado del grupo y cree una página para mostrar el resultado de la investigación.Get the default notebook for the group and create a page to note the outcome of the investigation.

Otras versiones de APIOther API versions

Actualmente hay 2 versiones de las API de REST de Microsoft Graph: la versión 1.0 y la beta.There are currently 2 versions of Microsoft Graph REST APIs - v1.0 and 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.If you're interested in new or enhanced APIs that are still in preview status, see Microsoft Graph beta endpoint reference. Tenga en cuenta que las API en estado de vista previa están sujetas a cambios y podrían interferir en escenarios existentes sin previo aviso.Be aware that APIs in preview status are subject to change, and may break existing scenarios without notice. No permita que su producción dependa de API en punto de conexión beta.Don't take a production dependency on APIs in the beta endpoint.

Obtenga más información sobre versiones y compatibilidad.Find more information about versioning and support.

Llamar al punto de conexión v1.0Call the v1.0 endpoint

Las solicitudes de la API de Microsoft Graph al punto de conexión v1.0 usan el siguiente patrón:Microsoft Graph API requests to the v1.0 endpoint use the following pattern:

https://graph.microsoft.com/v1.0/{resource}?[query_parameters]

Para obtener más información, consulte Usar la API de Microsoft Graph.For details, see Use the Microsoft Graph API.

NovedadesWhat's new

Descubra las nuevas características y actualizaciones en el punto de conexión v1.0.Find out about the latest new features and updates in the v1.0 endpoint.

Comuníquese con nosotrosConnect with us

¿Hay otras API o funciones que le gustaría ver en Microsoft Graph?Are there additional APIs or features you'd like to see in Microsoft Graph? Publique solicitudes de funciones nuevas en UserVoice.Post new feature requests on UserVoice.

¿Quiere enviar un comentario sobre las API actuales de Microsoft Graph?Have feedback for existing Microsoft Graph APIs? Comuníquese con nosotros en Github.Connect with us on Github.