{"id":3810,"date":"2019-12-06T16:11:00","date_gmt":"2019-12-06T23:11:00","guid":{"rendered":"https:\/\/developer.microsoft.com\/en-us\/office\/blogs\/?p=3810"},"modified":"2019-12-06T16:11:00","modified_gmt":"2019-12-06T23:11:00","slug":"microsoft-graph-presence-apis-are-now-available-in-public-preview","status":"publish","type":"post","link":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/microsoft-graph-presence-apis-are-now-available-in-public-preview\/","title":{"rendered":"Microsoft Graph presence APIs are now available in public preview"},"content":{"rendered":"<p>Today, we&#8217;re excited to announce the preview of Microsoft Graph presence APIs. You can use these APIs to:<\/p>\n<ul class=\"wp-block-list\">\n<li>Get presence information <a href=\"https:\/\/docs.microsoft.com\/en-us\/graph\/api\/presence-get?view=graph-rest-beta\">on behalf of the signed-in user<\/a>.<\/li>\n<li>Get presence information <a href=\"https:\/\/docs.microsoft.com\/en-us\/graph\/api\/cloudcommunications-getpresencesbyuserid?view=graph-rest-beta\">for multiple users<\/a>.<\/li>\n<\/ul>\n<p>You can access these APIs using user delegated permissions with admin consent. <\/p>\n<\/p>\n<figure class=\"wp-block-image size-large is-resized\"><img decoding=\"async\" src=\"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-content\/uploads\/sites\/73\/2019\/12\/image-3.png\" alt=\"An image showing the architecture of the presence APIs.\" class=\"wp-image-3814\" width=\"678\" height=\"325\" srcset=\"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-content\/uploads\/sites\/73\/2019\/12\/image-3.png 904w, https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-content\/uploads\/sites\/73\/2019\/12\/image-3-300x144.png 300w, https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-content\/uploads\/sites\/73\/2019\/12\/image-3-768x368.png 768w\" sizes=\"(max-width: 678px) 100vw, 678px\" \/><\/figure>\n<p>Presence APIs return two key parameters: <em>availability <\/em>and <em>activity<\/em>.<br><\/p>\n<ul class=\"wp-block-list\">\n<li><em>Availability<\/em> is basic presence information that returns values such as Available, Busy, Away, and so on.<\/li>\n<li><em>Activity<\/em> is supplemental information about a user\u2019s availability, such as InACall, InAMeeting, OutofOffice, and so on. <\/li>\n<\/ul>\n<p>For a list of the possible values that are returned, see the <a href=\"https:\/\/docs.microsoft.com\/en-us\/graph\/api\/resources\/presence?view=graph-rest-beta\">presence resource topic<\/a>.<br>These values are aligned with the <a href=\"https:\/\/docs.microsoft.com\/en-us\/microsoftteams\/presence-admins\">Teams presence states<\/a>.<\/p>\n<h3 class=\"wp-block-heading\"> Next steps<\/h3>\n<p>Try the APIs using <a href=\"https:\/\/developer.microsoft.com\/en-us\/graph\/graph-explorer\">Microsoft Graph Explorer<\/a>.<\/p>\n<p>If you have any feedback about or suggestions for these APIs, please let us know via <a href=\"https:\/\/microsoftgraph.uservoice.com\/forums\/920506-microsoft-graph-feature-requests?category_id=373858\">User Voice<\/a> (under Cloud Communications).<\/p>\n<p>Happy\ncoding!<\/p>\n","protected":false},"excerpt":{"rendered":"<p>Today, we&#8217;re excited to announce the preview of Microsoft Graph presence APIs. <\/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-3810","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-microsoft-graph"],"acf":[],"blog_post_summary":"<p>Today, we&#8217;re excited to announce the preview of Microsoft Graph presence APIs. <\/p>\n","_links":{"self":[{"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/posts\/3810","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=3810"}],"version-history":[{"count":0,"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/posts\/3810\/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=3810"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/categories?post=3810"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/tags?post=3810"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}