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.

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=B está restringido a aplicações que não executam uma função de segurança ou conformidade. Não há requisitos de licenciamento para model=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.

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 .

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.

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 .

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.

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.

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.

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.

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.

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:

1. Entre no portal do Azure em https://portal.azure.com.
2. Aceda a Cost Management + Análise de Custos de Faturação > do Cost Management>.
3. Para o filtro junto à parte superior, selecione Nome do serviço: Serviços do Microsoft Graph.
4. 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.

1. No painel esquerdo, selecione Análise & relatórios Relatórios> deutilização.
2. No separador Ver relatórios , em Relatório, selecione Atividade do utilizador do Teams.
3. Em Intervalo de datas, selecione um intervalo.
4. Selecione Executar relatório.

Perguntas frequentes