Modelos de pago y requisitos de licencia para las API de Microsoft Teams

En este artículo se describen los modelos de pago y los requisitos de licencia para las API de Microsoft Teams en Microsoft Graph. Para obtener una descripción de alto nivel de las API y servicios medidos en Microsoft Graph, consulte Introducción a las API y servicios medidos en Microsoft Graph.

Algunas API proporcionan la opción de elegir un modelo de licencia y pago mediante el parámetro de model consulta; otras solo admiten un modelo o no admiten un modelo de licencias y pagos.

En la tabla siguiente se enumeran las API y la notificación deresources cambios que actualmente admiten modelos de pago.

API o notificación de cambiosresources	Modelos de pago
resources Notificación de cambio: /chats/getAllMessges /teams/getAllMessages /chats/getAllMembers /teams/getAllMembers	A, B
resources Notificación de cambio: /users/{user-id}/chats/getAllMessages /me/chats/getAllMessages /appCatalogs/teamsApps/{app-id}/installedToChats /appCatalogs/teamsApps/{app-id}/installedToChats/getAllMessages /appCatalogs/teamsApps/{app-id}/installedToChats/getAllMembers	N
Exportar API: GET /users/{user-id}/chats/getAllMessages GET /users/{user-id}/chats/getAllRetainedMessages GET /me/chats/getAllMessages GET /teams/{team-id}/channels/getAllMessages GET /teams/{team-id}/channels/getAllRetainedMessages GET /teamwork/deletedTeams/{deletedTeamId}/channels/getAllMessages	A, B
LAS API PATCH, al actualizar la policyViolation propiedad: PATCH /teams/{team-id}/channels/{channel-id}/messages/{message-id} PATCH /teams/(team-id)/channels/{channel-id}/messages/{message-id}/replies/{reply-id} PATCH /chats/{chatThread-id}/messages/{message-id}	A
API de reunión de Teams: GET /users/{userId}/onlineMeetings/{meetingId}/transcripts/{transcriptId}/content GET /users/{userId}/onlineMeetings/{meetingId}/transcripts/{transcriptId}/metadataContent GET /users/{userId}/onlineMeetings/{meetingId}/recordings/{recordingId}/content	Sin parámetro de modelo

Nota:

Para configurar una suscripción de Azure activa para la aplicación con fines de facturación, consulte Habilitación de api y servicios de Microsoft 365 medidos. Para obtener más información, consulte Actualizaciones de pago y facturación.

Modelos de pago

Están disponibles los siguientes modelos de pago:

• model=A está restringido para las aplicaciones que realizan una función de seguridad o cumplimiento y requiere una licencia compatible.

• model=B está restringido a las aplicaciones que no realizan una función de seguridad o cumplimiento. No hay requisitos de licencia para model=B.

• El modo de evaluación (predeterminado) permite el acceso a las API con un uso limitado por aplicación solicitante y con fines de evaluación. Las notificaciones de cambio no se envían si se supera el límite.

Nota:

Para agregar o cambiar un modelo de pago para un recurso suscrito de una notificación de cambio, debe crear una nueva suscripción de notificación de cambio con el nuevo modelo de pago; Actualizar una notificación de cambio existente no funciona.

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.

Las SIGUIENTES API admiten el model=A parámetro .

API o notificación de cambiosresources	¿Quién necesita una licencia?	Límite de capacidad	Precio por uso adicional	Notas
resources Notificación de cambio: /chats/getAllMessges /teams/getAllMessages	Remitente de los mensajes	(800 mensajes × licencias admitidas con DLP habilitado) al mes por aplicación	0.00075 USD por mensaje	El límite de capacidad se comparte con las notificaciones de cambio de conversationMember
resources Notificación de cambio: /chats/getAllMembers /teams/getAllMembers	Cualquier usuario del espacio empresarial	(800 notificaciones × licencias admitidas con DLP habilitado) al mes por aplicación	0.00075 USD por notificación	El límite de capacidad se comparte con las notificaciones de cambio de chatMessage
Apis: GET /users/{user-id}/chats/getAllMessages GET /users/{user-id}/chats/getAllRetainedMessages GET /me/chats/getAllMessages	Usuario identificado	(1600 mensajes × licencias admitidas con DLP habilitado) al mes por 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. Las solicitudes que devuelven una lista vacía se cobran como un mensaje. El límite de capacidad se comparte con la exportación de canales.
Apis: GET /teams/{team-id}/channels/getAllMessages GET /teams/{team-id}/channels/getAllRetainedMessages GET /teamwork/deletedTeams/{deletedTeamId}/channels/getAllMessages	Cualquier miembro del equipo	(1600 mensajes × licencias admitidas con DLP habilitado) al mes por aplicación	0.00075 USD por mensaje	Las solicitudes que devuelven una lista vacía se cobran como un mensaje. El límite de capacidad se comparte con la exportación de chats.
API, al actualizar la policyViolation propiedad: PATCH /teams{team-id}/channels/{channel-id}/messages/{message-id} PATCH /teams/(team-id)/channels/{channel-id}/messages/{message-id}/replies/{reply-id} PATCH /chats/{chatThread-id}/messages/{message-id}	Remitente de los mensajes	(800 mensajes × licencias admitidas con DLP habilitado) al mes por aplicación	0.00075 USD por mensaje

