次の方法で共有

Microsoft Teams API の支払いモデルとライセンス要件

  • [アーティクル]

この記事では、Microsoft Graph のMicrosoft Teams API の支払いモデルとライセンス要件について説明します。 Microsoft Graph の従量制課金 API とサービスの概要については、「Microsoft Graph の 従量制課金 API とサービスの概要」を参照してください。

一部の API には、 model クエリ パラメーターを使用してライセンスと支払いモデルを選択するオプションが用意されています。他の API では、1 つのモデルのみがサポートされているか、ライセンスと支払いモデルがサポートされていません。

次の表に、現在支払いモデルをサポートしている API と 変更通知resources を示します。

API または 変更通知resources 支払いモデル
変更通知resources:
  • /chats/getAllMessges
  • /teams/getAllMessages
  • /chats/getAllMembers
  • /teams/getAllMembers
 A、B
変更通知resources:
  • /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
 B
エクスポート API: A、B
PATCH API: policyViolation プロパティを更新する場合: A
Teams 会議 API: モデル パラメーターなし

注:

課金目的でアプリケーションのアクティブな Azure サブスクリプションを設定するには、「 従量制課金された Microsoft 365 API とサービスを有効にする」を参照してください。 詳細については、「 支払いと請求の更新プログラム」を参照してください。

支払いモデル

次の支払いモデルを使用できます。

注:

変更通知のサブスクライブされたリソースの支払いモデルを追加または変更するには、新しい支払いモデルを使用して新しい変更通知サブスクリプションを作成する必要があります。既存の変更通知の更新は機能しません。

model=A の要件

model=A は、セキュリティ機能またはコンプライアンス機能を実行するアプリケーションに制限されます。 詳細については、Microsoft Azure Services の製品規約 のセキュリティ/コンプライアンス アプリケーション セクションの API 支払条件を参照してください。

次の API は、 model=A パラメーターをサポートしています。

API または 変更通知resources ライセンスが必要なユーザー シードされた容量 追加使用時の価格 メモ
変更通知resources:
  • /chats/getAllMessges
  • /teams/getAllMessages
 メッセージ送信者 (DLP が有効になっているサポートされているライセンス× 800 メッセージ)、アプリあたり 1 か月あたり メッセージあたり 0.00075 米国ドル シードされた容量は conversationMember 変更通知と共有されます
変更通知resources:
  • /chats/getAllMembers
  • /teams/getAllMembers
 テナント内のすべてのユーザー (DLP が有効になっているサポートされているライセンス× 800 件の通知) をアプリごとに 1 か月あたり 通知ごとに 0.00075 米国ドル シードされた容量は chatMessage 変更通知と共有されます
API: 名前付きユーザー (DLP が有効になっているサポートされているライセンス× 1600 メッセージ) アプリあたり 1 か月あたり メッセージあたり 0.00075 米国ドル 名前付きユーザーは、GET 要求 URL で特定されるユーザーです。 空のリストを返す要求は、1 つのメッセージとして課金されます。 シードされた容量は、チャネル エクスポートと共有されます。
API: すべてのチーム メンバー (DLP が有効になっているサポートされているライセンス× 1600 メッセージ) アプリあたり 1 か月あたり メッセージあたり 0.00075 米国ドル 空のリストを返す要求は、1 つのメッセージとして課金されます。 シードされた容量は、チャット エクスポートと共有されます。
プロパティを更新する場合の API: メッセージ送信者 (DLP が有効になっているサポートされているライセンス× 800 メッセージ)、アプリあたり 1 か月あたり メッセージあたり 0.00075 米国ドル

model=A に必要なライセンス

ユーザーには、Microsoft Communications DLP サービス プランをサポートする ライセンス (サポートされているライセンスのいずれかなど) が必要です。 どのユーザーがライセンスを必要とするかは、API によって異なります。詳細は、「model=A要件」を参照してください。

ゲスト ユーザーはこれらのライセンス要件が免除されます。 同様に、テナント外から送信されるメッセージ (フェデレーション チャット) も対象外です。 消費税は引き続き適用されます。

ユーザーのライセンスが適切に付与されていることを確認するのは、(アプリ所有者ではなく) テナント所有者の責任です。 管理者は、Teams 管理センターの情報保護ライセンス レポートを使用して、サポートされているライセンスを持っていないユーザーを確認できます。

サポートされているライセンスの多くに無料試用版があります。 たとえば、Office 365 E5には、[購入] ボタンの下に [無料試用版] リンクがあります。

Microsoft 365 開発者プログラムを通じて対象となる場合があります。詳細については、FAQ を参照してください。 または、 1 か月間の無料試用版にサインアップするか、Microsoft 365 プランを購入することもできます。

注:

