Microsoft Graph APIMicrosoft Graph API

Microsoft Graph API es una API web de RESTful que le permite tener acceso a recursos de servicio de Microsoft Cloud.The Microsoft Graph API is a RESTful web API that enables you to access Microsoft Cloud service resources. Después de registrar la aplicación y obtener los tokens de autenticación para un usuario o servicio, puede realizar solicitudes a Microsoft Graph API.After you register your app and get authentication tokens for a user or service, you can make requests to the Microsoft Graph API. Para más información, consulte Introducción a Microsoft Graph.For more information, see Overview of Microsoft Graph.

Microsoft Graph expone las API REST y las bibliotecas cliente para obtener acceso a los datos en los siguientes servicios de Microsoft 365:Microsoft Graph exposes REST APIs and client libraries to access data on the following Microsoft 365 services:

  • Servicios de Microsoft 365: Delve, Excel, Microsoft Bookings, Microsoft Teams, OneDrive, OneNote, Outlook/Exchange, Planner y SharePointMicrosoft 365 services: Delve, Excel, Microsoft Bookings, Microsoft Teams, OneDrive, OneNote, Outlook/Exchange, Planner, and SharePoint
  • Servicios de Enterprise Mobility + Security: Advanced Threat Analytics, Advanced Threat Protection, Azure Active Directory, Identity Manager e IntuneEnterprise Mobility and Security services: Advanced Threat Analytics, Advanced Threat Protection, Azure Active Directory, Identity Manager, and Intune
  • Servicios de Windows 10: actividades, dispositivos y notificacionesWindows 10 services: activities, devices, notifications
  • Dynamics 365 Business CentralDynamics 365 Business Central

VersionesVersions

Actualmente Microsoft Graph admite dos versiones: v1.0 y la versión beta.Microsoft Graph currently supports two versions: v1.0 and beta. La versión v1.0 incluye API de disponibilidad general.The v1.0 version includes generally available APIs. Use la versión v1.0 para todas las aplicaciones de producción.Use the v1.0 version for all production apps. La versión beta incluye las API que están en versión preliminar actualmente.The beta includes APIs that are currently in preview. Dado que podríamos introducir cambios importantes en nuestras API de la versión beta, se recomienda usar la versión beta solo para probar las aplicaciones que están en desarrollo. No use las API de la versión beta en las aplicaciones de producción.Because we might introduce breaking changes to our beta APIs, we recommend that you use the beta version only to test apps that are in development; do not use beta APIs in your production apps. Para obtener más información, consulte Control de versiones, compatibilidad y directivas de cambios importantes en Microsoft Graph.For more information, see Versioning, support, and breaking change policies for Microsoft Graph.

Para empezar a usar las API de la versión beta, consulte Referencia de puntos de conexión de la versión beta de Microsoft Graph.To start using the beta APIs, see Microsoft Graph beta endpoint reference

Para empezar a usar las API de la versión v1.0, consulte Referencia de la API REST de Microsoft Graph versión v1.0.To start using the v1.0 APIs, see Microsoft Graph REST API v1.0 reference

IntroducciónGet started

Para leer o escribir en un recurso, como un usuario o un mensaje de correo electrónico, construya una solicitud similar a la siguiente:To read from or write to a resource such as a user or an email message, you construct a request that looks like the following:

{HTTP method} https://graph.microsoft.com/{version}/{resource}?{query-parameters}

Para obtener más información sobre los elementos de la solicitud construida, consulte Uso de Microsoft Graph API.For more information about the elements of the constructed request, see Use the Microsoft Graph API

Los ejemplos de inicio rápido están disponibles para mostrarle cómo acceder a la eficacia de Microsoft Graph API.Quickstart samples are available to show you how to access the power of the Microsoft Graph API. Los ejemplos que están disponibles tienen acceso a dos servicios con una autenticación: Cuenta de Microsoft y Outlook.The samples that are available access two services with one authentication: Microsoft account and Outlook. Cada inicio rápido tiene acceso a información de los perfiles de usuarios de cuentas de Microsoft y muestra los eventos de su calendario.Each quickstart accesses information from Microsoft account users' profiles and displays events from their calendar. El inicio rápido implica cuatro pasos:The quickstarts involve four steps:

  • Seleccione la plataforma.Select your platform
  • Obtenga el id. de la aplicación (Id. de cliente).Get your app ID (client ID)
  • Compilación del ejemploBuild the sample
  • Inicie sesión y vea los eventos en el calendario.Sign in, and view events on your calendar

Al completar la guía de inicio rápido, tiene una aplicación que está lista para ejecutarse.When you complete the quickstart, you have an app that's ready to run. Para más información, consulte las Preguntas más frecuentes sobre el inicio rápido de Microsoft Graph.For more information, see the Microsoft Graph quickstart FAQ. Para empezar a trabajar con los ejemplos, consulte Inicio rápido de Microsoft Graph.To get started with the samples, see Microsoft Graph QuickStart.

HerramientasTools

Microsoft Graph Explorer es una herramienta basada en la web que puede usar para compilar y probar solicitudes con Microsoft Graph API.Microsoft Graph Explorer is a web-based tool that you can use to build and test requests using Microsoft Graph APIs. Puede tener acceso a Microsoft Graph Explorer en https://developer.microsoft.com/graph/graph-explorer.You can access Microsoft Graph Explorer at: https://developer.microsoft.com/graph/graph-explorer.

Postman es una herramienta que también puede usar para compilar y probar solicitudes con Microsoft Graph API.Postman is a tool that you can also use to build and test requests using the Microsoft Graph APIs. Puede descargar Postman en https://www.getpostman.com/.You can download Postman at: https://www.getpostman.com/. Para interactuar con Microsoft Graph en Postman, use la colección de Microsoft Graph en Postman.To interact with Microsoft Graph in Postman, you use the Microsoft Graph collection in Postman. Para más información, consulte Uso de Postman con Microsoft Graph API.For more information, see Use Postman with the Microsoft Graph API.