Licencias necesarias para model=A

El usuario necesita una licencia que admita el plan de servicio DLP de Microsoft Communications, como 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 inquilino (no del propietario de la aplicación) asegurarse de que los usuarios tengan una licencia adecuada. Los administradores pueden usar el informe de licencias de Information Protection en el Centro de administración de Teams para ver qué usuarios no tienen una licencia admitida.

Muchas licencias admitidas ofrecen pruebas gratuitas. Office 365 E5, por ejemplo, tiene un vínculo De prueba gratuita en el botón Comprar.

Puede calificar para uno a través del Programa para desarrolladores de Microsoft 365; Para obtener más información, consulte las preguntas más frecuentes. Como alternativa, puede registrarse para obtener una evaluación gratuita de 1 mes o comprar un plan de Microsoft 365.

Nota:

El plan de servicio DLP de Microsoft Communications debe estar habilitado para poder obtener una licencia. Puede administrar licencias en el Centro de administración Microsoft Entra o el Centro de administración de Microsoft 365. También puede asignar licencias a una cuenta de grupo mediante la API REST de Microsoft Graph Graph y el SDK de PowerShell.

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.

Las SIGUIENTES API admiten el model=B parámetro .

API o notificación de cambiosresources	Límite de capacidad	Precio de uso	Notas
resources Notificación de cambio: /chats/getAllMessages /teams/getAllMessages /users/{user-id}/chats/getAllMessages /me/chats/getAllMessages /appCatalogs/teamsApps/{app-id}/installedToChats/getAllMessages	Ninguno	0.00075 USD por mensaje
resources Notificación de cambio: /chats/getAllMembers /teams/getAllMembers /appCatalogs/teamsApps/{app-id}/installedToChats/getAllMembers	None	0.00075 USD por notificación
resources Notificación de cambio: /appCatalogs/teamsApps/{app-id}/installedToChats	Ninguno	0.00075 USD por mensaje
Apis: GET /users/{user-id}/chats/getAllMessages GET /users/{user-id}/chats/getAllRetainedMessages GET /me/chats/getAllMessages	Ninguno	0.00075 USD por mensaje	Las solicitudes que devuelven una lista vacía se cobran como un mensaje.
Apis: GET /teams/{team-id}/channels/getAllMessages GET /teams/{team-id}/channels/getAllRetainedMessages GET /teamwork/deletedTeams/{deletedTeamId}/channels/getAllMessages	Ninguno	0.00075 USD por mensaje	Las solicitudes que devuelven una lista vacía se cobran como un mensaje.

Requisitos del modo de evaluación (predeterminado)

Las siguientes API admiten el modo de evaluación. La cuota de evaluación se aplica por aplicación, por inquilino y mes. La cuota se restablece al principio de cada mes natural y cualquier cantidad no utilizada no se transfiere al mes siguiente.

