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 limitados no Microsoft Graph, consulte Visão geral de APIs e serviços limitados no Microsoft Graph.

Algumas APIs oferecem 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 as notificações resourcesde alteração que atualmente dão suporte a modelos de pagamento.

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 é restrita a aplicativos 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 serã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 APIs a seguir dão suporte ao model=A parâmetro.

Licenças necessárias para model=A

O usuário precisa de uma licença que ofereça suporte ao plano de serviço Microsoft Communications DLP, 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 estejam 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. O Office 365 E5, por exemplo, tem um link de avaliação gratuita no botão Comprar.

Você pode se qualificar para um por meio do Programa de Desenvolvedor do Microsoft 365; para obter detalhes, consulte as Perguntas frequentes. Como alternativa, você pode se inscrever para uma avaliação gratuita de 1 mês ou adquirir um plano do Microsoft 365.

Requisitos do model=B

model=B é restrita 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.

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 e por mês. A cota é redefinida no início de cada mês e qualquer valor não utilizado não é transferido para o próximo mês.

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 propagada para todos os usuários no locatário é comparada com o uso do aplicativo no locatário. A capacidade semeada é por aplicativo por locatário — um aplicativo não fica sem capacidade semeada se outro aplicativo acabar. A capacidade semeada é redefinida no início de cada mês civil, e qualquer quantidade não utilizada não é transferida para o mês seguinte.

A capacidade semeada não é aplicável para APIs de reunião do Teams. Para obter detalhes, consulte Requisitos de pagamento para APIs de reunião.

Requisitos de pagamento para atender às APIs

Esta seção descreve os requisitos de pagamento para APIs de transcrição e gravação de reunião do Teams. Essas APIs não dão suporte aos modelos de pagamento modelo 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.

A tabela a seguir lista os preços para usar as APIs de reunião do Teams, aplicáveis aos pontos de extremidade beta e v1.0.

Requisitos de licença para equipes que atendem às APIs de insights de IA

Esta seção descreve os requisitos de licença para o Teams que atendem às APIs de insights de IA. Para acessar o ponto de extremidade beta, os usuários devem ter uma licença do Microsoft 365 Copilot. Modelos de pagamento ou modo de avaliação não são aplicáveis a essas APIs; Eles podem ser usados por qualquer aplicativo para usuários que possuem a licença necessária.

Pagamento e cobrança

Se seus aplicativos estiverem usando qualquer uma das APIs mencionadas ou notificaçãoresources de alteração, você deverá seguir as etapas descritas em Habilitar APIs e serviços limitados do Microsoft 365 para configurar uma assinatura ativa do Azure para fins de cobrança.

A organização proprietária do registro do aplicativo é responsável pelo pagamento. A assinatura do Azure também deve estar ativa no mesmo locatário. Para aplicativos multilocatário, a organização que registrou o aplicativo pode ser diferente da organização que executa o aplicativo.

Erros relacionados ao pagamento

Se for detectado licenciamento incorreto, a chamada à API falhará e os dados não serão retornados. Especificamente, para a maioria das APIs, a tentativa de GET mensagens para um usuário não licenciado resulta em um código de 402 erro. Para notificações de alteração, as mensagens enviadas por usuários não licenciados não geram uma notificação de alteração. As chamadas à API e as notificações de alteração usadas no modo de avaliação que excedem a cota de avaliação falham.

Exibir os custos cobrados pelas APIs limitadas do Microsoft Teams

Esta seção descreve como monitorar os custos cobrados pelas APIs do Microsoft Teams limitadas.

Um proprietário de assinatura ou qualquer pessoa com permissões apropriadas de RBAC (Controle de Controle de Acesso Baseado em Funções) pode usar a Análise de Custo para acompanhar o consumo limitado de API, da seguinte maneira:

1. Entre no portal do Azure em https://portal.azure.com.
2. Acesse Gerenciamento de custos + Gerenciamento de > custos de faturamento > Análise de custos.
3. Para o filtro próximo à parte superior, selecione Nome do serviço: Serviços do Microsoft Graph.
4. Para o menu suspenso Agrupar por próximo à 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 Recursos e Medidor .

Para obter mais informações sobre o gerenciamento de custos, consulte a documentação Gerenciamento de custos + Cobrança.

Monitorar o número de mensagens cobradas pelas APIs do Teams limitadas

Esta seção descreve como monitorar o número de mensagens cobradas pelas APIs do Teams limitadas. Ao contrário da análise de custo, você pode analisar o uso de mensagens dentro da capacidade propagada, não apenas aquelas acima da capacidade propagada para cobrança, se aplicável aos modelos de licenciamento selecionados.

Um proprietário de assinatura ou qualquer pessoa com permissões necessárias de RBAC (Controle de Controle de Acesso Baseado em Funções) 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, consulte Tutorial: Criar e gerenciar dados exportados.

Estime o número de mensagens em suas equipes

Esta seção descreve como pesquisar o número de mensagens no locatário do Teams. Ele pode ajudá-lo a estimar o custo do uso das APIs limitadas. Se uma mensagem for recuperada várias vezes por meio de APIs limitadas, ela será cobrada várias vezes. Lembre-se disso ao estimar o custo com base no número de mensagens no locatário do Teams. Por exemplo, se você ligou getAllMessages (sem filtros) ontem e depois liga novamente (sem filtros) hoje, todas as mensagens anteriores a 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 as 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:

Observação: Você deve ser um Leitor Global ou administrador de serviços do Teams para exibir o relatório no Centro de Administração do Microsoft Teams. Para obter detalhes, consulte Usar funções de administrador do Teams para gerenciar o Teams.

1. No painel esquerdo, escolha Analytics & relatórios>relatórios de uso.
2. Na guia Exibir relatórios , em Relatório, escolha Atividade do usuário do Teams.
3. Em Intervalo de datas, selecione um intervalo.
4. Escolha Executar relatório.

Perguntas frequentes