Microsoft Communications DLP サービス プラン は、ライセンスを取得する前に有効にする必要があります。 ライセンスは、Microsoft Entra 管理センターまたはMicrosoft 365 管理センターで管理できます。 Microsoft Graph Graph REST API と PowerShell SDK を使用して、グループ アカウントにライセンスを割り当てることもできます。

model=B の要件

model=B は、セキュリティまたはコンプライアンス機能を実行しないアプリケーションに制限されます。 詳細については、Microsoft Azure Services の製品規約の「セキュリティ/コンプライアンス アプリケーション セクションの API 支払条件」を参照してください。

次の API は、 model=B パラメーターをサポートしています。

API または 変更通知resources シードされた容量 使用価格 メモ
変更通知resources:
  • /chats/getAllMessages
  • /teams/getAllMessages
  • /users/{user-id}/chats/getAllMessages
  • /me/chats/getAllMessages
  • /appCatalogs/teamsApps/{app-id}/installedToChats/getAllMessages
 なし メッセージあたり 0.00075 米国ドル
変更通知resources:
  • /chats/getAllMembers
  • /teams/getAllMembers
  • /appCatalogs/teamsApps/{app-id}/installedToChats/getAllMembers
 なし 通知ごとに 0.00075 米国ドル
変更通知resources:
  • /appCatalogs/teamsApps/{app-id}/installedToChats
 なし メッセージあたり 0.00075 米国ドル
API: なし メッセージあたり 0.00075 米国ドル 空のリストを返す要求は、1 つのメッセージとして課金されます。
API: なし メッセージあたり 0.00075 米国ドル 空のリストを返す要求は、1 つのメッセージとして課金されます。

評価モード (既定) の要件

次の API では、評価モードがサポートされています。 評価クォータは、アプリごと、テナントごと、1 か月ごとに適用されます。 クォータは各カレンダー月の初めにリセットされ、未使用の金額は翌月に引き継がれられません。

API または 変更通知resources 評価クォータ 追加使用時の価格 メモ
変更通知resources:
  • /chats/getAllMessges
  • /teams/getAllMessages
  • /users/{user-id}/chats/getAllMessages
  • /me/chats/getAllMessages
  • /appCatalogs/teamsApps/{app-id}/installedToChats/getAllMessages
 アプリごとにテナントあたり 1 か月あたり 500 メッセージ 該当なし
変更通知resources:
  • /chats/getAllMembers
  • /teams/getAllMembers
  • /appCatalogs/teamsApps/{app-id}/installedToChats/getAllMembers
 アプリごとにテナントあたり 1 か月あたり 500 メッセージ 該当なし
変更通知resources:
  • /appCatalogs/teamsApps/{app-id}/installedToChats
 アプリごとに 1 か月あたり 500 メッセージ 該当なし
API: アプリごとにテナントあたり 1 か月あたり 500 メッセージ 該当なし 空のリストを返す要求は、1 つのメッセージとして課金されます。
API: アプリごとにテナントあたり 1 か月あたり 500 メッセージ 該当なし 空のリストを返す要求は、1 つのメッセージとして課金されます。
プロパティを更新する場合の API: アプリごとにテナントあたり 1 か月あたり 500 メッセージ 該当なし
Teams 会議トランスクリプト API: アプリごとにテナントあたり 1 か月あたり 600 分 該当なし
Teams 会議記録 API: アプリごとにテナントあたり 1 か月あたり 600 分 該当なし

シードされた容量

シードされた容量とは、消費メーターに課金される前にアプリが使用できる容量のことです。 容量はテナント レベルでプールされます。テナント内のすべてのユーザーのシードされた容量は、テナント内のアプリの使用状況と比較されます。 シードされた容量は、テナントごとにアプリごとに行われます。別のアプリが使い果たされても、アプリはシードされた容量を使い果たしません。シード容量は各カレンダー月の初めにリセットされ、未使用の金額は翌月に引き継がれられません。

支払いモデル ユース ケース シードされた容量 ライセンスが必要 Azure サブスクリプションが必要
model=A セキュリティとコンプライアンス model=A要件を参照してください はい (Microsoft 365 E5対象ライセンス) はい
model=B バックアップと復元、移行、センチメント分析、分析と分析情報 なし いいえ はい

シードされた容量は、Teams 会議 API には適用されません。 詳細については、「 会議 API の支払い要件」を参照してください。

会議 API の支払い要件

このセクションでは、Teams 会議のトランスクリプトと記録 API の支払い要件について説明します。 これらの API は、モデル A とモデル B の支払いモデルをサポートしていないため、ユース ケースに関係なく、任意のアプリケーションで使用できます。

これらの API は、Azure 課金を構成せずにアプリで使用できる 評価モード をサポートしています。 次の表は、評価モードの動作をまとめたものです。