API o notificación de cambiosresources	Cuota de evaluación	Precio por uso adicional	Notas
resources Notificación de cambio: /chats/getAllMessges /teams/getAllMessages /users/{user-id}/chats/getAllMessages /me/chats/getAllMessages /appCatalogs/teamsApps/{app-id}/installedToChats/getAllMessages	500 mensajes al mes por inquilino por aplicación	N/D
resources Notificación de cambio: /chats/getAllMembers /teams/getAllMembers /appCatalogs/teamsApps/{app-id}/installedToChats/getAllMembers	500 mensajes al mes por inquilino por aplicación	N/D
resources Notificación de cambio: /appCatalogs/teamsApps/{app-id}/installedToChats	500 mensajes al mes por aplicación	N/D
Apis: GET /users/{user-id}/chats/getAllMessages GET /users/{user-id}/chats/getAllRetainedMessages GET /me/chats/getAllMessages	500 mensajes al mes por inquilino por aplicación	N/D	Las solicitudes que devuelven una lista vacía se cobran como un mensaje.
Apis: GET /teams/{team-id}/channels/getAllMessages GET /teams/{team-id}/channels/getAllRetainedMessages GET /teamwork/deletedTeams/{deletedTeamId}/channels/getAllMessages	500 mensajes al mes por inquilino por aplicación	N/D	Las solicitudes que devuelven una lista vacía se cobran como un mensaje.
API, al actualizar la policyViolation propiedad: PATCH /teams{team-id}/channels/{channel-id}/messages/{message-id} PATCH /teams/(team-id)/channels/{channel-id}/messages/{message-id}/replies/{reply-id} PATCH /chats/{chatThread-id}/messages/{message-id}	500 mensajes al mes por inquilino por aplicación	N/D
API de transcripción de reuniones de Teams: GET /users/{userId}/onlineMeetings/{meetingId}/transcripts/{transcriptId}/content GET /users/{userId}/onlineMeetings/{meetingId}/transcripts/{transcriptId}/metadataContent	600 minutos al mes por inquilino por aplicación	N/D
API de grabación de reuniones de Teams: GET /users/{userId}/onlineMeetings/{meetingId}/recordings/{recordingId}/content	600 minutos al mes por inquilino por aplicación	N/D

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 agrupa en el nivel de inquilino: la capacidad de inicialización de todos los usuarios del inquilino se compara con el uso de la aplicación en el inquilino. La capacidad de inicialización es por aplicación por inquilino: una aplicación no se queda sin capacidad de inicialización si se agota otra aplicación. La capacidad de inicialización se restablece al principio de cada mes natural y cualquier cantidad no utilizada no se transfiere al mes siguiente.

Modelo de pago	Casos de uso	Límite de capacidad	Licencia requerida	Se requiere una suscripción de Azure
model=A	Seguridad y cumplimiento	Consulte model=A los requisitos	Sí (Microsoft 365 E5 licencia apta)	Yes
model=B	Copia de seguridad y restauración, migración, análisis de sentimiento, análisis e información	Ninguno	No	Sí

La capacidad de inicialización no es aplicable a las API de reunión de Teams. Para obtener más información, consulte Requisitos de pago para las API de reunión.

Requisitos de pago para cumplir las API

En esta sección se describen los requisitos de pago para las API de grabación y transcripción de reuniones de Teams. Estas API no admiten los modelos de pago modelo A y modelo B y las puede usar cualquier aplicación, independientemente del caso de uso.

Estas API admiten un modo de evaluación que las aplicaciones pueden usar sin configurar la facturación de Azure. En la tabla siguiente se resume el comportamiento del modo de evaluación.

Configuración de facturación de Azure	Resultado
No configurado	La capacidad del modo de evaluación está disponible para su descarga. Además, se produce un error en la API con el código 402 de error (pago obligatorio).
Configurado	El contenido ilimitado de la reunión está disponible para su descarga y tiene un precio basado en el minuto de contenido, como se describe en la tabla siguiente. Todavía se aplican los límites de RPS de ingeniería.

En la tabla siguiente se enumeran los precios para usar las API de reunión de Teams, aplicables a los puntos de conexión beta y v1.0.

API	Límite de capacidad	Precio de uso	Notas
API de grabación de reuniones de Teams: GET /users/{userId}/onlineMeetings/{meetingId}/recordings/{recordingId}/content	Ninguno	0,003 USD por minuto	La duración se redondea hacia abajo hasta el minuto más cercano.
API de transcripción de reuniones de Teams: GET /users/{userId}/onlineMeetings/{meetingId}/transcripts/{transcriptId}/content GET /users/{userId}/onlineMeetings/{meetingId}/transcripts/{transcriptId}/metadataContent	Ninguno	0,0022 USD por minuto	La duración se redondea hacia abajo hasta el minuto más cercano.

