Home

The Calls & Meetings API is now the Microsoft Graph Communications API, SDK package names updated

%3CLINGO-SUB%20id%3D%22lingo-sub-288189%22%20slang%3D%22en-US%22%3EThe%20Calls%20%26amp%3B%20Meetings%20API%20is%20now%20the%20Microsoft%20Graph%20Communications%20API%2C%20SDK%20package%20names%20updated%3C%2FLINGO-SUB%3E%3CLINGO-BODY%20id%3D%22lingo-body-288189%22%20slang%3D%22en-US%22%3E%3CP%3EAs%20the%20newest%20API%20and%20SDK%20pair%20for%20performing%20programmatic%26nbsp%3Bactions%20on%20Microsoft%20Teams%20calls%20makes%20its%20way%20from%20Public%20Preview%20to%20Generally%20Available%2C%20there%20are%20some%20changes%20happening%20to%20bring%20it%20more%20into%20line%20with%20the%20other%20Graph%20APIs.%3C%2FP%3E%0A%3CP%3E%26nbsp%3B%3C%2FP%3E%0A%3CP%3EFirstly%2C%20it%20has%20a%20new%20name.%20I%20much%20prefer%20this%20one%2C%20it%E2%80%99s%20more%20succinct%26nbsp%3Band%20abstract%2C%20and%20means%20that%20when%20new%20features%20are%20added%20that%20aren%E2%80%99t%20specific%20to%20calls%20or%20meetings%2C%20it%20won%E2%80%99t%20look%20strange.%3C%2FP%3E%0A%3CP%3E%26nbsp%3B%3C%2FP%3E%0A%3CP%3EThere%20are%20some%20other%20changes%20as%20well.%20These%20might%20well%20be%26nbsp%3B%3CSTRONG%3Ebreaking%20changes%3C%2FSTRONG%3E%3CSPAN%3E%26nbsp%3B%3C%2FSPAN%3Eto%20existing%20applications%2C%20or%20if%20they%20aren%E2%80%99t%2C%20there%20will%20still%20be%20things%20you%20should%20do.%3C%2FP%3E%0A%3CP%3E%26nbsp%3B%3C%2FP%3E%0A%3CH2%20id%3D%22toc-hId-1652208864%22%20id%3D%22toc-hId-1704790906%22%3ENuGet%20Package%20names%20have%20changed%3C%2FH2%3E%0A%3CP%3EThat%E2%80%99s%20right%20%E2%80%93%20the%20way%20you%20get%20the%20SDK%20has%20changed.%20These%20are%20the%20new%20package%20names%20you%20should%20use%3A%3C%2FP%3E%0A%3CTABLE%20cellpadding%3D%225%22%3E%0A%3CTHEAD%3E%0A%3CTR%3E%0A%3CTH%20align%3D%22left%22%3EOriginal%20NuGet%20package%3C%2FTH%3E%0A%3CTH%20align%3D%22left%22%3ENew%20NuGet%20package%3C%2FTH%3E%0A%3C%2FTR%3E%0A%3C%2FTHEAD%3E%0A%3CTBODY%3E%0A%3CTR%3E%0A%3CTD%20align%3D%22left%22%3EMicrosoft.Graph.Calls%3C%2FTD%3E%0A%3CTD%20align%3D%22left%22%3E%3CA%20href%3D%22https%3A%2F%2Fwww.nuget.org%2Fpackages%2FMicrosoft.Graph.Communications.Calls%2F1.0.0-prerelease.494%22%20target%3D%22_blank%22%20rel%3D%22noopener%20nofollow%20noopener%20noreferrer%20noopener%20noreferrer%22%3EMicrosoft.Graph.Communications.Calls%3C%2FA%3E%3C%2FTD%3E%0A%3C%2FTR%3E%0A%3CTR%3E%0A%3CTD%20align%3D%22left%22%3EMicrosoft.Graph.Calls.Media%3C%2FTD%3E%0A%3CTD%20align%3D%22left%22%3E%3CA%20href%3D%22https%3A%2F%2Fwww.nuget.org%2Fpackages%2FMicrosoft.Graph.Communications.Calls.Media%2F1.0.0-prerelease.494%22%20target%3D%22_blank%22%20rel%3D%22noopener%20nofollow%20noopener%20noreferrer%20noopener%20noreferrer%22%3EMicrosoft.Graph.Communications.Calls.Media%3C%2FA%3E%3C%2FTD%3E%0A%3C%2FTR%3E%0A%3CTR%3E%0A%3CTD%20align%3D%22left%22%3EMicrosoft.Graph.CoreSDK%3C%2FTD%3E%0A%3CTD%20align%3D%22left%22%3E%3CA%20href%3D%22https%3A%2F%2Fwww.nuget.org%2Fpackages%2FMicrosoft.Graph.Communications.Core%2F1.0.0-prerelease.494%22%20target%3D%22_blank%22%20rel%3D%22noopener%20nofollow%20noopener%20noreferrer%20noopener%20noreferrer%22%3EMicrosoft.Graph.Communications.Core%3C%2FA%3E%3C%2FTD%3E%0A%3C%2FTR%3E%0A%3CTR%3E%0A%3CTD%20align%3D%22left%22%3EMicrosoft.Graph.StatefulClient%3C%2FTD%3E%0A%3CTD%20align%3D%22left%22%3E%3CA%20href%3D%22https%3A%2F%2Fwww.nuget.org%2Fpackages%2FMicrosoft.Graph.Communications.Client%2F1.0.0-prerelease.494%22%20target%3D%22_blank%22%20rel%3D%22noopener%20nofollow%20noopener%20noreferrer%20noopener%20noreferrer%22%3EMicrosoft.Graph.Communications.Client%3C%2FA%3E%3C%2FTD%3E%0A%3C%2FTR%3E%0A%3CTR%3E%0A%3CTD%20align%3D%22left%22%3EMicrosoft.Graph.Core.Stateful%3C%2FTD%3E%0A%3CTD%20align%3D%22left%22%3E%3CA%20href%3D%22https%3A%2F%2Fwww.nuget.org%2Fpackages%2FMicrosoft.Graph.Communications.Common%2F1.0.0-prerelease.494%22%20target%3D%22_blank%22%20rel%3D%22noopener%20nofollow%20noopener%20noreferrer%20noopener%20noreferrer%22%3EMicrosoft.Graph.Communications.Common%3C%2FA%3E%3C%2FTD%3E%0A%3C%2FTR%3E%0A%3C%2FTBODY%3E%0A%3C%2FTABLE%3E%0A%3CP%3EThe%20previous%20versions%20have%20been%20marked%20with%20the%20%5BObselete%5D%20decorator%2C%20meaning%20that%20if%20you%20continue%20to%20use%20them%2C%20they%20will%20work%E2%80%A6but%20you%E2%80%99ll%20receive%20a%20warning%3A%20Compiler%20Warning%20(level%202)%3CSPAN%3E%26nbsp%3B%3C%2FSPAN%3E%3CSTRONG%3ECS0618%3C%2FSTRONG%3E.%3C%2FP%3E%0A%3CH2%20id%3D%22toc-hId--899948097%22%20id%3D%22toc-hId--847366055%22%3ENamespace%20names%20have%20changed%3C%2FH2%3E%0A%3CP%3EThere%20have%20also%20been%20some%20changes%20to%20Namespaces.%20For%20instance%2C%20the%26nbsp%3BIStatefulClient%26nbsp%3Bis%20now%26nbsp%3BICommunicationsClient.%20This%20will%20likely%20involve%20some%20rework%20to%20your%20code%3A%3C%2FP%3E%0A%3CP%3E%26nbsp%3B%3C%2FP%3E%0A%3CTABLE%20cellpadding%3D%225%22%3E%0A%3CTHEAD%3E%0A%3CTR%3E%0A%3CTH%20align%3D%22left%22%3EOriginal%20namespace%3C%2FTH%3E%0A%3CTH%20align%3D%22left%22%3ENew%20namespace%3C%2FTH%3E%0A%3C%2FTR%3E%0A%3C%2FTHEAD%3E%0A%3CTBODY%3E%0A%3CTR%3E%0A%3CTD%20align%3D%22left%22%3EMicrosoft.Graph.CoreSDK%3C%2FTD%3E%0A%3CTD%20align%3D%22left%22%3EMicrosoft.Graph.Communications.Core%3C%2FTD%3E%0A%3C%2FTR%3E%0A%3CTR%3E%0A%3CTD%20align%3D%22left%22%3EMicrosoft.Graph.Core%3C%2FTD%3E%0A%3CTD%20align%3D%22left%22%3EMicrosoft.Graph.Communications.Common%3C%2FTD%3E%0A%3C%2FTR%3E%0A%3CTR%3E%0A%3CTD%20align%3D%22left%22%3EMicrosoft.Graph.StatefulClient%3C%2FTD%3E%0A%3CTD%20align%3D%22left%22%3EMicrosoft.Graph.Communications.Client%3C%2FTD%3E%0A%3C%2FTR%3E%0A%3CTR%3E%0A%3CTD%20align%3D%22left%22%3EMicrosoft.Graph.Calls%3C%2FTD%3E%0A%3CTD%20align%3D%22left%22%3EMicrosoft.Graph.Communications.Calls%3C%2FTD%3E%0A%3C%2FTR%3E%0A%3CTR%3E%0A%3CTD%20align%3D%22left%22%3EMicrosoft.Graph.Calls.Media%3C%2FTD%3E%0A%3CTD%20align%3D%22left%22%3EMicrosoft.Graph.Communications.Calls.Media%3C%2FTD%3E%0A%3C%2FTR%3E%0A%3CTR%3E%0A%3CTD%20align%3D%22left%22%3EIStatefulClient%3C%2FTD%3E%0A%3CTD%20align%3D%22left%22%3EICommunicationsClient%3C%2FTD%3E%0A%3C%2FTR%3E%0A%3CTR%3E%0A%3CTD%20align%3D%22left%22%3EStatefulClientBuilder%3C%2FTD%3E%0A%3CTD%20align%3D%22left%22%3ECommunicationsClientBuilder%3C%2FTD%3E%0A%3C%2FTR%3E%0A%3C%2FTBODY%3E%0A%3C%2FTABLE%3E%0A%3CH2%20id%3D%22toc-hId-842862238%22%20id%3D%22toc-hId-895444280%22%3E(Some)%20Attributes%20and%20Method%20Names%20have%20changed%3C%2FH2%3E%0A%3CP%3EAgain%2C%20likely%20to%20break%20your%20code%20on%20an%20update.%20These%20changes%20are%20mostly%20cosmetic%20and%20bring%20the%20naming%20standards%20in%20line%20with%20the%20rest%20of%20Graph%3A%3C%2FP%3E%0A%3CP%3E%26nbsp%3B%3C%2FP%3E%0A%3CTABLE%20cellpadding%3D%225%22%3E%0A%3CTHEAD%3E%0A%3CTR%3E%0A%3CTH%20align%3D%22left%22%3EDeprecated%20items%3C%2FTH%3E%0A%3CTH%20align%3D%22left%22%3EReplacement%3C%2FTH%3E%0A%3C%2FTR%3E%0A%3C%2FTHEAD%3E%0A%3CTBODY%3E%0A%3CTR%3E%0A%3CTD%20align%3D%22left%22%3EAudioRoutingGroup.Owner%3C%2FTD%3E%0A%3CTD%20align%3D%22left%22%3E%3CEM%3Eno%20longer%20used%3C%2FEM%3E%3C%2FTD%3E%0A%3C%2FTR%3E%0A%3CTR%3E%0A%3CTD%20align%3D%22left%22%3ECall.Error%3C%2FTD%3E%0A%3CTD%20align%3D%22left%22%3ECall.ResultInfo%3C%2FTD%3E%0A%3C%2FTR%3E%0A%3CTR%3E%0A%3CTD%20align%3D%22left%22%3ECall.Transfer(TransferTarget%2C%E2%80%A6)%3C%2FTD%3E%0A%3CTD%20align%3D%22left%22%3ECall.Transfer(TransferTarget)%3C%2FTD%3E%0A%3C%2FTR%3E%0A%3CTR%3E%0A%3CTD%20align%3D%22left%22%3ECommsOperation.ErrorInfo%3C%2FTD%3E%0A%3CTD%20align%3D%22left%22%3ECommsOperation.ResultInfo%3C%2FTD%3E%0A%3C%2FTR%3E%0A%3CTR%3E%0A%3CTD%20align%3D%22left%22%3EMeetingParticipantInfo.SipProxyAddress%3C%2FTD%3E%0A%3CTD%20align%3D%22left%22%3E%3CEM%3Eno%20longer%20used%3C%2FEM%3E%3C%2FTD%3E%0A%3C%2FTR%3E%0A%3CTR%3E%0A%3CTD%20align%3D%22left%22%3EOnlineMeeting.CanceledTime%3C%2FTD%3E%0A%3CTD%20align%3D%22left%22%3EOnlineMeeting.CanceledDateTime%3C%2FTD%3E%0A%3C%2FTR%3E%0A%3CTR%3E%0A%3CTD%20align%3D%22left%22%3EOnlineMeeting.CreationTime%3C%2FTD%3E%0A%3CTD%20align%3D%22left%22%3EOnlineMeeting.CreationDateTime%3C%2FTD%3E%0A%3C%2FTR%3E%0A%3CTR%3E%0A%3CTD%20align%3D%22left%22%3EOnlineMeeting.EndTime%3C%2FTD%3E%0A%3CTD%20align%3D%22left%22%3EOnlineMeeting.EndDateTime%3C%2FTD%3E%0A%3C%2FTR%3E%0A%3CTR%3E%0A%3CTD%20align%3D%22left%22%3EOnlineMeeting.ExpirationTime%3C%2FTD%3E%0A%3CTD%20align%3D%22left%22%3EOnlineMeeting.ExpirationDateTime%3C%2FTD%3E%0A%3C%2FTR%3E%0A%3CTR%3E%0A%3CTD%20align%3D%22left%22%3EOnlineMeeting.MeetingInfo%3C%2FTD%3E%0A%3CTD%20align%3D%22left%22%3EOnlineMeeting.Participants.Organizer%3C%2FTD%3E%0A%3C%2FTR%3E%0A%3CTR%3E%0A%3CTD%20align%3D%22left%22%3EOnlineMeeting.StartTime%3C%2FTD%3E%0A%3CTD%20align%3D%22left%22%3EOnlineMeeting.StartDateTime%3C%2FTD%3E%0A%3C%2FTR%3E%0A%3CTR%3E%0A%3CTD%20align%3D%22left%22%3EParticipant.SubscribeVideoAsync%3C%2FTD%3E%0A%3CTD%20align%3D%22left%22%3ECall.GetLocalMediaSession().VideoSocket.Subscribe%3C%2FTD%3E%0A%3C%2FTR%3E%0A%3C%2FTBODY%3E%0A%3C%2FTABLE%3E%0A%3CH2%20id%3D%22toc-hId--1709294723%22%20id%3D%22toc-hId--1656712681%22%3EWhere%20to%20get%20this%20new%20SDK%20from%3F%3C%2FH2%3E%0A%3CP%3EThe%20right%20place%20to%20download%20this%20SDK%20and%20all%20its%20sub-parts%20is%3CSPAN%3E%26nbsp%3B%3C%2FSPAN%3E%3CA%20href%3D%22https%3A%2F%2Fwww.nuget.org%2F%22%20target%3D%22_blank%22%20rel%3D%22noopener%20nofollow%20noopener%20noreferrer%20noopener%20noreferrer%22%3ENuGet%3C%2FA%3E.%20If%20you%E2%80%99re%20not%20familiar%20with%20it%2C%20NuGet%20is%20a%20nice%20easy%20way%20to%20load%20in%20external%20references%20to%20your%20code.%20There%E2%80%99s%20no%20MSI%20to%20install%20and%20you%20can%20control%20everything%20from%20within%20Visual%20Studio.%3C%2FP%3E%0A%3CP%3E%26nbsp%3B%3C%2FP%3E%0A%3CP%3ERead%20more%20on%20my%20blog%3A%20%3CA%20href%3D%22https%3A%2F%2Fblog.thoughtstuff.co.uk%2F2018%2F11%2Fthe-calls-meetings-api-is-now-the-microsoft-graph-communications-api-sdk-package-names-updated%2F%22%20target%3D%22_blank%22%20rel%3D%22nofollow%20noopener%20noreferrer%20noopener%20noreferrer%22%3Ehttps%3A%2F%2Fblog.thoughtstuff.co.uk%2F2018%2F11%2Fthe-calls-meetings-api-is-now-the-microsoft-graph-communications-api-sdk-package-names-updated%2F%3C%2FA%3E%3C%2FP%3E%0A%3CP%3E%26nbsp%3B%3C%2FP%3E%0A%3CP%3Eref%3A%20%3CA%20href%3D%22https%3A%2F%2Fgithub.com%2Fmicrosoftgraph%2Fmicrosoft-graph-comms-samples%2Fblob%2Fmaster%2Fchangelog.md%22%20target%3D%22_blank%22%20rel%3D%22noopener%20noreferrer%20noopener%20noreferrer%22%3Ehttps%3A%2F%2Fgithub.com%2Fmicrosoftgraph%2Fmicrosoft-graph-comms-samples%2Fblob%2Fmaster%2Fchangelog.md%3C%2FA%3E%3C%2FP%3E%3C%2FLINGO-BODY%3E%3CLINGO-LABS%20id%3D%22lingo-labs-288189%22%20slang%3D%22en-US%22%3E%3CLINGO-LABEL%3EMicrosoft%20Teams%3C%2FLINGO-LABEL%3E%3C%2FLINGO-LABS%3E
Highlighted
Tom Morgan
MVP

