Requisitos de licencias y pago para la API de Microsoft Teams

En este artículo se describen los requisitos de licencia y pago de las API de Microsoft Teams en Microsoft Graph.

Algunas API ofrecen la opción de elegir un modelo de pago y licencias mediante el parámetro de consulta model; otras o bien admiten un solo modelo o no admiten un modelo de pago y licencias. Las siguientes API tienen cargas de consumo:

Se encuentran disponibles los siguientes modelos de licencia:

Nota

A partir del 5 de julio de 2022, los eventos de fijación de precios para estas API alcanzarán la disponibilidad general. Es necesario que las solicitudes rellenen este formulario para proporcionar una suscripción activa a Azure a efectos de facturación. Para obtener más información, consulte actualizaciones recientes.

Requisitos de model=A

model=A está restringido a las aplicaciones que realizan una función de seguridad o cumplimiento. Para más información, consulte la sección Términos de la API para aplicaciones de seguridad y cumplimiento en los términos del producto para Microsoft Azure Services.

API ¿Quién necesita una licencia? Límite de capacidad Precio por uso adicional Notas
notificaciones de cambio de chatMessage Remitente de los mensajes 800 mensajes al mes por usuario y aplicación 0.00075 USD por mensaje El límite de capacidad se comparte con las notificaciones de cambio de conversationMember
notificaciones de cambio de conversationMember Cualquier usuario del espacio empresarial 800 notificaciones al mes por usuario y aplicación 0.00075 USD por notificación El límite de capacidad se comparte con las notificaciones de cambio de chatMessage
Obtener mensajes en todos los chats para un usuario Usuario identificado 1600 mensajes al mes por usuario y aplicación 0.00075 USD por mensaje El usuario identificado es el usuario que se ha identificado en la dirección URL de la solicitud GET. Cargo mínimo de 1 mensaje por solicitud de API. El límite de capacidad se comparte con la exportación de canales.
Obtener mensajes en todos los canales Cualquier miembro del equipo 1600 mensajes al mes por usuario y aplicación 0.00075 USD por mensaje Cargo mínimo de 1 mensaje por solicitud de API. El límite de capacidad se comparte con la exportación de chats.
actualizar la directiva policyViolation de un chatMessage Remitente de los mensajes 800 mensajes al mes por usuario y aplicación 0.00075 USD por mensaje

Requisitos de model=B

model=B está restringido a las aplicaciones que no realizan una función de seguridad o cumplimiento. Para más información, consulte la sección Términos de la API para aplicaciones de seguridad y cumplimiento en los términos del producto para Microsoft Azure Services.

API ¿Quién necesita una licencia? Límite de capacidad Precio por uso adicional Notas
notificaciones de cambio de chatMessage N/D Ninguno 0.00075 USD por mensaje
notificaciones de cambio de conversationMember N/D None 0.00075 USD por notificación
Obtener mensajes en todos los chats para un usuario N/D Ninguno 0.00075 USD por mensaje Cargo mínimo de 1 mensaje por solicitud de API.
Obtener mensajes en todos los canales N/D Ninguno 0.00075 USD por mensaje Cargo mínimo de 1 mensaje por solicitud de API.

Requisitos del modo de evaluación (predeterminado)

API ¿Quién necesita una licencia? Límite de capacidad Precio por uso adicional Notas
notificaciones de cambio de chatMessage N/D 500 mensajes al mes por aplicación N/D
notificaciones de cambio de conversationMember N/D 500 mensajes al mes por aplicación N/D
Obtener mensajes en todos los chats para un usuario N/D 500 mensajes al mes por aplicación N/D Cargo mínimo de 1 mensaje por solicitud de API.
Obtener mensajes en todos los canales N/D 500 mensajes al mes por aplicación N/D Cargo mínimo de 1 mensaje por solicitud de API.
actualizar la directiva policyViolation de un chatMessage N/D 500 mensajes al mes por aplicación N/D

