Modelos de pagamento e requisitos de licenciamento para APIs do Microsoft Teams
Este artigo descreve os modelos de pagamento e os requisitos de licenciamento para APIs do Microsoft Teams no Microsoft Graph. Para obter uma descrição de alto nível de APIs e serviços medidos no Microsoft Graph, consulte Visão geral das APIs e serviços medidos no Microsoft Graph.
Algumas APIs fornecem a opção de escolher um modelo de licenciamento e pagamento por meio do model
parâmetro de consulta; outras dão suporte apenas a um modelo ou não dão suporte a um modelo de licenciamento e pagamento.
A tabela a seguir lista as APIs e a notificação de alteraçãoresources
que atualmente dão suporte a modelos de pagamento.
APIs ou notificação de alteraçãoresources |
Modelos de pagamento |
---|---|
Notificação de alteraçãoresources :
|
A, B |
Notificação de alteraçãoresources :
|
B |
Exportar APIs: | A, B |
APIs patch, ao atualizar a policyViolation propriedade: |
A |
APIs de reunião do Teams: | Nenhum parâmetro de modelo |
Observação
Para configurar uma assinatura ativa do Azure para seu aplicativo para fins de cobrança, consulte Habilitar APIs e serviços do Microsoft 365 medidos. Para obter mais informações, consulte Atualizações de pagamento e cobrança.
Modelos de pagamento
Os seguintes modelos de pagamento estão disponíveis:
model=A
é restrito a aplicativos que executam uma função de segurança ou conformidade e exige uma licença com suporte.model=B
é restrito a aplicativos que não executam uma função de segurança ou conformidade. Não há requisitos de licenciamento paramodel=B
.O Modo de avaliação (padrão) permite o acesso a APIs com uso limitado por aplicativo solicitando para fins de avaliação. As notificações de alteração não serão enviadas se o limite for excedido.
Observação
Para adicionar ou alterar um modelo de pagamento para um recurso inscrito de uma notificação de alteração, você deve criar uma nova assinatura de notificação de alteração com o novo modelo de pagamento; A atualização de uma notificação de alteração existente não funciona.
Requisitos do model=A
model=A
é restrito a aplicativos que executam uma função de segurança ou conformidade. Para obter detalhes, consulte a seção Termos da API para Aplicativos de Segurança e Conformidade dos termos do produto para Serviços do Microsoft Azure.
As APIs a seguir dão suporte ao model=A
parâmetro.
APIs ou notificação de alteraçãoresources |
Quem precisa de uma licença | Capacidade propagada | Preço para uso adicional | Notas |
---|---|---|---|---|
Notificação de alteraçãoresources :
|
Remetente de mensagem | (800 mensagens × licenças com suporte com DLP habilitada) por mês por aplicativo | $0,00075 por mensagem | A capacidade de semente é compartilhada com notificações de alteração de conversationMember |
Notificação de alteraçãoresources :
|
Qualquer usuário no locatário | (800 notificações × licenças com suporte com DLP habilitada) por mês por aplicativo | US$ 0,00075 por notificação | A capacidade de propagação é compartilhada com notificações de alteração do chatMessage |
Apis: | Usuário nomeado | (1600 mensagens × licenças com suporte com DLP habilitada) por mês por aplicativo | $0,00075 por mensagem | O usuário nomeado é o usuário identificado na URL de solicitação GET. As solicitações que retornam uma lista vazia são cobradas como uma mensagem. A capacidade de propagação é compartilhada com a exportação de canal. |
Apis: | Qualquer membro da equipe | (1600 mensagens × licenças com suporte com DLP habilitada) por mês por aplicativo | $0,00075 por mensagem | As solicitações que retornam uma lista vazia são cobradas como uma mensagem. A capacidade de propagação é compartilhada com a exportação de chat. |
APIs, ao atualizar a policyViolation propriedade: |
Remetente de mensagem | (800 mensagens × licenças com suporte com DLP habilitada) por mês por aplicativo | $0,00075 por mensagem |
Licenças necessárias para model=A
O usuário precisa de uma licença que dê suporte ao plano de serviço DLP da Microsoft Communications, como uma dessas licenças com suporte.
Qual usuário precisa da licença varia de acordo com a API; para obter detalhes, consulte os model=A
requisitos.
Os usuários convidados estão isentos desses requisitos de licenciamento. Da mesma forma, as mensagens enviadas de fora do locatário (chat federado) são isentas. Os medidores de consumo ainda se aplicam.
É responsabilidade do proprietário do locatário (não do proprietário do aplicativo) garantir que os usuários sejam devidamente licenciados. Os administradores podem usar o relatório de licença de proteção de informações no centro de administração do Teams para ver quais usuários não têm uma licença com suporte.
Muitas licenças com suporte oferecem avaliação gratuita. Office 365 E5 por exemplo tem um link de avaliação gratuito no botão Comprar.
Você pode se qualificar para um por meio do Programa de Desenvolvedor do Microsoft 365; para obter detalhes, confira as perguntas frequentes. Como alternativa, você pode se inscrever para uma avaliação gratuita de 1 mês ou comprar um plano do Microsoft 365.
Observação
O plano de serviço DLP da Microsoft Communications deve ser habilitado para que ele possa ser licenciado. Você pode gerenciar licenças no centro de administração do Microsoft Entra ou no Centro de administração do Microsoft 365. Você também pode atribuir licenças a uma conta de grupo usando a API REST do Microsoft Graph e o SDK do PowerShell.
Requisitos do model=B
model=B
é restrito a aplicativos que não executam uma função de segurança ou conformidade. Para obter detalhes, consulte a seção Termos da API para Aplicativos de Segurança e Conformidade dos termos do produto para Serviços do Microsoft Azure.
As APIs a seguir dão suporte ao model=B
parâmetro.
APIs ou notificação de alteraçãoresources |
Capacidade propagada | Preço para uso | Observações |
---|---|---|---|
Notificação de alteraçãoresources :
|
Nenhum | $0,00075 por mensagem | |
Notificação de alteraçãoresources :
|
Nenhum | US$ 0,00075 por notificação | |
Notificação de alteraçãoresources :
|
Nenhum | $0,00075 por mensagem | |
Apis: | Nenhum | $0,00075 por mensagem | As solicitações que retornam uma lista vazia são cobradas como uma mensagem. |
Apis: | Nenhum | $0,00075 por mensagem | As solicitações que retornam uma lista vazia são cobradas como uma mensagem. |
Requisitos do modo de avaliação (padrão)
As APIs a seguir dão suporte ao modo de avaliação. A cota de avaliação é imposta por aplicativo, por locatário, por mês. A cota é redefinida no início de cada mês calendário, e qualquer valor não utilizado não é transportado para o próximo mês.
APIs ou notificação de alteraçãoresources |
Cota de avaliação | Preço para uso adicional | Notas |
---|---|---|---|
Notificação de alteraçãoresources :
|
500 mensagens por mês por locatário por aplicativo | N/D | |
Notificação de alteraçãoresources :
|
500 mensagens por mês por locatário por aplicativo | N/D | |
Notificação de alteraçãoresources :
|
500 mensagens por mês por aplicativo | N/D | |
Apis: | 500 mensagens por mês por locatário por aplicativo | N/D | As solicitações que retornam uma lista vazia são cobradas como uma mensagem. |
Apis: | 500 mensagens por mês por locatário por aplicativo | N/D | As solicitações que retornam uma lista vazia são cobradas como uma mensagem. |
APIs, ao atualizar a policyViolation propriedade: |
500 mensagens por mês por locatário por aplicativo | N/D | |
APIs de transcrição da reunião do Teams: | 600 minutos por mês por locatário por aplicativo | N/D | |
APIs de gravação de reunião do Teams: | 600 minutos por mês por locatário por aplicativo | N/D |
Capacidade propagada
A capacidade de propagação é a quantidade de capacidade que um aplicativo pode usar antes que um medidor de consumo seja cobrado. A capacidade é agrupada no nível do locatário, a capacidade semeada para todos os usuários do locatário é comparada com o uso do aplicativo no locatário. A capacidade semeada é por aplicativo por locatário— um aplicativo não ficará sem capacidade semeada se outro aplicativo acabar. A capacidade de semente é redefinida no início de cada mês civil, e qualquer valor não utilizado não é transportado para o próximo mês.
Modelo de pagamento | Casos de uso | Capacidade propagada | Licença necessária | Assinatura do Azure necessária |
---|---|---|---|---|
model=A |
Segurança e Conformidade | Consulte model=A requisitos |
Sim (Microsoft 365 E5 licença qualificada) | Sim |
model=B |
Backup e restauração, migração, análise de sentimento, análise e insights | Nenhum | Não | Sim |
A capacidade semeada não é aplicável às APIs de reunião do Teams. Para obter detalhes, consulte Requisitos de pagamento para APIs de reunião.
Requisitos de pagamento para APIs de reunião
Esta seção descreve os requisitos de pagamento para as APIs de transcrição e gravação da reunião do Teams. Essas APIs não dão suporte aos modelos de pagamento A e modelo B e podem ser usadas por qualquer aplicativo, independentemente do caso de uso.
Essas APIs dão suporte a um modo de avaliação que os aplicativos podem usar sem configurar a cobrança do Azure. A tabela a seguir resume o comportamento do modo de avaliação.
Configuração de cobrança do Azure | Resultado |
---|---|
Não configurado | A capacidade do modo de avaliação está disponível para download. Além disso, a API falha com o código de 402 erro (Pagamento Obrigatório). |
Configurado | O conteúdo de reunião ilimitado está disponível para download e preço com base em por minuto de conteúdo, conforme descrito na tabela a seguir. Os limites de RPS de engenharia ainda se aplicam. |
A tabela a seguir lista os preços do uso de APIs de reunião do Teams, aplicáveis a pontos de extremidade beta e v1.0.
APIs | Capacidade propagada | Preço para uso | Observações |
---|---|---|---|
APIs de gravação de reunião do Teams: | Nenhum | $0,003 por minuto | A duração é arredondada até o minuto mais próximo. |
APIs de transcrição da reunião do Teams: | Nenhum | $0,0022 por minuto | A duração é arredondada até o minuto mais próximo. |
Pagamento e cobrança
Se seus aplicativos estiverem ou usarem qualquer uma das APIs mencionadas ou a notificação de alteraçãoresources
, você deverá seguir as etapas descritas em Habilitar APIs e serviços do Microsoft 365 medidos para configurar uma assinatura ativa do Azure para fins de cobrança.
A organização dona do registro do aplicativo é responsável pelo pagamento. A assinatura do Azure também deve estar ativa no mesmo locatário. Para aplicativos multilocatários, a organização que registrou o aplicativo pode ser diferente da organização que executa o aplicativo.
Erros relacionados ao pagamento
Se o licenciamento incorreto for detectado, a chamada de API falhará e os dados não serão retornados.
Especificamente, para a maioria das APIs, a tentativa de obter mensagens para um usuário não habilitado resultará em um 402
código de erro.
Para notificações de alteração, as mensagens enviadas por usuários não habilitados não gerarão uma notificação de alteração.
As chamadas de API e as notificações de alteração usadas no modo de avaliação acima da cota de avaliação falharão.
Código de erro | Cenário | Mensagem de erro de exemplo |
---|---|---|
402 (Pagamento Obrigatório) | Faltando uma assinatura de cobrança ativa do 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 (Pagamento Obrigatório) | Passando model=A sem uma licença do Microsoft E5 ou sem DLP habilitado |
...needs a valid license to access this API... , ...tenant needs a valid license to access this API... |
402 (Pagamento Obrigatório) | Chamando a API de Patch passando model=B |
...query parameter 'model' does not support value 'B' for this API. Use billing model 'A'... |
402 (Pagamento Obrigatório) | Evaluation mode capacidade excedida |
...evaluation capacity for the month has exceeded. To continue beyond the evalution limits complete billing onboarding... |
Observação
Uma chamada de API bem-sucedida não significa que o licenciamento necessário esteja em vigor. Da mesma forma, o sucesso da API no modelo de avaliação não garante que a chamada esteja dentro da capacidade semeada.
Exibir os custos cobrados para as APIs do Microsoft Teams medidos
Esta seção descreve como monitorar os custos cobrados para as APIs do Microsoft Teams medidos.
Um proprietário de assinatura ou qualquer pessoa com permissões apropriadas do RBAC (Roles Based Controle de Acesso) pode usar a Análise de Custos para acompanhar o consumo de API medido da seguinte maneira:
- Entre no portal do Azure em https://portal.azure.com.
- Vá para Análise de Custo de Gerenciamento de Custos + Gerenciamento > de Custos de Cobrança>.
- Para o filtro próximo à parte superior, selecione Nome do serviço: Microsoft Graph Services.
- Para o menu suspenso Grupo por à direita, selecione Medidor.
Essa exibição oferece uma maneira conveniente de observar o consumo de API por dia durante um período de tempo.
Você também pode usar os gráficos de pizza próximos à parte inferior para detalhar ainda mais os custos de análise, usando os filtros De recurso e medidor .
Para obter mais informações sobre o gerenciamento de custos, consulte Gerenciamento de Custos + Documentação de cobrança.
Monitorar o número de mensagens cobradas para as APIs do Teams limitadas
Esta seção descreve como monitorar o número de mensagens cobradas para as APIs do Teams limitadas. Ao contrário da análise de custos, isso permite que você analise o uso de mensagens dentro da capacidade semeada, não apenas aquelas acima da capacidade semeada para cobrança, se aplicável aos modelos de licenciamento selecionados.
Um proprietário de assinatura ou qualquer pessoa com permissões DE RBAC (Funções Baseadas em Controle de Acesso) pode configurar um relatório, no formato CSV, com os detalhes de cobrança de toda a assinatura. Você pode exportar o relatório periodicamente (diariamente, semanalmente, mensalmente). Para obter detalhes, confira Tutorial: criar e gerenciar dados exportados.
Estimar o número de mensagens em seu Teams
Esta seção descreve como pesquisar o número de mensagens no locatário do Teams. Isso pode ajudar você a estimar o custo para usar as APIs medidas. Se uma mensagem for recuperada por meio de APIs limitadas várias vezes, ela será cobrada várias vezes. Tenha isso em mente quando você estimar o custo com base no número de mensagens em seu locatário do Teams. Por exemplo, se você ligou getAllMessages
(sem filtros) ontem e, em seguida, chamá-lo novamente (sem filtros) hoje, todas as mensagens de antes de hoje serão cobradas duas vezes. Por esse motivo, ao usar APIs limitadas, recomendamos que você use filtros (por exemplo, $top=10
, , $filter=lastModifiedDateTime gt 2019-03-17T07:13:28.000z
) ou altere notificações para evitar recuperar a mesma mensagem várias vezes.
Você também pode chamar a API getTeamsUserActivityUserDetail ou usar o Centro de Administração do Microsoft Teams da seguinte maneira:
Nota: Você deve ser um administrador global, um leitor global ou um administrador de serviço do Teams para exibir o relatório no Centro de Administração do Microsoft Teams. Para obter detalhes, confira Usar funções de administrador do Teams para gerenciar o Teams.
- No painel esquerdo, escolha Análise & relatórios>Relatórios de uso.
- Na guia Exibir relatórios , em Relatório, escolha Atividade de usuário do Teams.
- Em Intervalo de datas, selecione um intervalo.
- Escolha Executar relatório.
Perguntas frequentes
Cenário | Detalhes |
---|---|
Por que o número de mensagens cobradas foi maior do que o número de mensagens no meu Teams? | Se o aplicativo estiver recuperando a mesma mensagem várias vezes, ele será cobrado várias vezes. Uma maneira de evitar isso é usar notificações de alteração em vez de exportar APIs. Se você precisar usar APIs de exportação, use filtros (por exemplo, $filter=lastModifiedDateTime , ). $filter=from |
A cobrança realmente começou em 5 de julho? | Sim, estamos integrando parceiros em fases. Para acesso contínuo, siga as instruções sobre Habilitar APIs e serviços do Microsoft 365 medidos para configurar uma assinatura ativa do Azure para fins de cobrança. |
O que devo esperar depois de configurar uma assinatura do Azure? | A cobrança é efetiva imediatamente. Você pode monitorar os custos conforme descrito na seção Exibir os custos cobrados para as APIs do Microsoft Teams medidos acima. |
Preciso fornecer uma assinatura do Azure se meu aplicativo não estiver chamando APIs limitadas? | Recomendamos que você forneça uma assinatura do Azure porque a maioria dos cenários usa APIs limitadas. |
O que acontecerá se nenhuma assinatura do Azure for fornecida? | * Nenhum erro relacionado ao pagamento ocorrerá se o aplicativo não estiver chamando APIs limitadas. * Se nenhum parâmetro de modelo for passado, o evaluation model valor será usado por padrão. * Se chamar uma API limitada passando model=A , forneça uma licença qualificada Microsoft 365 E5 e uma assinatura do Azure. * Se passar model=B ao chamar APIs limitadas, forneça uma assinatura ativa do Azure. |
Como fazer criar uma assinatura do Azure? | A assinatura do Azure deve estar disponível no mesmo locatário em que o aplicativo está registrado. Clientes com contratos MCA ou EA podem obter uma assinatura de sua conta existente. Também é possível criar uma assinatura PAYG usando uma cartão de crédito ou pagar por marcar ou transferência bancária. Para obter detalhes, confira Habilitar APIs e serviços do Microsoft 365 medidos e gerenciamento de custos e cobrança. |
Quem é responsável pelo pagamento no caso de aplicativos multilocatários? | A organização que possui o registro do aplicativo. |
É possível diferenciar a cobrança do aplicativo de locatário multilocatário ou único? | Sim, essas informações devem ser fornecidas como parte dos detalhes de cobrança do Azure. |
Há uma cobrança quando nenhuma mensagem é retornada usando qualquer modelo? | Para desencorajar a votação frequente, as solicitações de API que retornam uma lista vazia de mensagens serão cobradas em uma mensagem. No caso de evaluation model , a chamada conta para as 500 mensagens por mês por aplicativo permitidas. |
Onde posso monitorar o custo e a cobrança? | Um proprietário de assinatura ou qualquer pessoa com RBAC apropriado (funções baseadas em Controle de Acesso) pode usar a ferramenta análise de custos do Azure para controlar o consumo por dia ou filtrar por medidor, nome do serviço, ID de recurso entre outros parâmetros. Para obter mais detalhes, confira Exibir os custos cobrados para as APIs do Microsoft Teams limitadas acima. |
Há um desconto de volume? | As taxas fixas se aplicam. |
Essas APIs estão registradas no programa MACC (Compromisso de Consumo) do Microsoft Azure? | Não no momento. |
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de