Pago y facturación

Si las aplicaciones usan o usarán cualquiera de las API o notificacionesresources de cambio mencionadas anteriormente, debe seguir los pasos descritos en Habilitación de servicios y API de Microsoft 365 medidos para configurar una suscripción de Azure activa con fines de facturación.

La organización propietaria del registro de la aplicación es responsable del pago. La suscripción de Azure también debe estar activa en el mismo inquilino. En el caso de las aplicaciones multiinquilino, la organización que registró la aplicación podría ser diferente de la organización que ejecuta la aplicación.

Errores relacionados con el pago

Si se detecta una licencia incorrecta, se produce 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 402 error. En el caso de las notificaciones de cambio, los mensajes enviados por usuarios sin licencia no generarán una notificación de cambio. Se producirá un error en las llamadas API y las notificaciones de cambio usadas en el modo de evaluación que superen la cuota de evaluación.

Código de error	Escenario	Ejemplo de mensaje de error
402 (Pago obligatorio)	Falta una suscripción de facturación activa de Azure	...To call this API, the app must be associated with an Azure subscription, see https://aka.ms/teams-api-payment-requirements for details....
402 (Pago obligatorio)	Pasar model=A sin una licencia de Microsoft E5 o sin DLP habilitado	...needs a valid license to access this API..., ...tenant needs a valid license to access this API...
402 (Pago obligatorio)	Llamada al paso de Patch API model=B	...query parameter 'model' does not support value 'B' for this API. Use billing model 'A'...
402 (Pago obligatorio)	Evaluation mode capacidad superada	...evaluation capacity for the month has exceeded. To continue beyond the evalution limits complete billing onboarding...

Nota:

Una llamada API correcta no significa que se haya implementado la licencia necesaria. Del mismo modo, el éxito de la API en el modelo de evaluación no garantiza que la llamada esté dentro de la capacidad de inicialización.

Visualización de los costos facturados por las API de Microsoft Teams de uso medido

En esta sección se describe cómo supervisar los costos facturados por las API de Microsoft Teams de uso medido.

Un propietario de suscripción, o cualquier persona con los permisos de RBAC (roles basados en Access Control) adecuados, puede usar análisis de costos para realizar un seguimiento del consumo de API medido, como se indica a continuación:

1. Inicie sesión en Azure Portal en https://portal.azure.com.
2. Vaya a Cost Management + Billing Cost Management Cost analysis (Análisis de costos de Cost Management + Billing > Cost Management>).
3. Para el filtro situado cerca de la parte superior, seleccione Nombre del servicio: Microsoft Graph Services.
4. En el menú desplegable Agrupar por situado a la derecha, seleccione Medidor.

Esta vista ofrece una manera cómoda de observar el consumo de API al día durante un período de tiempo.

También puede usar los gráficos circulares situados cerca de la parte inferior para desglosar aún más los costos de análisis mediante los filtros De recursos y medidores .

Para obtener más información sobre la administración de costos, consulte la documentación de Cost Management + Billing.

Supervisión del número de mensajes facturados por las API de Teams de uso medido

En esta sección se describe cómo supervisar el número de mensajes facturados por las API de Teams de uso medido. A diferencia del análisis de costos, esto le permite analizar el uso de mensajes dentro de la capacidad de inicialización, no solo los que están por encima de la capacidad de inicialización para la facturación, si corresponde a los modelos de licencia seleccionados.

Un propietario de la suscripción, o cualquier persona con los permisos de RBAC (roles basados en Access Control) necesarios, puede configurar un informe, en formato CSV, con los detalles de facturación de toda la suscripción. Puede exportar el informe periódicamente (diariamente, semanalmente, mensualmente). Para obtener más información, consulte Tutorial: Creación y administración de datos exportados.

Estimación del número de mensajes en Teams

En esta sección se describe cómo buscar el número de mensajes en el inquilino de Teams. Esto puede ayudarle a calcular el costo del uso de las API de uso medido. Si un mensaje se recupera a través de api de uso medido varias veces, se factura varias veces. Tenga esto en cuenta cuando calcule el costo en función del número de mensajes en el inquilino de Teams. Por ejemplo, si llamó getAllMessages (sin filtros) ayer y, a continuación, lo volvió a llamar (sin filtros) hoy, todos los mensajes de antes de hoy se facturarán dos veces. Por este motivo, al usar API de uso medido, se recomienda usar filtros (por ejemplo, $top=10, $filter=lastModifiedDateTime gt 2019-03-17T07:13:28.000z) o notificaciones de cambio para evitar recuperar el mismo mensaje varias veces.

