La API de Microsoft Graph es más que una simple API. Es una colección de API dispares que cubren cargas de trabajo en la pila de Microsoft 365, reunidas bajo un conjunto común de estándares y suposiciones. Así que no solo estamos hablando de Microsoft equipos API, pero todo lo demás relacionado con ella. Te detallaremos las 10 cosas que puede hacer con el blog de Microsoft Teams.
Anteriormente, los desarrolladores tenían que aprender la sintaxis y las peculiaridades de las API individuales, encontrar la documentación, lidiar con la autenticación y los permisos, etc.
Ahora existe un modelo común de autenticación y autorización con comportamientos estandarizados para el procesamiento por lotes, la paginación y la limitación. Para las aplicaciones que analizan varias aplicaciones de Microsoft, esta es una forma de trabajo mucho más sencilla.
Esta abstracción también hace que sea mucho más fácil para los desarrolladores incorporar rápidamente la funcionalidad de otras áreas de Microsoft 365 para mejorar sus aplicaciones. Microsoft ha estado agregando silenciosamente más y más funciones a Graph en los últimos años, y ahora hay una sorprendente riqueza de funciones que cubre mucho más que métodos de transición para leer y actualizar datos.
Aquí hay 10 usos de la API de Microsoft Graph que podrían sorprenderlo:
1 – Administrar buzones de usuario
Índice de Contenidos
Los administradores de TI pueden usar Microsoft Graph para leer y luego actualizar la configuración del buzón de correo para los usuarios de los que son responsables.
Esto incluye la capacidad de establecer respuestas automáticas (respuestas fuera de la oficina) para los usuarios, así como horas de trabajo, zonas horarias, opciones de delegado, etc.
Un ejemplo de uso es automatizar una respuesta para los usuarios que abandonan una organización durante un período de tiempo específico antes de que se elimine su buzón. (La eliminación del buzón de correo también se puede lograr a través de una llamada a Graph API).
2 – Imprima un documento de forma remota usando CloudPrint
Microsoft Graph no se trata solo de realizar cambios transaccionales en los datos. Un ejemplo de esto es el soporte de API para CloudPrint. Esto permite a los desarrolladores enviar documentos de forma remota a una impresora CloudPrint mediante una llamada a la API.
No se necesitan controladores de impresora u otras configuraciones; ¡Simplemente haga una solicitud HTTP para cargar el documento y crear un trabajo de impresión!
Esta llamada a la API se puede realizar tanto dentro como fuera de la red corporativa, lo que significa que se puede activar desde un dispositivo móvil, un dispositivo de Internet de las cosas (IoT) o desde un trabajo por lotes interno programado.
Guía: Crear trabajo de impresión: Microsoft Graph v1.0 | Documentos de Microsoft
3 – Administrar el ciclo de vida de Microsoft Teams
Mantener la colección cada vez mayor de equipos y canales de una organización puede ser un trabajo de tiempo completo, pero existen API para ayudarlo a automatizar el proceso.
Ya sea para crear equipos de una manera establecida con una lista de canales y configuraciones de seguridad predefinidos, rastreando a los propietarios para archivar equipos inactivos o monitoreando qué aplicaciones están instaladas y dónde: hay varias llamadas API diferentes que puede usar para administrar todo el ciclo de vida de un equipo de Microsoft Teams.
También hay llamadas especiales para archivar y luego desarchivar equipos, equipos de clonación y un conjunto especial de operaciones API que le permiten importar datos de mensajes históricos de otras plataformas a nuevos equipos mientras conserva la fecha, la hora y la voluntad del colaborador originales.
4 – Actualice un libro de Excel agregando nuevos datos y volviendo a calcular fórmulas
Para mí, nada demuestra más el poder de Microsoft Graph que esta función. Con las llamadas a la API en Microsoft Graph, su aplicación puede abrir un libro de Excel existente, insertar datos, volver a calcular fórmulas, crear nuevas fórmulas, actualizar o crear nuevos gráficos.
En definitiva, todo lo que una persona normalmente tarda en hacer.
Para los libros de trabajo que deben actualizarse regularmente con datos de sistemas externos, la automatización de este proceso puede acelerar drásticamente la forma en que funciona su negocio y hacer que sus tomadores de decisiones sean más productivos.
Ejemplo de un filtro de tabla:
POST https://graph.microsoft.com/v1.0/me/drive/items/01CYZLFJGUJ7JHBSZDFZFL25KSZGQTVAUN/workbook/worksheets('Sheet15799')/tables('table2')/columns(id='2')/filter/apply
authorization: Bearer {access-token}
workbook-session-id: {session-id}
{
"criteria" :
{ "filterOn": "custom",
"criterion1": ">15",
"operator": "and",
"criterion2": "<50"
}
}Guía: Trabajar con Excel en Microsoft Graph – Microsoft Graph v1.0 | Documentos de Microsoft
5 – Envíe mensajes multiplataforma a Webex
Utilizando las API de Microsoft Teams, Mio, puede traducir mensajes de chat en Webex. Esto significa que cualquier usuario de su organización que prefiera Webex Teams ya no se quedará fuera de la conversación. Y no tiene que dejar Teams para colaborar con ellos.
Mio espera un evento en Teams y luego lo envía a Webex. Se llama interoperabilidad de mensajes y es un requisito en empresas que cuentan con más de una plataforma de colaboración.
Además de un mensaje de chat estándar, se admiten las siguientes funciones:
- ediciones de mensajes
- Hilos de mensajes
- eliminaciones de mensajes
- canal de noticias
- mensajes de grupo
- GIF y emojis
- Cargas de archivos
- Formato de texto enriquecido
6 – Actuar sobre los datos en tiempo real
Además de poder realizar solicitudes para obtener y establecer datos, Microsoft Graph admite el uso de notificaciones de cambios (también conocidos como webhooks) para proporcionar notificaciones en tiempo real de cambios en los datos.
Esta característica aún no es compatible universalmente, pero incluye nuevos mensajes de chat de Teams, nuevos archivos, eventos de calendario e incluso reuniones y llamadas de Teams.
Las notificaciones de cambios eliminan la necesidad de que las aplicaciones consulten nuevos datos y permiten más modelos de programación sin servidor con microservicios.
7 – Seguimiento del uso de Microsoft Teams, Outlook y Yammer
Gran parte de los datos de uso disponibles en el centro de administración de Microsoft 365 también se muestran en Microsoft Graph a través de una sección /informes dedicada.
Esto incluye llamadas API para rastrear el uso de Microsoft Teams, Outlook y Yammer y determinar el uso de usuarios individuales a lo largo del tiempo.
Puede usar estos datos para crear sus propios gráficos de uso o para analizar los datos en busca de otras tendencias. Las API de informes también muestran las activaciones y los usuarios activos de Microsoft 365.
8 – Fotos de usuario con marca de agua
Con los permisos adecuados, es posible usar la API de Microsoft Graph para recuperar y actualizar la información del usuario, incluidas las fotos de perfil del usuario.
Una organización que quiera marcar todas las imágenes de los usuarios con el logotipo de una empresa o agregar un certificado a usuarios específicos podría usar Graph para lograrlo descargando la foto, modificándola y luego volviéndola a cargar.
Esta puede ser una forma efectiva de reconocer a los campeones de adopción de usuarios, al empleado del mes o iniciativas similares.
Guía: Actualizar foto de perfil – Microsoft Graph v1.0 | Documentos de Microsoft
9 – Obtenga información sobre el comportamiento del usuario
Microsoft 365 se ha convertido en un repositorio completo de información sobre una organización, con conocimiento de quién está creando y accediendo a qué documentos, quién está hablando con quién y qué temas son tendencia en una organización.
Algunos de estos metadatos empresariales se exponen en Graph API a través de tres API diferentes:
- La API de tendencias muestra documentos de OneDrive y SharePoint que son tendencia para un usuario específico
- La API utilizada enumera los documentos que un usuario ha visto o modificado recientemente
- API compartida devuelve información sobre documentos compartidos con o por el usuario
Estos documentos pueden incluir direcciones URL, archivos adjuntos en Outlook y Teams, archivos de OneDrive y SharePoint, y mensajes y reuniones de Outlook.
La combinación de estas API puede pintar una imagen completa de las interacciones de un usuario dentro de una organización.
10 – Administrar recursos educativos
Un hecho menos conocido sobre Microsoft Teams es que tiene un conjunto completo de características diseñado específicamente para el sector educativo. Esto permite a los maestros programar y realizar clases, establecer tareas y recopilar y calificar el trabajo de los equipos.
También hay un conjunto rico y correspondiente de API de Microsoft Teams que se puede usar para trabajar con estos datos educativos, lo que permite la integración con otro software educativo.
Algunas de las API aquí son útiles al aprovisionar un arrendatario con Microsoft School Data Sync.
Guía: Trabajar con API educativas en Microsoft Graph – Microsoft Graph v1.0 | Documentos de Microsoft
Conclusión
Como puede ver, la API de Microsoft Teams (o Graph API, como deberíamos llamarla) contiene algunas llamadas sorprendentes y poderosas y se puede usar para iniciar acciones y hacer que las cosas funcionen, no solo para cambiar datos.
Debido al modelo común de autenticación y autorización, una vez que haya usado Graph API para un propósito en su aplicación, es fácil incorporar esta funcionalidad, incluso si se trata de una carga de trabajo completamente diferente en Microsoft 365.
Puede ser un desafío mantenerse al día con las nuevas funciones, pero recomendamos revisar regularmente la documentación de la API de Microsoft Graph para asegurarse de que los desarrolladores estén al tanto de lo que está disponible.
Tom Morgan es MVP de Microsoft y arquitecto de innovación de productos en Modalidad Systems. Recientemente escribió Creación y desarrollo de aplicaciones y bots para Microsoft Teams.