As the newest API and SDK pair for performing programmatic actions on Microsoft Teams calls makes its way from Public Preview to Generally Available, there are some changes happening to bring it more into line with the other Graph APIs.

 

Firstly, it has a new name. I much prefer this one, it’s more succinct and abstract, and means that when new features are added that aren’t specific to calls or meetings, it won’t look strange.

 

There are some other changes as well. These might well be breaking changes to existing applications, or if they aren’t, there will still be things you should do.

 

NuGet Package names have changed

That’s right – the way you get the SDK has changed. These are the new package names you should use:

Original NuGet package New NuGet package
Microsoft.Graph.Calls Microsoft.Graph.Communications.Calls
Microsoft.Graph.Calls.Media Microsoft.Graph.Communications.Calls.Media
Microsoft.Graph.CoreSDK Microsoft.Graph.Communications.Core
Microsoft.Graph.StatefulClient Microsoft.Graph.Communications.Client
Microsoft.Graph.Core.Stateful Microsoft.Graph.Communications.Common

The previous versions have been marked with the [Obselete] decorator, meaning that if you continue to use them, they will work…but you’ll receive a warning: Compiler Warning (level 2) CS0618.

Namespace names have changed

There have also been some changes to Namespaces. For instance, the IStatefulClient is now ICommunicationsClient. This will likely involve some rework to your code:

 

