Modelos de pagamento e requisitos de licenciamento para APIs do Microsoft Teams
Este artigo descreve os modelos de pagamento e os requisitos de licenciamento das APIs do Microsoft Teams no Microsoft Graph. Para obter uma descrição de alto nível das APIs e serviços medidos no Microsoft Graph, veja Descrição geral das APIs e serviços com tráfego limitado no Microsoft Graph.
Algumas APIs fornecem a opção de escolher um modelo de licenciamento e pagamento através do model parâmetro de consulta; outras apenas suportam um modelo ou não suportam um modelo de licenciamento e pagamento.
A tabela seguinte lista as APIs e a notificação de alteraçãoresources que suportam atualmente 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: | Sem parâmetro de modelo |
Observação
Para configurar uma subscrição ativa do Azure para a sua aplicação para fins de faturação, veja Ativar apIs e serviços limitados do Microsoft 365. Para obter mais informações, consulte Atualizações de pagamento e faturação.
Modelos de pagamento
Estão disponíveis os seguintes modelos de pagamento:
model=Aé restrito a aplicativos que executam uma função de segurança ou conformidade e exige uma licença com suporte.model=Bestá restringido a aplicações 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 são enviadas se o limite for excedido.
Observação
Para adicionar ou alterar um modelo de pagamento para um recurso subscrito de uma notificação de alteração, tem de criar uma nova subscrição de notificação de alteração com o novo modelo de pagamento; atualizar 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 SEGUINTES APIs suportam o 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 suportadas com DLP ativado) por mês por aplicação | $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 suportadas com DLP ativado) por mês por aplicação | 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 suportadas com DLP ativado) por mês por aplicação | $0,00075 por mensagem | O usuário nomeado é o usuário identificado na URL de solicitação GET. Os pedidos que devolvem uma lista vazia são cobrados como uma mensagem. A capacidade de propagação é compartilhada com a exportação de canal. |
| APIs: | Qualquer membro da equipe | (1600 mensagens × licenças suportadas com DLP ativado) por mês por aplicação | $0,00075 por mensagem | Os pedidos que devolvem uma lista vazia são cobrados 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 suportadas com DLP ativado) por mês por aplicação | $0,00075 por mensagem |
Licenças necessárias para model=A
O utilizador precisa de uma licença que suporte o plano de serviço DLP da Microsoft Communications, como uma destas licenças suportadas.
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.
É da responsabilidade do proprietário do inquilino (e não do proprietário da aplicação) garantir que os utilizadores estão devidamente licenciados. Os administradores podem utilizar o relatório de licenças de Proteção de informações no centro de administração do Teams para ver que utilizadores não têm uma licença suportada.
Muitas licenças com suporte oferecem avaliação gratuita. Office 365 E5, por exemplo, tem uma ligação de Avaliação gratuita no botão Comprar.
Pode qualificar-se para um através do Programa para Programadores do Microsoft 365; para obter detalhes, veja as FAQ. Em alternativa, pode inscrever-se numa avaliação gratuita de um mês ou comprar um plano do Microsoft 365.
Observação
O plano de serviçoS DLP da Microsoft Communications tem de ser ativado antes de poder ser licenciado. Pode gerir licenças no centro de administração do Microsoft Entra ou no Centro de administração do Microsoft 365. Também pode atribuir licenças a uma conta de grupo com a API REST do Microsoft Graph Graph e o SDK do PowerShell.
Requisitos do model=B
model=B está restringido a aplicações 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 SEGUINTES APIs suportam o model=B parâmetro .
APIs ou notificação de alteraçãoresources |
Capacidade propagada | Preço para utilização | Notas |
|---|---|---|---|
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 | Os pedidos que devolvem uma lista vazia são cobrados como uma mensagem. |
| APIs: | Nenhum | $0,00075 por mensagem | Os pedidos que devolvem uma lista vazia são cobrados como uma mensagem. |
Requisitos do modo de avaliação (padrão)
As seguintes APIs suportam o modo de avaliação. A quota de avaliação é imposta por aplicação, por inquilino, por mês. A quota é reposta no início de cada mês de calendário e qualquer montante não utilizado não é transportado para o mês seguinte.
APIs ou notificação de alteraçãoresources |
Quota de avaliação | Preço para uso adicional | Notas |
|---|---|---|---|
Notificação de alteraçãoresources:
|
500 mensagens por mês por inquilino por aplicação | N/D | |
Notificação de alteraçãoresources:
|
500 mensagens por mês por inquilino por aplicação | N/D | |
Notificação de alteraçãoresources:
|
500 mensagens por mês por aplicativo | N/D | |
| APIs: | 500 mensagens por mês por inquilino por aplicação | N/D | Os pedidos que devolvem uma lista vazia são cobrados como uma mensagem. |
| APIs: | 500 mensagens por mês por inquilino por aplicação | N/D | Os pedidos que devolvem uma lista vazia são cobrados como uma mensagem. |
APIs, ao atualizar a policyViolation propriedade: |
500 mensagens por mês por inquilino por aplicação | N/D | |
| APIs de transcrição de reuniões do Teams: | 600 minutos por mês por inquilino por aplicação | N/D | |
| APIs de gravação de reuniões do Teams: | 600 minutos por mês por inquilino por aplicação | 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 ao nível do inquilino — a capacidade propagada para todos os utilizadores no inquilino é comparada com a utilização da aplicação no inquilino. A capacidade propagada é por aplicação por inquilino — uma aplicação não ficará sem capacidade propagada se outra aplicação se esgotar. A capacidade semeada é reposta no início de cada mês de calendário e qualquer quantidade não utilizada não é transferida para o mês seguinte.
| Modelo de pagamento | Casos de uso | Capacidade propagada | Licença necessária | Subscrição do Azure necessária |
|---|---|---|---|---|
model=A |
Segurança e Conformidade | Ver model=A requisitos |
Sim (Microsoft 365 E5 licença elegível) | Sim |
model=B |
Cópia de segurança e restauro, migração, análise de sentimentos, análise e informações | Nenhum | Não | Sim |
A capacidade propagada não é aplicável às APIs de reunião do Teams. Para obter detalhes, veja Requisitos de pagamento das APIs de Reunião.
Requisitos de pagamento para cumprir APIs
Esta secção descreve os requisitos de pagamento das APIs de gravação e transcrição de reuniões do Teams. Estas APIs não suportam o modelo A e modelo B de pagamento e podem ser utilizadas por qualquer aplicação, independentemente do caso de utilização.
Estas APIs suportam um modo de avaliação que as aplicações podem utilizar sem configurar a faturação do Azure. A tabela seguinte resume o comportamento do modo de avaliação.
| Configuração da faturação do Azure | Resultado |
|---|---|
| Não configurado | A capacidade do modo de avaliação está disponível para transferência. Além disso, a API falha com o código 402 de erro (Pagamento Obrigatório). |
| Configurado | O conteúdo ilimitado da reunião está disponível para transferência e preços com base em por minuto de conteúdo, conforme descrito na tabela seguinte. Os limites do RPS de engenharia ainda se aplicam. |
A tabela seguinte lista os preços da utilização de APIs de reunião do Teams, aplicáveis aos pontos finais beta e v1.0.
| APIs | Capacidade propagada | Preço para utilização | Notas |
|---|---|---|---|
| APIs de gravação de reuniões do Teams: | Nenhum | $0,003 por minuto | A duração é arredondada para o minuto mais próximo. |
| APIs de transcrição de reuniões do Teams: | Nenhum | $0,0022 por minuto | A duração é arredondada para o minuto mais próximo. |
Pagamento e faturação
Se as suas aplicações estiverem ou irão utilizar qualquer uma das APIs acima mencionadas ou a notificação de alteraçãoresources, tem de seguir os passos descritos em Ativar APIs e serviços do Microsoft 365 com tráfego limitado para configurar uma subscrição ativa do Azure para fins de faturação.
A organização proprietária do registo de aplicações é responsável pelo pagamento. A subscrição do Azure também deve estar ativa no mesmo inquilino. Para aplicações multi-inquilino, a organização que registou a aplicação pode ser diferente da organização que executa a aplicação.
Erros relacionados com pagamentos
Se for detetado um licenciamento incorreto, a chamada à API falha e os dados não serão devolvidos.
Especificamente, para a maioria das APIs, tentar obter mensagens para um utilizador não licenciado resultará num 402 código de erro.
Para notificações de alteração, as mensagens enviadas por utilizadores não licenciados não irão gerar uma notificação de alteração.
As chamadas à API e as notificações de alteração utilizadas no modo de avaliação que excedam a quota de avaliação falharão.
| Código de erro | Cenário | Mensagem de erro de exemplo |
|---|---|---|
| 402 (Pagamento Obrigatório) | Falta uma subscrição de faturação 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) | Passar model=A sem uma licença do Microsoft E5 ou sem DLP ativado |
...needs a valid license to access this API..., ...tenant needs a valid license to access this API... |
| 402 (Pagamento Obrigatório) | Chamar a API de Patch 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 à API bem-sucedida não significa que o licenciamento necessário esteja implementado. Da mesma forma, o êxito da API no modelo de avaliação não garante que a chamada esteja dentro da capacidade propagada.
Ver os custos faturados para as APIs do Microsoft Teams com tráfego limitado
Esta secção descreve como monitorizar os custos faturados pelas APIs do Microsoft Teams com tráfego limitado.
Um proprietário de subscrição, ou qualquer pessoa com permissões RBAC (Funções Baseadas em Funções Controle de Acesso) adequadas, pode utilizar a Análise de Custos para monitorizar o consumo limitado de API, da seguinte forma:
- Entre no portal do Azure em https://portal.azure.com.
- Aceda a Cost Management + Análise de Custos de Faturação > do Cost Management>.
- Para o filtro junto à parte superior, selecione Nome do serviço: Serviços do Microsoft Graph.
- Para o menu pendente Agrupar por junto à direita, selecione Medidor.
Esta vista oferece uma forma conveniente de observar o consumo de API por dia durante um período de tempo.
Também pode utilizar os gráficos circulares junto à parte inferior para discriminar ainda mais os custos de análise com os filtros Recurso e Medidor .
Para obter mais informações sobre a gestão de custos, veja a Documentação do Cost Management + Faturação.
Monitorizar o número de mensagens faturadas para as APIs do Teams com tráfego limitado
Esta secção descreve como monitorizar o número de mensagens faturadas para as APIs do Teams com tráfego limitado. Ao contrário da análise de custos, isto permite-lhe analisar a utilização de mensagens dentro da capacidade propagada e não apenas as que estão acima da capacidade de propagação para faturação, se aplicável aos modelos de licenciamento selecionados.
Um proprietário da subscrição, ou qualquer pessoa com permissões RBAC (Funções Baseadas em Funções Controle de Acesso), pode configurar um relatório, no formato CSV, com os detalhes de faturação de toda a subscrição. Pode exportar o relatório periodicamente (diariamente, semanalmente, mensalmente). Para obter detalhes, veja Tutorial: Criar e gerir dados exportados.
Estimar o número de mensagens no Teams
Esta secção descreve como procurar o número de mensagens no seu inquilino do Teams. Isto pode ajudá-lo a estimar o custo da utilização das APIs com tráfego limitado. Se uma mensagem for obtida através de APIs com tráfego limitado várias vezes, é faturada várias vezes. Tenha isto em mente quando estimar o custo com base no número de mensagens no seu inquilino do Teams. Por exemplo, se tiver chamado getAllMessages (sem filtros) ontem e, em seguida, voltar a chamá-lo (sem filtros) hoje, todas as mensagens anteriores ao dia de hoje serão faturadas duas vezes. Por este motivo, ao utilizar APIs com tráfego limitado, recomendamos que utilize filtros (por exemplo, $top=10, $filter=lastModifiedDateTime gt 2019-03-17T07:13:28.000z) ou altere notificações para evitar obter a mesma mensagem várias vezes.
Também pode chamar a API getTeamsUserActivityUserDetail ou pode utilizar o Centro de Administração do Microsoft Teams da seguinte forma:
Nota: Tem de ser um Leitor Global ou administrador de serviços do Teams para ver o relatório no Centro de Administração do Microsoft Teams. Para obter detalhes, consulte Utilizar funções de administrador do Teams para gerir o Teams.
- No painel esquerdo, selecione Análise & relatórios Relatórios> deutilização.
- No separador Ver relatórios , em Relatório, selecione Atividade do utilizador do Teams.
- Em Intervalo de datas, selecione um intervalo.
- Selecione Executar relatório.
Perguntas frequentes
| Cenário | Detalhes |
|---|---|
| Por que motivo o número de mensagens faturadas foi superior ao número de mensagens no meu Teams? | Se a sua aplicação estiver a obter a mesma mensagem várias vezes, esta é faturada várias vezes. Uma forma de evitar isto é utilizar notificações de alteração em vez de exportar APIs. Se tiver de utilizar APIs de exportação, certifique-se de que utiliza filtros (por exemplo, $filter=lastModifiedDateTime, $filter=from). |
| A faturação começou a 5 de Julho? | Sim, estamos a integrar parceiros por fases. Para obter acesso contínuo, siga as instruções em Ativar apIs e serviços limitados do Microsoft 365 para configurar uma subscrição ativa do Azure para fins de faturação. |
| O que devo esperar depois de configurar uma subscrição do Azure? | A faturação tem efeito imediato. Pode monitorizar os custos conforme descrito na secção Ver os custos faturados para as APIs do Microsoft Teams com tráfego limitado acima. |
| Preciso de fornecer uma subscrição do Azure se a minha aplicação não estiver a chamar APIs com tráfego limitado? | Recomendamos que forneça uma subscrição do Azure, uma vez que a maioria dos cenários utiliza APIs com tráfego limitado. |
| O que acontece se não for fornecida nenhuma subscrição do Azure? | * Não ocorrerão erros relacionados com o pagamento se a aplicação não estiver a chamar APIs com tráfego limitado. * Se não for transmitido nenhum parâmetro de modelo, o evaluation model valor é utilizado por predefinição. * Se chamar uma API com tráfego limitado, model=Aforneça uma licença Microsoft 365 E5 elegível e uma subscrição do Azure. * Se passar ao model=B chamar APIs com tráfego limitado, forneça uma subscrição ativa do Azure. |
| Como fazer criar uma subscrição do Azure? | A subscrição do Azure tem de estar disponível no mesmo inquilino onde a aplicação está registada. Os clientes com contratos MCA ou EA podem obter uma subscrição a partir da conta existente. Também é possível criar uma subscrição PAYG com um card de crédito ou pagar por marcar ou transferência bancária. Para obter detalhes, consulte Ativar apIs e serviços limitados do Microsoft 365,gestão de custos e faturação. |
| Quem é responsável pelo pagamento no caso de aplicações multi-inquilino? | A organização proprietária do registo de aplicações. |
| É possível diferenciar a faturação da aplicação multi-inquilino ou de inquilino único? | Sim, estas informações têm de ser fornecidas como parte dos detalhes de faturação do Azure. |
| Existe algum custo quando nenhuma mensagem é devolvida com qualquer modelo? | Para desencorajar consultas frequentes, os pedidos da API que devolvem uma lista vazia de mensagens serão cobrados uma mensagem. No caso do evaluation model, a chamada conta para as 500 mensagens por mês permitidas por aplicação. |
| Onde posso monitorizar o custo e a faturação? | Um proprietário de subscrição ou qualquer pessoa com o RBAC adequado (Roles Based Controle de Acesso) pode utilizar a ferramenta Azure Cost Analysis 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, consulte Ver os custos faturados pelas APIs do Microsoft Teams com tráfego limitado acima. |
| Existe um desconto de volume? | Aplicam-se taxas fixas. |
| Estas APIs estão inscritas no programa Azure Consumption Commitment (MACC) do Microsoft Azure? | Não no momento. |