Azure 課金のセットアップ 結果
未構成 評価モード容量はダウンロード可能です。 それ以外の場合、API はエラー コード 402 (支払いが必要) で失敗します。
構成済み 次の表に示すように、無制限の会議コンテンツをダウンロードして、1 分あたりのコンテンツに基づいて価格を設定できます。 エンジニアリング RPS の制限は引き続き適用されます。

次の表は、ベータ版と v1.0 エンドポイントの両方に適用できる Teams 会議 API を使用するための価格を示しています。

API シードされた容量 使用価格 メモ
Teams 会議記録 API: なし 1 分あたり $0.003 期間は、最も近い分に切り捨てられます。
Teams 会議トランスクリプト API: なし $0.0022/分 期間は、最も近い分に切り捨てられます。

支払いと請求

アプリケーションが前述の API または変更通知のいずれかを使用している場合、または使用する場合はresources従量制課金された Microsoft 365 API とサービスを有効にして、課金目的でアクティブな Azure サブスクリプションを設定する方法に関するページで説明されている手順に従う必要があります。

アプリの登録を所有するorganizationは、支払いを担当します。 Azure サブスクリプションも同じテナントでアクティブにする必要があります。 マルチテナント アプリの場合、アプリを登録したorganizationは、アプリを実行するorganizationとは異なる場合があります。

正しくないライセンスが検出された場合、API 呼び出しは失敗し、データは返されません。 具体的には、ほとんどの API で、ライセンスのないユーザーのメッセージを取得しようとすると、 402 エラー コードが発生します。 変更通知の場合、ライセンスのないユーザーが送信したメッセージは変更通知を生成しません。 評価クォータを超える評価モードで使用される API 呼び出しと変更通知は失敗します。

エラー コード シナリオ サンプル エラー メッセージ
402 (支払いが必要) アクティブな 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 (支払いが必要) Microsoft E5 ライセンスなしで、または DLP が有効になっていない model=A を渡す ...needs a valid license to access this API..., ...tenant needs a valid license to access this API...
402 (支払いが必要) Patch API の渡しの呼び出し model=B ...query parameter 'model' does not support value 'B' for this API. Use billing model 'A'...
402 (支払いが必要) Evaluation mode 容量を超えました ...evaluation capacity for the month has exceeded. To continue beyond the evalution limits complete billing onboarding...

注:

API 呼び出しが成功しても、必要なライセンスが設定されているわけではありません。 同様に、評価モデルでの API の成功は、呼び出しがシードされた容量内にあることを保証するものではありません。

従量制課金Microsoft Teams API に対して課金されるコストを表示する

このセクションでは、従量制課金Microsoft Teams API に対して課金されるコストを監視する方法について説明します。

