Usar la API de Microsoft Graph para trabajar con Microsoft Teams

  • Artículo
  • Tiempo de lectura: 4 minutos

Microsoft Teams es un área de trabajo basada en chat de Microsoft 365 que ofrece acceso integrado a calendarios, archivos, notas de OneNote, planes de Planner, programaciones de Turnos y otras aplicaciones específicas del equipo.

Recursos clave en Microsoft Teams

Recurso Métodos
team List your teams, list all teams, create, read, update, delete, clone, archive, unarchive
group Add member, remove member, add owner, remove owner, get files, get notebook, get plans, get calendar
channel List, create, read, update, delete
teamsTab List, create, read, update, delete
teamsApp List, publish, update, remove
teamsAppInstallation List, install, upgrade, remove
chatMessage listar en el canal, listar en el chat, enviar, leer en el canal, leer en el chat
llamada Respuesta, rechazar, redirigir, silenciar, activar audio, cambiar el rol de pantalla compartida, lista de participantes, invitar participantes
schedule Crear o reemplazar, obtener, compartir
schedulingGroup Crear, Enumerar, Obtener, Reemplazar, Eliminar
activityFeedNotification Enviar una notificación al usuario en el ámbito de un chat, Enviar una notificación al usuario en el ámbito de un de equipo, Enviar una notificación al usuario en el ámbito personal
shift Crear, Enumerar, Obtener, Reemplazar, Eliminar
timeOff Crear, Enumerar, Obtener, Reemplazar, Eliminar
timeOffReason Crear, Enumerar, Obtener, Reemplazar, Eliminar

Límites de Microsoft Teams

Los límites de rendimiento y capacidad probados de Microsoft Teams se documentan en Límites y especificaciones de Microsoft Teams. Estos límites se aplican tanto si se usa Microsoft Teams directamente como si se usan las API de Microsoft Graph. Como cada equipo tiene un grupo correspondiente, y todos los grupos son objetos de directorio, también se pueden limitar el número de grupos y el número de objetos de directorio ("recursos").

Los archivos en canales se almacenan en SharePoint, por lo que se aplicarán los límites de SharePoint Online.

Vea también Limitación de servicios de Microsoft Teams.

Equipos y grupos

En Microsoft Graph, Microsoft Teams se representa mediante un recurso group. Los grupos de Microsoft Teams y Microsoft 365 abordan las diversas necesidades de colaboración en grupo. Casi todas las características que se basan en grupos se aplican a los grupos de Microsoft Teams y Microsoft 365, como el calendario de grupo, los archivos, las notas, las fotos, los planes, etcétera. La principal diferencia entre un team y un grupo de Microsoft 365 es el modo de comunicación entre los miembros. Los miembros de un equipo se comunican por chat persistente en el contexto de un equipo específico. Los miembros de un grupo de Microsoft 365 se comunican a través de las conversaciones del grupo, las cuales son conversaciones por correo electrónico que se ejecutan en el contexto de un grupo de Outlook.

Cualquier grupo que tiene un equipo tiene un equipo presenta una propiedad resourceProvisioningOptions que contiene "Equipo".

Nota: La propiedad Group.resourceProvisioningOptions puede cambiarse. No agregue ni quite "Equipo" de esa colección; en caso contrario, obtendrá resultados incorrectos cuando se enumeren todos los equipos.

Estas son las diferencias en el nivel de API entre equipos y grupos:

Nota: Si usa las API de grupo en una aplicación de Microsoft Teams, en lugar de una aplicación independiente (por ejemplo, como parte de una pestaña o un bot que se ejecuta en Microsoft Teams), siga las instrucciones de este artículo Using Microsoft Graph in your Microsoft Teams pages (Usar Microsoft Graph en sus páginas de Microsoft Teams).

Cambios de pertenencia en Microsoft Teams

Caso de uso Verbo URL
Agregar miembro POST /teams/{team-id}/members
Eliminar miembro DELETE /teams/{team-id}/members/{membership-id}
Actualizar el rol del miembro PATCH /teams/{team-id}/members/{membership-id}
Actualizar equipo PATCH /teams/{team-id}

Requisitos de sondeo

Si la aplicación realiza un sondeo para ver si un recurso ha cambiado, solo puede hacerlo una vez al día. (teamsAsyncOperation es una excepción que está previsto que se sondee con frecuencia). Si necesita ver los cambios con mayor frecuencia, debe crear una suscripción a ese recurso y recibir notificaciones de cambios (webhooks). Si no encuentra soporte técnico para el tipo de suscripción que necesita, le recomendamos que envíe comentarios a través del Foro de ideas de la plataforma Microsoft 365 para Desarrolladores.

Cuando se sondea para ver si hay mensajes nuevos, se debe especificar un intervalo de fechas donde se admita. Para obtener más información, vea obtener el delta de mensajes de canal.

El sondeo está realizando una operación GET en un recurso una y otra vez para ver si el recurso ha cambiado. Es posible usar GET para obtener el mismo recurso varias veces al día, siempre y cuando no sea un sondeo. Por ejemplo, es adecuado usar GET /me/joinedTeams cada vez que el usuario visita o actualiza la página web, pero no es adecuado usar GET /me/joinedTeams en un bucle cada 30 segundos para actualizar la página web.

Las aplicaciones que no cumplan con estos requisitos de sondeo se considerarán una violación de las Condiciones de uso de las API de Microsoft. Esto puede dar lugar a una limitación adicional o la suspensión o terminación del uso de las API de Microsoft.

Novedades

Descubra las nuevas características y actualizaciones para este conjunto de API.

Vea también