{"id":13489,"date":"2023-04-12T14:58:25","date_gmt":"2023-04-12T21:58:25","guid":{"rendered":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/?p=13489"},"modified":"2023-04-12T14:58:25","modified_gmt":"2023-04-12T21:58:25","slug":"enabling-billing-for-microsoft-teams-apis-in-microsoft-graph","status":"publish","type":"post","link":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/enabling-billing-for-microsoft-teams-apis-in-microsoft-graph\/","title":{"rendered":"Enabling billing for Microsoft Teams APIs in Microsoft Graph\u00a0"},"content":{"rendered":"<p>We appreciate hearing valuable feedback from our customers and the developer community using metered APIs and services in Microsoft Graph. We use this feedback to continue improving the billing experience. In <a href=\"https:\/\/devblogs.microsoft.com\/microsoft365dev\/announcing-general-availability-of-microsoft-graph-export-api-for-microsoft-teams-messages\/\">October 2021<\/a> and <a href=\"https:\/\/devblogs.microsoft.com\/microsoft365dev\/upcoming-billing-changes-for-microsoft-graph-apis-for-teams-messages\/\">June 2022<\/a>, we announced specific requirements for the following Microsoft Teams APIs in Microsoft Graph:<\/p>\n<ul>\n<li><u><a href=\"https:\/\/docs.microsoft.com\/graph\/api\/subscription-post-subscriptions#chatmessage\">Microsoft Graph Change Notifications API for Teams notifications\u00a0<\/a><\/u><\/li>\n<li><a href=\"https:\/\/docs.microsoft.com\/graph\/api\/chats-getallmessages\">Microsoft Graph Export APIs for Teams chat messages<\/a><\/li>\n<li><u><a href=\"https:\/\/docs.microsoft.com\/graph\/api\/channel-getallmessages\">Microsoft Graph Export APIs for Teams channel messages\u00a0<\/a><\/u><\/li>\n<li><u><a href=\"https:\/\/docs.microsoft.com\/graph\/api\/chatmessage-update\">Microsoft Graph Patch API for Teams messages\u00a0<\/a><\/u><\/li>\n<\/ul>\n<p>For more information about seeded capacity and consumption fees, please review <a href=\"https:\/\/learn.microsoft.com\/graph\/teams-licenses\">licensing and payment requirements for Microsoft Graph Teams APIs<\/a><u>.<\/u><\/p>\n<h2>What\u2019s happening next?<\/h2>\n<p>We\u2019ve been working with an initial set of application owners who were testing these APIs. Now we\u2019re asking for all applications requiring more than the Evaluation Mode\u2019s seeded capacity to complete the setup process described below.<\/p>\n<p>Existing applications that used these metered APIs in February 2023 were given a grace period from these requirements but must now <strong>set up an active Azure billing subscription by June 30<\/strong><strong><sup>th<\/sup><\/strong><strong>, 2023 to avoid service disruptions<\/strong>. All other applications, including new applications since March 1<sup>st<\/sup>, 2023, are already subject to these requirements.\u00a0(GCC tenants are currently exempt from these requirements.)<\/p>\n<p>Applications without an active Azure subscription will get error \u201cHTTP 402 Payment required\u201d when trying to access the metered APIs using model=A or model=B.\u00a0 Applications using Evaluation Mode will also get Error \u201cHTTP 402 Payment required\u201d when the seeded capacity limit is exceeded.<\/p>\n<h2>What you need to do to prepare<\/h2>\n<p><strong>To avoid service disruptions to your application(s)<\/strong>, please take the following actions if you haven\u2019t done so yet:<\/p>\n<ol>\n<li><a href=\"https:\/\/learn.microsoft.com\/graph\/metered-api-setup\">Set up an<strong> Azure billing subscription<\/strong><\/a> for each application.<\/li>\n<li><a href=\"https:\/\/learn.microsoft.com\/graph\/teams-licenses\">Set up a<strong> payment model<\/strong><\/a> (model=A or model=B) for each API request of a metered API.<\/li>\n<li>If your app is using model=A, ensure that your users <a href=\"https:\/\/learn.microsoft.com\/graph\/teams-licenses#required-licenses-for-modela\">have the proper <strong>E5 licenses<\/strong> and that <strong>DLP<\/strong> is enabled<\/a>.<\/li>\n<\/ol>\n<p>Please note that even if you have previously provided a subscription ID in the Protected API form, in order for the subscription to be properly configured, you still need to follow the instructions above to finish the setup.<\/p>\n<h2>Estimate and monitor costs<\/h2>\n<p>For detailed information on seeded capacity and consumption fees, please review <a href=\"https:\/\/learn.microsoft.com\/graph\/teams-licenses\">licensing and payment requirements for Microsoft Graph Teams APIs<\/a><u>.<\/u> On this page, you\u2019ll also learn how to <a href=\"https:\/\/learn.microsoft.com\/en-us\/graph\/teams-licenses#view-the-costs-billed-for-the-metered-microsoft-teams-apis\">estimate and monitor the costs<\/a> for these metered APIs. Once your Azure subscription is properly configured, you should be able to see and monitor the costs using <strong>Cost Analysis <\/strong>within the Azure portal within about one week.<\/p>\n<p>&nbsp;<\/p>\n<p><a href=\"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-content\/uploads\/sites\/73\/2023\/04\/Graph-billing_image.png\"><img decoding=\"async\" class=\"aligncenter size-large wp-image-13574\" src=\"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-content\/uploads\/sites\/73\/2023\/04\/Graph-billing_image-1024x532.png\" alt=\"Example of cost management: testGraphBilling\" width=\"640\" height=\"333\" srcset=\"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-content\/uploads\/sites\/73\/2023\/04\/Graph-billing_image-1024x532.png 1024w, https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-content\/uploads\/sites\/73\/2023\/04\/Graph-billing_image-300x156.png 300w, https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-content\/uploads\/sites\/73\/2023\/04\/Graph-billing_image-768x399.png 768w, https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-content\/uploads\/sites\/73\/2023\/04\/Graph-billing_image.png 1381w\" sizes=\"(max-width: 640px) 100vw, 640px\" \/><\/a><\/p>\n<p>&nbsp;<\/p>\n<p>If you have questions, please reach out to <a href=\"https:\/\/developer.microsoft.com\/graph\/support\">https:\/\/developer.microsoft.com\/graph\/support<\/a>.<\/p>\n<p>Thank you for using Microsoft Teams! Visit us at our <a href=\"https:\/\/developer.microsoft.com\/en-us\/microsoft-teams\">Microsoft Teams Dev Center.<\/a> Follow us on <a href=\"https:\/\/twitter.com\/Microsoft365Dev\">Microsoft 365 Developer (@Microsoft365Dev) \/ Twitter<\/a> for the latest news.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>As previously communicated in October 2021 and June 2022, we have specific licensing and pricing requirements\u202ffor Microsoft Teams APIs in Microsoft Graph.<\/p>\n","protected":false},"author":116572,"featured_media":13494,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"footnotes":""},"categories":[3,128],"tags":[],"class_list":["post-13489","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-microsoft-graph","category-microsoft-teams"],"acf":[],"blog_post_summary":"<p>As previously communicated in October 2021 and June 2022, we have specific licensing and pricing requirements\u202ffor Microsoft Teams APIs in Microsoft Graph.<\/p>\n","_links":{"self":[{"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/posts\/13489","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/users\/116572"}],"replies":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/comments?post=13489"}],"version-history":[{"count":0,"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/posts\/13489\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/media\/13494"}],"wp:attachment":[{"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/media?parent=13489"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/categories?post=13489"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/tags?post=13489"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}