En el modo de evaluación, la el límite de capacidad se comparte entre todas las API. Cuando se supera el límite de capacidad, las llamadas de API con requisitos de pago y licencias producirán un código de error 402 y las suscripciones con requisitos de pago y licencias no enviarán notificaciones de cambios.

Licencias necesarias para model=A

El usuario necesitará una licencia que admita el plan de servicio DLP de Microsoft Communications, como es una de estas licencias admitidas. Qué usuario necesita la licencia varía según la API; para más información, vea model=A requisitos.

Los usuarios invitados están exentos de estos requisitos de licencia. Del mismo modo, los mensajes enviados desde fuera del espacio empresarial (chat federado) están exentos. Se aplicarán contadores de consumo.

Es responsabilidad del propietario del espacio empresarial (no del propietario de la aplicación) asegurarse de que los usuarios tienen las licencias adecuadas. Los administradores pueden usar el informe de licencias de Information Protection en el centro de administración de Teams para ver qué usuarios no disponen de una licencia admitida.

Muchas licencias admitidas ofrecen pruebas gratuitas. Office 365 E5, por ejemplo, tiene un vínculo Free trial debajo del botón Buy.

Puede obtener una suscripción gratuita de espacio aislado para desarrolladores de Microsoft 365 E5 con 25 licencias de usuario a través del Programa de desarrolladores de Microsoft 365.

Se ha superado el límite de capacidad del modo de evaluación y de licencias incorrectas

En caso de que se detecten licencias incorrectas, se producirá un error en la llamada API y no se devolverán los datos. En concreto, para la mayoría de las API, si se intenta obtener mensajes para un usuario sin licencia, se producirá un código de error 402. Para las notificaciones de cambios, los mensajes enviados por usuarios sin licencia no generarán una notificación de cambio. Del mismo modo, se producirá un error en las llamadas API y las notificaciones de cambio que se usen en el modo de evaluación y superen el límite de capacidad.

Ejemplo de tipo de error Código de estado Ejemplo de mensaje de error
No se cumple el requisito de licencia de E5 402 (Pago obligatorio) ...needs a valid license to access this API..., ...tenant needs a valid license to access this API...
El modelo B no se admite para Patch API 402 (Pago obligatorio) ...query parameter 'model' does not support value 'B' for this API. Use billing model 'A'...
Se superó la capacidad de evaluación 402 (Pago obligatorio) ...evaluation mode capacity has been exceeded. Use a valid billing model...

Nota

Una llamada de API que se realice con éxito no equivale a tener la licencia adecuada. Del mismo modo, el éxito de la API en el modo de evaluación no garantiza que la llamada esté dentro de la capacidad inicializada.

Límite de capacidad

El límite de capacidad es la cantidad de capacidad que puede usar una aplicación antes de que se aplique un contador de consumo. La capacidad se acumula a nivel del espacio empresarial—el límite de capacidad para todos los usuarios del espacio empresarial se suma y se compara con el uso de la aplicación en dicho espacio empresarial. El límite de capacidad se aplica por aplicación y por espacio empresarial—las demás aplicaciones no agotarán el límite de capacidad si otra aplicación lo agota.

El límite de capacidad difiere en función de la API. Consulte los requisitos de model=A y los requisitos de model=B .

Actualizaciones recientes y precio por uso adicional

En octubre de 2021 comunicaremos las próximas tarifas para el consumo de estos API; el 5 de julio de 2022, estos precios entran en vigor tal y como se había anunciado anteriormente. Si sus aplicaciones llaman o van a llamar a alguna de estas API, le pedimos que rellene este formulario de solicitud proporcionando una suscripción activa a Azure. Cuando se haya enviado el formulario para registrar una aplicación, puede seguir usando estas API. Le informaremos de los siguientes pasos para incluir su solicitud en la facturación.

Tenga en cuenta que la organización propietaria del registro de la aplicación es responsable del pago. La suscripción de Azure debe estar activa en el mismo inquilino. Para las aplicaciones multiinquilino, la organización propietaria del registro de la aplicación puede ser diferente de la organización que ejecuta la aplicación.