Ejercicio: Acceso a la información de usuario desde Microsoft Graph mediante el Probador de Graph

  • 8 minutos

En el siguiente ejercicio, podrá echar un vistazo a Graph Explorer y ver las principales API de Microsoft Graph que tu aplicación puede llamar.

Introducción a Microsoft Graph

Digamos que un vendedor quiere ver la información del perfil que incluye el nombre, el cargo, el correo y el teléfono móvil. Este es el proceso para obtener el perfil de un usuario en Graph Explorer:

  1. Visite el sitio web de Graph Explorer.
  2. En Consultas de ejemplo a la izquierda, seleccione cualquier API de Microsoft Graph.
  3. La consulta seleccionada se ejecuta automáticamente en el Explorador de gráficos. Observe la dirección URL de la API que eligió probar.
  4. Cuando la consulta se realiza con éxito, recibe una notificación OK - 200.
  5. El resultado de la solicitud aparece en Vista previa de la respuesta.

Captura de pantalla que muestra el proceso para obtener el perfil de un usuario.

Pruebe las consultas con su propia cuenta en el Explorador de gráficos

Para este ejercicio, supongamos que un vendedor busca documentos compartidos en reuniones, chats de Teams o correos electrónicos. La empresa de ventas también quiere tener una forma más fácil de ver los documentos de tendencia en torno a los usuarios. Como desarrollador, puede probar a obtener elementos de tendencia utilizando la API de Microsoft Graph para obtener información en Graph Explorer.

El Explorador de gráficos utiliza de forma predeterminada los datos de la cuenta de muestra. Para probar las consultas que obtienen sus propios datos, puede iniciar sesión con su cuenta. Puede realizar la prueba utilizando la función de autenticación del Explorador de gráficos.

Nota:

Asegúrese de haber creado un inquilino de desarrollador de Microsoft 365. Es uno de los requisitos para este módulo.

  1. Seleccione el botón Iniciar sesión en el Explorador de gráficos de la izquierda, inicie sesión con su cuenta de inquilino desarrollador de Microsoft 365, y luego, seleccione Aceptar para dar su consentimiento a los permisos solicitados por el Explorador de gráficos

    Una vez que haya iniciado la sesión, la información de su perfil aparecerá a la izquierda.

  2. Seleccione Obtener elementos de tendencias a mi alrededor en las consultas de muestra.

  3. Recibe una advertencia que significa que la API de Microsoft Graph para insights requiere algunos permisos para ejecutar la consulta.

  4. Seleccione Modificar permisos. Aparecen los permisos necesarios para la consulta seleccionada.

  5. Seleccione Consentimiento para proporcionar el consentimiento para cada permiso.

    Captura de pantalla que muestra cómo probar las consultas con su propia cuenta en el Explorador de gráficos

  6. Seleccione Ejecutar consulta.

  7. Tras la ejecución de la API Insights, se obtiene un mensaje OK - 200.

  8. En la pestaña de Vista previa de la respuesta se ven sus propios artículos de tendencia.

    Captura de pantalla que muestra cómo obtener un resultado de consulta con su propia cuenta en el Explorador de gráficos.

Pruebe una solicitud POST en el Explorador de gráficos

Cada vez que se agrega un nuevo vendedor en el canal del equipo de ventas en Teams, se puede automatizar el envío de un mensaje al canal para dar la bienvenida al nuevo vendedor. Para enviar un mensaje a un canal en Microsoft Teams, puede utilizar una solicitud POST en el Explorador de gráficos:

  1. Seleccione POST en la lista desplegable verbo HTTP.

  2. Busque "equipos" en Consultas de muestra.

  3. Seleccione el mensaje del canal POST en la lista desplegable de Microsoft Teams.

  4. Verá que aparece un consejo que le indica que necesitará el ID del equipo y el ID del canal para esta consulta. También recomienda ejecutar Obtener mis equipos unidos y Obtener el canal de un equipo del que soy miembro para obtener el ID del equipo y el ID del canal requeridos.

    Captura de pantalla que muestra la solicitud post en Microsoft Graph Explorer.

  5. Luego de obtener el ID del equipo y el ID del canal, edita la consulta utilizando el editor de consultas. Asegúrese de reemplazar {team-id} y {channel-id} por sus identificadores.

  6. Proporcione el consentimiento para los permisos requeridos desde la pestaña Modificar permisos.

  7. En el Cuerpo de la solicitud, hay contenido predeterminado, como "Hola mundo". Este es el mensaje que enviará a su canal en Microsoft Teams. Siéntase libre de cambiar el contenido en el cuerpo de la solicitud con cualquier frase que prefiera enviar.

  8. Seleccione Ejecutar consulta para ejecutar la solicitud.

  9. Cuando la solicitud se complete con éxito, verá un mensaje Creado - 201.

    Captura de pantalla que muestra el resultado de la solicitud de publicación en Microsoft Graph Explorer.

  10. Para ver los resultados, vaya https://teams.microsoft.comy seleccione Teams en el menú de la izquierda. Busque el equipo y el canal que ha elegido para enviar un mensaje y seleccione el nombre del canal. Debería ver el mensaje " Hola mundo" que ha enviado en el canal Entradas:

    Captura de pantalla que muestra el resultado de la solicitud en Microsoft Teams.

Consumir Microsoft Graph en lus aplicaciones con la ayuda de el Explorador de gráficos

El explorador de archivos tiene otras funciones que pueden ayudarte a conectar tus aplicaciones con Microsoft Graph:

  1. Token de acceso: las API de Microsoft Graph utilizan tokens de acceso para establecer la identidad del usuario y realizar la autenticación y autorización. En la pestaña Ficha de acceso, puede copiar su propia ficha de acceso/autenticación.

  2. Fragmentos de código: si prueba cualquier consulta de Microsoft Graph en el Explorador de gráficos y desea consumir la misma consulta en su aplicación, puede ir a la pestaña Fragmentos de código para obtener el código relacionado para agregarlo en su aplicación. Hay fragmentos de código disponibles en C#, JavaScript, Java y Objective-C para todas las consultas de ejemplo.

  3. Componente del kit de herramientas : los componentes del Kit de herramientas de Microsoft Graph son componentes web que no están ligados a ningún framework y que le ayudan a acceder a Microsoft Graph. Puede utilizar la pestaña de Componentes del kit de herramientas para probar estos componentes HTML y consumirlos en tus aplicaciones web para recuperar datos de Microsoft 365 a través de Microsoft Graph. Cuando se ejecuta una consulta y un componente del kit de herramientas está disponible para la consulta, aparece un punto azul en la parte derecha de la pestaña.

  4. Tarjetas adaptativas : las tarjetas adaptativas son componentes de la interfaz de usuario que no están vinculados a ninguna plataforma y que suelen utilizarse en los bots. Si desea consumir Microsoft Graph en sus chatbots, como el ejemplo del bot de calendario dado anteriormente, puede utilizar la pestaña de Tarjetas adaptativas para obtener el fragmento de interfaz de usuario. Si ejecuta una consulta y hay una tarjeta adaptativa disponible para la consulta, aparece un punto azul en la parte derecha de la pestaña.

    Captura de pantalla que muestra cómo consumir Microsoft Graph en sus aplicaciones con la ayuda del Explorador de gráficos.

El explorador de gráficos es una herramienta en continua evolución con muchas características que ayudan a facilitar el aprendizaje y la práctica a las personas que están descubriendo las características de Microsoft Graph.