Original namespace New namespace
Microsoft.Graph.CoreSDK Microsoft.Graph.Communications.Core
Microsoft.Graph.Core Microsoft.Graph.Communications.Common
Microsoft.Graph.StatefulClient Microsoft.Graph.Communications.Client
Microsoft.Graph.Calls Microsoft.Graph.Communications.Calls
Microsoft.Graph.Calls.Media Microsoft.Graph.Communications.Calls.Media
IStatefulClient ICommunicationsClient
StatefulClientBuilder CommunicationsClientBuilder

(Some) Attributes and Method Names have changed

Again, likely to break your code on an update. These changes are mostly cosmetic and bring the naming standards in line with the rest of Graph:

 

Deprecated items Replacement
AudioRoutingGroup.Owner no longer used
Call.Error Call.ResultInfo
Call.Transfer(TransferTarget,…) Call.Transfer(TransferTarget)
CommsOperation.ErrorInfo CommsOperation.ResultInfo
MeetingParticipantInfo.SipProxyAddress no longer used
OnlineMeeting.CanceledTime OnlineMeeting.CanceledDateTime
OnlineMeeting.CreationTime OnlineMeeting.CreationDateTime
OnlineMeeting.EndTime OnlineMeeting.EndDateTime
OnlineMeeting.ExpirationTime OnlineMeeting.ExpirationDateTime
OnlineMeeting.MeetingInfo OnlineMeeting.Participants.Organizer
OnlineMeeting.StartTime OnlineMeeting.StartDateTime
Participant.SubscribeVideoAsync Call.GetLocalMediaSession().VideoSocket.Subscribe

Where to get this new SDK from?

The right place to download this SDK and all its sub-parts is NuGet. If you’re not familiar with it, NuGet is a nice easy way to load in external references to your code. There’s no MSI to install and you can control everything from within Visual Studio.

 

Read more on my blog: https://blog.thoughtstuff.co.uk/2018/11/the-calls-meetings-api-is-now-the-microsoft-graph-communicat...

 

ref: https://github.com/microsoftgraph/microsoft-graph-comms-samples/blob/master/changelog.md

Related Conversations
Tabs and Dark Mode
cjc2112 in Discussions on
16 Replies
flashing a white screen while open new tab
cntvertex in Discussions on
11 Replies
How to Prevent Teams from Auto-Launch
chenrylee in Microsoft Teams on
28 Replies
*Updated 9/3* Syncing in Microsoft Edge Preview Channels
Elliot Kirk in Articles on
217 Replies