{"id":3422,"date":"2019-09-13T11:46:10","date_gmt":"2019-09-13T18:46:10","guid":{"rendered":"https:\/\/developer.microsoft.com\/en-us\/office\/blogs\/?p=3422"},"modified":"2019-09-13T11:46:10","modified_gmt":"2019-09-13T18:46:10","slug":"breaking-changes-calls-and-online-meetings-api-updates-in-microsoft-graph-beta-2","status":"publish","type":"post","link":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/breaking-changes-calls-and-online-meetings-api-updates-in-microsoft-graph-beta-2\/","title":{"rendered":"Breaking changes: Calls and online meetings API updates in Microsoft Graph beta"},"content":{"rendered":"

We\u2019re announcing several changes to the calls and online meetings APIs in Microsoft Graph beta, including a few breaking changes. Changes might affect existing applications that use the\u00a0\/beta<\/code>\u00a0calls and online meetings APIs. We expect the breaking changes to be fully deployed by the middle of September 2019.<\/p>\n

API updates: adding \/communications support for calls and online meetings<\/h2>\n

We were supporting \/app\/calls & \/app\/onlinemeetings<\/code> in beta. To make the API naming more clear and specific, we are going to add new APIs: \/communications\/calls<\/code> & \/communications\/onlinemeetings<\/code>. The previous APIs, \/app\/calls<\/code> and \/app\/onlinemeetings<\/code> are still supported in beta for backward compatibility.<\/p>\n

 <\/p>\n

API updates: adding \/user\/onlinemeetings<\/h2>\n

We currently support creating online meetings with app token only. Now, we will support creating online meetings with both user token and app token.<\/p>\n

Changes to entity types<\/h2>\n

We’re removing two unused properties from the commsOperation<\/strong> entity type: createdDateTime<\/strong> and lastActionDateTime<\/strong>.<\/p>\n

We’re adding a new property isBroadcast<\/strong> to the onlineMeeting<\/strong> entity type, and removing the meetingType<\/strong> property.<\/p>\n\n\n\n\n\n
Property<\/th>\nType<\/th>\nDescription<\/th>\n<\/tr>\n<\/thead>\n
isBroadcast<\/code><\/td>\nBoolean<\/code><\/td>\nIs the meeting a broadcast meeting or not.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

This propertmeetingType is an enum we used to support. Because there are only two types of meetings – broadcast and non-broadcast – you can use the isBroadcast<\/strong> flag instead of meetingType<\/strong>.<\/p>\n

Changes to complex type<\/h2>\n

The resource<\/strong> property of the commsNotification<\/strong> complex type will be renamed to resourceUrl<\/strong>.<\/p>\n

In order to support both the\u00a0\/app<\/code> and \/communications<\/code>paths, we need to return two resource paths, one with \/app<\/code> and one with \/communications<\/code>. In the future, when our APIs are in the Microsoft Graph v1.0 endpoint, we will support only \/communications<\/code>. At the moment, the path for the\u00a0resource<\/strong> property will be \/app<\/code>, and the path for the new\u00a0resourceUrl<\/strong>\u00a0property will be \/commmunications<\/code>.<\/p>\n

In the resultInfo complex type, we’re renaming subCode<\/strong> to subcode<\/strong>, and changing the code<\/strong> and subcode<\/strong>\u00a0properties from type string to type int.\n<\/code><\/p>\n

Changes to enums<\/h2>\n

We’re adding a new value sameEnterpriseAndFederated<\/code>to the accessLevel<\/strong> enum type.<\/p>\n

\n
\n
<EnumTypeName=\"accessLevel\">\n\u00a0 <MemberName=\"everyone\"Value=\"0\"\/>\n\u00a0 <MemberName=\"invited\"Value=\"1\"\/>\n\u00a0 <MemberName=\"locked\"Value=\"2\"\/>\n\u00a0 <MemberName=\"sameEnterprise\"Value=\"3\"\/>\n\u00a0 <MemberName=\"sameEnterpriseAndFederated\"Value=\"4\"\/>\n<\/EnumType>\n<\/pre>\n<\/div>\n<\/div>\n
We updated the routingPolicy<\/strong> enum type. For backward compatibility, we need to keep `preferSfb` with Value=4. preferSfb<\/code> is not in the beta, but is in the SDK.<\/p>\n
New routingPolicy values<\/h4>\n
\n
\n
\n
<EnumTypeName=\"routingPolicy\">\n\u00a0 <MemberName=\"none\"Value=\"0\"\/>\n\u00a0 <MemberName=\"noMissedCall\"Value=\"1\"\/>\n\u00a0 <MemberName=\"disableForwardingExceptPhone\"Value=\"2\"\/>\n\u00a0 <MemberName=\"disableForwarding\"Value=\"3\"\/>\n\u00a0 <MemberName=\"preferSkypeForBusiness\"Value=\"5\"\/>\n\u00a0 <MemberName=\"unknownFutureValue\"Value=\"6\"\/>\n<\/EnumType>\n<\/pre>\n<\/div>\n<\/div>\n<\/div>\n","protected":false},"excerpt":{"rendered":"
We\u2019re announcing several changes to the calls and online meetings APIs in Microsoft Graph beta, including a few breaking changes.<\/p>\n","protected":false},"author":69077,"featured_media":25159,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"footnotes":""},"categories":[3],"tags":[],"class_list":["post-3422","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-microsoft-graph"],"acf":[],"blog_post_summary":"
We\u2019re announcing several changes to the calls and online meetings APIs in Microsoft Graph beta, including a few breaking changes.<\/p>\n","_links":{"self":[{"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/posts\/3422","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\/69077"}],"replies":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/comments?post=3422"}],"version-history":[{"count":0,"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/posts\/3422\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/media\/25159"}],"wp:attachment":[{"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/media?parent=3422"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/categories?post=3422"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/tags?post=3422"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}