サブスクリプション所有者、または適切な RBAC (ロールベースのAccess Control) アクセス許可を持つすべてのユーザーは、Cost Analysis を使用して従量制課金 API の使用量を追跡できます。

  1. Azure ポータル (https://portal.azure.com) にサインインします。
  2. [Cost Management + Billing > Cost Management > Cost analysis] に移動します。
  3. 上部付近のフィルターで、[ サービス名: Microsoft Graph Services] を選択します。
  4. 右側近くの [ グループ化 ] ドロップダウン メニューで、[ 測定] を選択します。

このビューでは、一定期間にわたって 1 日あたりの API の消費量を観察するための便利な方法が提供されます。

また、下部付近の円グラフを使用して、[ リソース ] フィルターと [ 測定] フィルターを使用して、分析のコストをさらに詳しく分析することもできます。

Azure portalの [コスト管理と課金] ページのスクリーンショット

コスト管理の詳細については、 コスト管理と課金に関するドキュメントを参照してください。

従量制課金された Teams API に対して課金されるメッセージの数を監視する

このセクションでは、従量制課金の Teams API に対して課金されるメッセージの数を監視する方法について説明します。 コスト分析とは異なり、これにより、選択したライセンス モデルに該当する場合、課金対象のシード容量を超えるメッセージだけでなく、シードされた容量内のメッセージの使用状況を分析できます。

サブスクリプション所有者、または必要な RBAC (ロールベースのAccess Control) アクセス許可を持つすべてのユーザーは、サブスクリプション全体の課金の詳細を含むレポートを CSV 形式で設定できます。 レポートは定期的 (毎日、毎週、毎月) エクスポートできます。 詳細については、「 チュートリアル: エクスポートされたデータを作成および管理する」を参照してください。

エクスポートされた CSV ファイルのスクリーンショット

Teams 内のメッセージの数を見積もる

このセクションでは、Teams テナント内のメッセージの数を検索する方法について説明します。 これは、従量制課金 API を使用するためのコストを見積もるのに役立ちます。 従量制課金 API を介してメッセージが複数回取得された場合、そのメッセージは複数回課金されます。 Teams テナント内のメッセージ数に基づいてコストを見積もる場合は、この点に注意してください。 たとえば、昨日 getAllMessages (フィルターなし) を呼び出し、今日は (フィルターなしで) 再度呼び出した場合、今日より前のメッセージはすべて 2 回課金されます。 このため、従量制課金 API を使用する場合は、フィルター ( $top=10、 $filter=lastModifiedDateTime gt 2019-03-17T07:13:28.000zなど) を使用するか、 通知を変更 して同じメッセージを複数回取得しないようにすることをお勧めします。

getTeamsUserActivityUserDetail API を呼び出すこともできます。また、次のようにMicrosoft Teams 管理 センターを使用することもできます。

手記：Microsoft Teams 管理 センターでレポートを表示するには、グローバル リーダーまたは Teams サービス管理者である必要があります。 詳細については、「 Teams 管理者ロールを使用して Teams を管理する」を参照してください。

  1. 左側のウィンドウで、[Analytics & レポート>Usage reports] を選択します。
  2. [ レポートの表示 ] タブの [ レポート] で、[ Teams ユーザー アクティビティ] を選択します。
  3. [ 日付範囲] で、範囲を選択します。
  4. [ レポートの実行] を選択します。

Teams ユーザー アクティビティ レポートのスクリーンショット

よく寄せられる質問

シナリオ 詳細
請求されるメッセージの数が Teams のメッセージ数よりも多かったのはなぜですか? アプリが同じメッセージを複数回取得している場合は、複数回課金されます。 これを回避する 1 つの方法は、エクスポート API の代わりに変更通知を使用することです。 エクスポート API を使用する必要がある場合は、フィルター ( $filter=lastModifiedDateTime、 $filter=fromなど) を必ず使用してください。
課金は実際に 7 月 5 日に開始されましたか? はい。パートナーを段階的にオンボードしています。 引き続きアクセスするには、「 従量制課金された Microsoft 365 API とサービスを有効にする」の 手順に従って、課金目的でアクティブな Azure サブスクリプションを設定します。
Azure サブスクリプションを設定した後に何を期待すればよいですか? 課金はすぐに有効になります。 上記の「 従量制課金Microsoft Teams API に対して課金されるコストを表示する 」セクションで説明されているように、コストを監視できます。
アプリケーションが従量制課金 API を呼び出していない場合は、Azure サブスクリプションを提供する必要がありますか? ほとんどのシナリオでは従量制課金 API が使用されるため、Azure サブスクリプションを提供することをお勧めします。
Azure サブスクリプションが提供されていない場合はどうなりますか? * アプリケーションが従量制課金 API を呼び出していない場合、支払いに関連するエラーは発生しません。
* モデル パラメーターが渡されない場合、 evaluation model 値は既定で使用されます。
* 従量制課金 API パッシング model=Aを呼び出す場合は、Microsoft 365 E5資格のあるライセンスと Azure サブスクリプションを指定します。
* 従量制課金 API を呼び出すときに model=B 渡す場合は、アクティブな Azure サブスクリプションを指定します。
Azure サブスクリプション操作方法作成しますか? Azure サブスクリプションは、アプリが登録されているのと同じテナントで使用できる必要があります。 MCA または EA 契約をお持ちのお客様は、既存のアカウントからサブスクリプションを取得できます。 クレジット カードを使用して PAYG サブスクリプションを作成したり、チェックまたは電信送金で支払ったりすることもできます。 詳細については、「従量制課金型 Microsoft 365 API とサービスの有効化」および「コスト管理と課金」を参照してください。
マルチテナント アプリの場合の支払いを担当するのはだれですか? アプリの登録を所有するorganization。
マルチテナント アプリまたはシングル テナント アプリと課金を区別できますか? はい。この情報は、Azure 課金の詳細の一部として提供する必要があります。
どのモデルを使用してもメッセージが返されない場合、料金は発生しますか? 頻繁な ポーリングを避けるために、メッセージの空のリストを返す API 要求には、1 つのメッセージが課金されます。 evaluation modelの場合、呼び出しは許可されるアプリごとに 1 か月あたり 500 メッセージにカウントされます。
コストと課金はどこで監視できますか? サブスクリプション所有者、または適切な RBAC (ロールベースのAccess Control) を持つすべてのユーザーは、Azure Cost Analysis ツールを使用して 1 日あたりの使用量を追跡したり、測定、サービス名、リソース ID などのパラメーターでフィルター処理したりできます。 詳細については、上記 の従量制課金Microsoft Teams API に対して課金されるコストの表示に関するページを 参照してください。
ボリューム割引はありますか? 定額料金が適用されます。
これらの API は Microsoft Azure Consumption Commitment (MACC) プログラムに登録されていますか? 現時点ではできません。