Usar la API de Microsoft Graph para trabajar con Microsoft Teams

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.

Casos de uso comunes

Casos de uso Recursos de REST Consulte también
Creación y administración de equipos, grupos y canales equipo, canal, grupo crear equipo, enumerar equipos, crear canal
Agregar pestañas, administrar o instalar aplicaciones en el catálogo de aplicaciones de Microsoft Teams teamsTab, teamsAppInstallation create teamsTab, list teamsTab, list apps
Creación de canales y chats para enviar y recibir mensajes de chat channel, chat, chatMessage create channel, list channel, send chatMessage
Uso de etiquetas para clasificar usuarios o grupos en función de atributos comunes dentro de un equipo teamworkTag, teamworkTagMember list teamworkTag, create teamworkTag
Creación y recepción de llamadas, registros de llamadas o recuperación de coordenadas de reunión call, callRecords respuesta, invitar a participantes
Conexión de bots a llamadas e implementación de respuesta de voz interactiva (IVR) Escenarios IVR
Creación y recuperación de reuniones en línea o comprobación de la presencia y actividad de los usuarios onlineMeetings, presencia create onlineMeetings, meetingAttendanceReport
Creación y administración de la integración del personal con turnos, programaciones, tarjetas de tiempo o tiempo de espera en la organización workforceIntegration, schedule, shift, timeOff, timeOffReason create workforceIntegration, create schedule, create shift, create timeOff
Uso de la API de aprendizaje de empleados para integrarse con Viva Learning aprendizaje de empleados, learningProvider, learningContent list learningProviders, list learningContents

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:

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.