{"id":1582,"date":"2017-06-30T15:20:00","date_gmt":"2017-06-30T15:20:00","guid":{"rendered":"https:\/\/developer.microsoft.com\/en-us\/office\/blogs\/?p=1582"},"modified":"2017-06-30T15:20:00","modified_gmt":"2017-06-30T15:20:00","slug":"announcing-new-rest-apis-in-beta-for-rooms-time-zones-and-languages","status":"publish","type":"post","link":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/announcing-new-rest-apis-in-beta-for-rooms-time-zones-and-languages\/","title":{"rendered":"Announcing new REST APIs in beta for rooms, time zones, and languages"},"content":{"rendered":"<p>Today we&#8217;re pleased to announce some new APIs that are available on the beta endpoint for the Outlook REST API. These are currently only available via the Outlook endpoint (<code>https:\/\/outlook.office.com\/api\/beta<\/code>) and not the Microsoft Graph API endpoint.<\/p>\n<p>Try these new APIs out today, either in your code, or on the <a href=\"https:\/\/oauthplay.azurewebsites.net\/\">Outlook OAuth Sandbox<\/a>. Leave feedback on these new APIs on <a href=\"https:\/\/officespdev.uservoice.com\/\">UserVoice<\/a>.<\/p>\n<h2 id=\"meeting-rooms\">Meeting rooms<\/h2>\n<p>One of the top-requested features for the Outlook REST API was the ability to list meeting rooms in an organziation. We&#8217;ve added the ability to find both <a href=\"https:\/\/msdn.microsoft.com\/en-us\/office\/office365\/api\/calendar-rest-operations#GetRooms\">rooms<\/a> and <a href=\"https:\/\/msdn.microsoft.com\/en-us\/office\/office365\/api\/calendar-rest-operations#GetRoomLists\">room lists<\/a>.<\/p>\n<h3 id=\"get-room-lists\">Get room lists<\/h3>\n<p><strong>Request<\/strong><\/p>\n<pre><code class=\"lang-http\">GET https:\/\/outlook.office.com\/api\/beta\/me\/findroomlists<\/code><\/pre>\n<p><strong>Response<\/strong><\/p>\n<pre><code class=\"lang-json\">{\n  \"value\": [\n    {\n      \"Name\": \"Building 1 Rooms\",\n      \"Address\": \"Building1Rooms@contoso.onmicrosoft.com\"\n    },\n    {\n      \"Name\": \"Building 2 Rooms\",\n      \"Address\": \"Building2Rooms@contoso.onmicrosoft.com\"\n    }\n  ]\n}\n<\/code><\/pre>\n<h3 id=\"get-rooms\">Get rooms<\/h3>\n<p><strong>Request (all rooms)<\/strong><\/p>\n<pre><code class=\"lang-http\">GET https:\/\/outlook.office.com\/api\/beta\/me\/findrooms\n<\/code><\/pre>\n<p><strong>Request (rooms in a room list)<\/strong><\/p>\n<pre><code class=\"lang-http\">GET https:\/\/outlook.office.com\/api\/beta\/me\/findrooms(roomlist='Building1Rooms@contoso.onmicrosoft.com')\n<\/code><\/pre>\n<p><strong>Response<\/strong><\/p>\n<pre><code class=\"lang-json\">{\n  \"value\": [\n    {\n      \"Name\": \"Conf Room Adams\",\n      \"Address\": \"Adams@contoso.onmicrosoft.com\"\n    },\n    {\n      \"Name\": \"Conf Room Crystal\",\n      \"Address\": \"Crystal@contoso.onmicrosoft.com\"\n    },\n    {\n      \"Name\": \"Conf Room Stevens\",\n      \"Address\": \"Stevens@contoso.onmicrosoft.com\"\n    }\n  ]\n}\n<\/code><\/pre>\n<h2 id=\"time-zones\">Time zones<\/h2>\n<p>The API has support for specifying a time zone via the <code>Prefer<\/code> header to get back date times in the requested time zone. However, figuring out which time zones are supported has been a little tricky. Now, apps can <a href=\"https:\/\/msdn.microsoft.com\/en-us\/office\/office365\/api\/mail-rest-operations#get-time-zone-choices-preview\">request a list of all supported time zones from the server<\/a>, in either Windows or IANA format.<\/p>\n<p><strong>Request<\/strong><\/p>\n<pre><code class=\"lang-http\">GET https:\/\/outlook.office.com\/api\/beta\/me\/SupportedTimeZones(TimeZoneStandard='Windows')\n<\/code><\/pre>\n<p><strong>Response<\/strong><\/p>\n<pre><code class=\"lang-json\">{\n  \"value\": [\n    {\n      \"Alias\": \"Dateline Standard Time\",\n      \"DisplayName\": \"(UTC-12:00) International Date Line West\"\n    },\n    {\n      \"Alias\": \"Samoa Standard Time\",\n      \"DisplayName\": \"(UTC+13:00) Samoa\"\n    },\n    {\n      \"Alias\": \"UTC-11\",\n      \"DisplayName\": \"(UTC-11:00) Coordinated Universal Time-11\"\n    },\n    {\n      \"Alias\": \"Aleutian Standard Time\",\n      \"DisplayName\": \"(UTC-10:00) Aleutian Islands\"\n    },\n    ...\n  ]\n}\n<\/code><\/pre>\n<h2 id=\"languages\">Languages<\/h2>\n<p>You can also <a href=\"https:\/\/msdn.microsoft.com\/en-us\/office\/office365\/api\/mail-rest-operations#get-language-choices-preview\">request a list of supported languages<\/a> from the server.<\/p>\n<p><strong>Request<\/strong><\/p>\n<pre><code class=\"lang-http\">GET https:\/\/outlook.office.com\/api\/beta\/me\/SupportedLanguages\n<\/code><\/pre>\n<p><strong>Response<\/strong><\/p>\n<pre><code class=\"lang-json\">{\n  \"value\": [\n    {\n      \"Locale\": \"af-ZA\",\n      \"DisplayName\": \"Afrikaans (Suid-Afrika)\"\n    },\n    {\n      \"Locale\": \"am-ET\",\n      \"DisplayName\": \"\u12a0\u121b\u122d\u129b (\u12a2\u1275\u12ee\u1335\u12eb)\"\n    },\n    {\n      \"Locale\": \"ar-AE\",\n      \"DisplayName\": \"\u0627\u0644\u0639\u0631\u0628\u064a\u0629 (\u0627\u0644\u0625\u0645\u0627\u0631\u0627\u062a \u0627\u0644\u0639\u0631\u0628\u064a\u0629 \u0627\u0644\u0645\u062a\u062d\u062f\u0629)\"\n    },\n    {\n      \"Locale\": \"ar-BH\",\n      \"DisplayName\": \"\u0627\u0644\u0639\u0631\u0628\u064a\u0629 (\u0627\u0644\u0628\u062d\u0631\u064a\u0646)\"\n    },\n    ...\n  ]\n}\n<\/code><\/pre>\n","protected":false},"excerpt":{"rendered":"<p>Today we&#8217;re pleased to announce some new APIs that are available on the beta endpoint for the Outlook REST API. These are currently only available via the Outlook endpoint and not the Microsoft Graph API endpoint.<\/p>\n","protected":false},"author":69108,"featured_media":25159,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"footnotes":""},"categories":[3],"tags":[12],"class_list":["post-1582","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-microsoft-graph","tag-outlook"],"acf":[],"blog_post_summary":"<p>Today we&#8217;re pleased to announce some new APIs that are available on the beta endpoint for the Outlook REST API. These are currently only available via the Outlook endpoint and not the Microsoft Graph API endpoint.<\/p>\n","_links":{"self":[{"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/posts\/1582","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\/69108"}],"replies":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/comments?post=1582"}],"version-history":[{"count":0,"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/posts\/1582\/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=1582"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/categories?post=1582"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/tags?post=1582"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}