También puede llamar a la API getTeamsUserActivityUserDetail, o bien puede usar el Centro de Administración de Microsoft Teams como se indica a continuación:

Nota: Debe ser un administrador de servicios de Teams o lector global para ver el informe en el Centro de Administración de Microsoft Teams. Para obtener más información, consulte Uso de roles de administrador de Teams para administrar Teams.

1. En el panel izquierdo, elija Análisis & informes>informes de uso.
2. En la pestaña Ver informes , en Informe, elija Actividad de usuario de Teams.
3. En Intervalo de fechas, seleccione un intervalo.
4. Elija Ejecutar informe.

Preguntas frecuentes

Escenario	Detalles
¿Por qué se facturó el número de mensajes más alto que el número de mensajes en Mis equipos?	Si la aplicación recupera el mismo mensaje varias veces, se factura varias veces. Una manera de evitar esto es usar notificaciones de cambio en lugar de exportar API. Si debe usar las API de exportación, asegúrese de usar filtros (por ejemplo, $filter=lastModifiedDateTime, $filter=from).
¿La facturación comenzó realmente el 5 de julio?	Sí, vamos a incorporar asociados en fases. Para obtener acceso continuado, siga las instrucciones de Habilitación de api y servicios de Microsoft 365 medidos para configurar una suscripción activa de Azure con fines de facturación.
¿Qué debo esperar después de configurar una suscripción de Azure?	La facturación es efectiva inmediatamente. Puede supervisar los costos como se describe en la sección Ver los costos facturados por las API de Microsoft Teams medidas anteriormente.
¿Es necesario proporcionar una suscripción de Azure si mi aplicación no llama a las API de uso medido?	Se recomienda proporcionar una suscripción de Azure porque la mayoría de los escenarios usan API de uso medido.
¿Qué ocurre si no se proporciona ninguna suscripción de Azure?	* No se producen errores relacionados con el pago si la aplicación no llama a las API de uso medido. * Si no se pasa ningún parámetro de modelo, el evaluation model valor se usa de forma predeterminada. * Si llama a una API de uso medido pasando model=A, proporcione una licencia válida Microsoft 365 E5 y una suscripción de Azure. * Si se pasa model=B al llamar a LAS API de uso medido, proporcione una suscripción de Azure activa.
Cómo crear una suscripción de Azure?	La suscripción de Azure debe estar disponible en el mismo inquilino donde está registrada la aplicación. Los clientes con contratos MCA o EA pueden obtener una suscripción de su cuenta existente. También es posible crear una suscripción a PAYG con una tarjeta de crédito o pagar mediante cheque o transferencia bancaria. Para obtener más información, consulte Habilitación de api y servicios de Microsoft 365 medidos y administración de costos y facturación.
¿Quién es responsable del pago en el caso de aplicaciones multiinquilino?	La organización propietaria del registro de la aplicación.
¿Es posible diferenciar la facturación de una aplicación multiinquilino o de un solo inquilino?	Sí, esta información debe proporcionarse como parte de los detalles de facturación de Azure.
¿Hay un cargo cuando no se devuelve ningún mensaje con ningún modelo?	Para desalentar el sondeo frecuente, se cobrará un mensaje a las solicitudes de API que devuelven una lista vacía de mensajes. En el caso de evaluation model, la llamada cuenta para los 500 mensajes al mes por aplicación permitidos.
¿Dónde puedo supervisar el costo y la facturación?	Un propietario de suscripción o cualquier persona con RBAC adecuado (Access Control basado en roles) puede usar la herramienta Análisis de costos de Azure para realizar un seguimiento del consumo al día o filtrar por medidor, nombre del servicio, identificador de recurso, entre otros parámetros. Para obtener más información, consulte Ver los costos facturados por las API de Microsoft Teams que se han medido anteriormente.
¿Hay un descuento por volumen?	Se aplican tarifas planas.
¿Estas API están inscritas en el programa Microsoft Azure Consumption Commitment (MACC)?	De momento, no.