[Build 2019] Let’s develop a Microsoft Graph-powered productivity app

As part of Build 2019, i scheduled this Microsoft Graph API related session in my schedule builder – so thought of sharing this one

• Let’s learn how to use Microsoft Graph to bring together some of the best experiences from Microsoft Teams, Outlook, and SharePoint.
• In this Level 300 session, you will see how to build a schedule management app that leverages services including Identity, Notifications, and Calendar, examining query patterns for client apps like deltas, batching, and polling.

Hope this helps.

Microsoft Graph API’s Beta version, developer guidance, support

Microsoft Graph API’s beta version,

• You need to be aware that beta version contains features that are currently in preview. You’re invited to try these APIs.
• Beta version is exposed under https://graph.microsoft.com/beta

How to find if the feature is in beta or not,

When you open the Graph API documentation, you will see the following (refer the important section).

Documentation,

• You can check the same at beta API documentation, see Microsoft
  Graph beta endpoint reference.

How to test it,

You can test them with your custom apps or with Microsoft Graph Explorer.

Please be aware that,

• Expect breaking changes to the beta version from time to time.
• Do not take a production dependency on /beta APIs.
• The beta endpoint includes APIs that are currently in preview and are not yet generally available.
• The APIs in the beta endpoint are subject to change. We don’t recommend that you use them in your production apps
• There’s no guarantees been made that a beta feature will be promoted to the current version.

Beta to General Availability,

• When the Microsoft Graph API team believes that a beta feature is ready for general availability (GA), the feature will be added to the latest current version.
• If the promotion of the feature would result in a breaking change to the current version, the version number will be incremented, with the new version becoming the current version.

Feedback/Questions/Help,

• If you’ve the related feedback, then submit it via the following channels:

• GitHub – For feedback on the Preview APIs, please tag it with beta.
• StackOverflow – For questions or help with your code, tag with microsoftgraph.

Feature request,

• In addition, if you’re an ISV/app developer then you can post feature request on UserVoice, including requests for new features as well as requests to promote existing beta APIs to the current version.

Hope this helps.

Microsoft .NET Conference – Virtual developer event

Microsoft .NET Conf is a free, 3 day virtual developer event co-organized by the .NET community and Microsoft. It just finished last week, September 12 – 14, 2018. Learn more at www.dotnetconf.net

Over the course of the three days we had a wide selection of live sessions that feature speakers from the community and .NET product teams. These are the experts in their field and it is a chance to learn, ask questions live, and get inspired for your next software project.

By attending this session, you will learn to build for web, mobile, desktop, games, services, libraries and more for a variety of platforms and devices all with .NET. We have sessions for everyone, no matter if you are just beginning or are a seasoned engineer. We’ll have presentations on .NET Core and ASP.NET Core, C#, F#, Roslyn, Visual Studio, Xamarin, and much more. So you can click the below link to watch the sessions on demand.

Watch all the sessions on demand on Channel 9

Happy coding!!

Office 365 Developer: Office Web Add-in dialog box cannot be displayed and throws error

I came across this issue while working with my developer customer(s) who was developing an Office Web Add-in (Outlook/OWA specific)

– They designed an Outlook Web add-in, the user is asked to allow a dialog box to be displayed.
– Now the user chooses Allow, and it throws the error message (in both IE and Edge)
– The error message states, “The security settings in your browser prevent us from creating a dialog box. Try a different browser, or configure your browser so that [URL] and the domain shown in your address bar are in the same security zone.”

In order to overcome the issue, we tried adding the domain of the add-in to the list of trusted sites in Internet Explorer – it worked. Just make sure its a trusted add-in!!

Hope this helps!!

Cloud developer guidance: Microsoft Graph or Azure AD Graph?

This is one of the frequent query which i come across. whenever i talked to my app developer customers community. They wanted to know whether they should be using Microsoft Graph (developer.microsoft.com/graph) or Azure AD Graph (graph.windows.net); also i see good number of discussion threads talking the same. In order to conclude this and provide guidance/roadmap, Dan published this wonderful article. I would recommend to have a look at that before you start developing. Please refer https://dev.office.com/blogs/microsoft-graph-or-azure-ad-graph 

In general, we recommend the use of Microsoft Graph over Azure AD Graph, as Microsoft Graph is where we are investing for Microsoft cloud services.

Enjoy!!

Understand more about Office.js, it’s add-in runtime environment and Internet Explorer protected mode!!

In addition to the earlier blog post, you can refer the following:

– Microsoft Office addins using the Apps for Office platform are designed to run in isolation, using a low rights sandbox.
– Several features, such as the task pane view, use web views provided using Internet Explorer APIs. 
– To ensure these components execute HTML script in low rights mode, Office explicitly requires the browser object to run in Protected Mode. 
– Currently, IE does not support this from the API unless Protected Mode is enabled for Restricted Sites zone in IE itself.  This is typically not a problem since this is the default setting, and rarely will users disable it. However, if disabled (by user action or by GPO), these Office addin types may report an error when starting and refuse to load. It is an expected failure under that condition, and is blocked for security reasons.
– So while using Windows desktops, Protect Mode in Internet Explorer must be enabled for the Restricted Site Zone. This is typically enabled by default. If it is disabled, an error will occur when you try to launch an add-in.

For more info, you can refer

– https://msdn.microsoft.com/en-us/library/bb250462(v=vs.85).aspx to know more about “Understanding and Working in Protected Mode Internet Explorer”
– https://dev.office.com/docs/add-ins/develop/privacy-and-security to know more about “Privacy and security for Office Add-ins”

Hope this helps.

Microsoft Graph REST API Developer – Getting list of locales, languages supported for the user mailbox

Using Microsoft Graph REST API, you can get the list of locales and languages that are supported for the user, as configured on the user’s mailbox server. You need to use OutlookUser resource type, which represents the Outlook services available to a given user.

Request:
https://graph.microsoft.com/beta/me/outlook/supportedLanguages

RequestHeader: Authorization, Bearer/Token is required

Response:
If successful, this method returns 200, OK response code and a collection of localeInfo objects in the response body.

So, I see the following response for a given user:

{
     “@odata.context”: “https://graph.microsoft.com/beta/$metadata#Collection(microsoft.graph.localeInfo)”,
     “value”: [
         {
             “locale”: “af-ZA”,
             “displayName”: “Afrikaans (Suid-Afrika)”
         },
         {
             “locale”: “am-ET”,
             “displayName”: “አማርኛ (ኢትዮጵያ)”
         },
         {
             “locale”: “ar-AE”,
             “displayName”: “العربية (الإمارات العربية المتحدة)”
         },
         {
             “locale”: “ar-BH”,
             “displayName”: “العربية (البحرين)”
         },
         {
             “locale”: “ar-DZ”,
             “displayName”: “العربية (الجزائر)”
         },
         {
             “locale”: “ar-EG”,
             “displayName”: “العربية (مصر)”
         },
         {
             “locale”: “ar-IQ”,
             “displayName”: “العربية (العراق)”
         },
         {
             “locale”: “ar-JO”,
             “displayName”: “العربية (الأردن)”
         },
         {
             “locale”: “ar-KW”,
             “displayName”: “العربية (الكويت)”
         },
         {
             “locale”: “ar-LB”,
             “displayName”: “العربية (لبنان)”
         },
         {
             “locale”: “ar-LY”,
             “displayName”: “العربية (ليبيا)”
         },
         {
             “locale”: “ar-MA”,
             “displayName”: “العربية (المملكة المغربية)”
         },
         {
             “locale”: “ar-OM”,
             “displayName”: “العربية (عمان)”
         },
         {
             “locale”: “ar-QA”,
             “displayName”: “العربية (قطر)”
         },
         {
             “locale”: “ar-SA”,
             “displayName”: “العربية (المملكة العربية السعودية)”
         },
         {
             “locale”: “ar-SY”,
             “displayName”: “العربية (سوريا)”
         },
         {
             “locale”: “ar-TN”,
             “displayName”: “العربية (تونس)”
         },
         {
             “locale”: “ar-YE”,
             “displayName”: “العربية (اليمن)”
         },
         {
             “locale”: “as-IN”,
             “displayName”: “অসমীয়া (ভাৰত)”
         },
         {
             “locale”: “az-Latn-AZ”,
             “displayName”: “Azərbaycan dili (Azərbaycan)”
         },
         {
             “locale”: “be-BY”,
             “displayName”: “Беларуская (Беларусь)”
         },
         {
             “locale”: “bg-BG”,
             “displayName”: “български (България)”
         },
         {
             “locale”: “bn-BD”,
             “displayName”: “বাংলা (বাংলাদেশ)”
         },
         {
             “locale”: “bn-IN”,
             “displayName”: “বাংলা (ভারত)”
         },
         {
             “locale”: “bs-Latn-BA”,
             “displayName”: “bosanski (Bosna i Hercegovina)”
         },
         {
             “locale”: “ca-ES”,
             “displayName”: “Català (Català)”
         },
         {
             “locale”: “ca-ES-valencia”,
             “displayName”: “Valencià (Espanya)”
         },
         {
             “locale”: “cs-CZ”,
             “displayName”: “čeština (Česká republika)”
         },
         {
             “locale”: “cy-GB”,
             “displayName”: “Cymraeg (Y Deyrnas Unedig)”
         },
         {
             “locale”: “da-DK”,
             “displayName”: “dansk (Danmark)”
         },
         {
             “locale”: “de-AT”,
             “displayName”: “Deutsch (Österreich)”
         },
         {
             “locale”: “de-CH”,
             “displayName”: “Deutsch (Schweiz)”
         },
         {
             “locale”: “de-DE”,
             “displayName”: “Deutsch (Deutschland)”
         },
         {
             “locale”: “de-LI”,
             “displayName”: “Deutsch (Liechtenstein)”
         },
         {
             “locale”: “de-LU”,
             “displayName”: “Deutsch (Luxemburg)”
         },
         {
             “locale”: “el-GR”,
             “displayName”: “Ελληνικά (Ελλάδα)”
         },
         {
             “locale”: “en-029”,
             “displayName”: “English (Caribbean)”
         },
         {
             “locale”: “en-AU”,
             “displayName”: “English (Australia)”
         },
         {
             “locale”: “en-BZ”,
             “displayName”: “English (Belize)”
         },
         {
             “locale”: “en-CA”,
             “displayName”: “English (Canada)”
         },
         {
             “locale”: “en-GB”,
             “displayName”: “English (United Kingdom)”
         },
         {
             “locale”: “en-IE”,
             “displayName”: “English (Ireland)”
         },
         {
             “locale”: “en-IN”,
             “displayName”: “English (India)”
         },
         {
             “locale”: “en-JM”,
             “displayName”: “English (Jamaica)”
         },
         {
             “locale”: “en-MY”,
             “displayName”: “English (Malaysia)”
         },
         {
             “locale”: “en-NZ”,
             “displayName”: “English (New Zealand)”
         },
         {
             “locale”: “en-PH”,
             “displayName”: “English (Philippines)”
         },
         {
             “locale”: “en-SG”,
             “displayName”: “English (Singapore)”
         },
         {
             “locale”: “en-TT”,
             “displayName”: “English (Trinidad and Tobago)”
         },
         {
             “locale”: “en-US”,
             “displayName”: “English (United States)”
         },
         {
             “locale”: “en-ZA”,
             “displayName”: “English (South Africa)”
         },
         {
             “locale”: “en-ZW”,
             “displayName”: “English (Zimbabwe)”
         },
         {
             “locale”: “es-AR”,
             “displayName”: “español (Argentina)”
         },
         {
             “locale”: “es-BO”,
             “displayName”: “español (Bolivia)”
         },
         {
             “locale”: “es-CL”,
             “displayName”: “español (Chile)”
         },
         {
             “locale”: “es-CO”,
             “displayName”: “español (Colombia)”
         },
         {
             “locale”: “es-CR”,
             “displayName”: “español (Costa Rica)”
         },
         {
             “locale”: “es-DO”,
             “displayName”: “español (República Dominicana)”
         },
         {
             “locale”: “es-EC”,
             “displayName”: “español (Ecuador)”
         },
         {
             “locale”: “es-ES”,
             “displayName”: “español (España, alfabetización internacional)”
         },
         {
             “locale”: “es-GT”,
             “displayName”: “español (Guatemala)”
         },
         {
             “locale”: “es-HN”,
             “displayName”: “español (Honduras)”
         },
         {
             “locale”: “es-MX”,
             “displayName”: “español (México)”
         },
         {
             “locale”: “es-NI”,
             “displayName”: “español (Nicaragua)”
         },
         {
             “locale”: “es-PA”,
             “displayName”: “español (Panamá)”
         },
         {
             “locale”: “es-PE”,
             “displayName”: “español (Perú)”
         },
         {
             “locale”: “es-PR”,
             “displayName”: “español (Puerto Rico)”
         },
         {
             “locale”: “es-PY”,
             “displayName”: “español (Paraguay)”
         },
         {
             “locale”: “es-SV”,
             “displayName”: “español (El Salvador)”
         },
         {
             “locale”: “es-US”,
             “displayName”: “español (Estados Unidos)”
         },
         {
             “locale”: “es-UY”,
             “displayName”: “español (Uruguay)”
         },
         {
             “locale”: “es-VE”,
             “displayName”: “español (Republica Bolivariana de Venezuela)”
         },
         {
             “locale”: “et-EE”,
             “displayName”: “eesti (Eesti)”
         },
         {
             “locale”: “eu-ES”,
             “displayName”: “euskara (euskara)”
         },
         {
             “locale”: “fa-IR”,
             “displayName”: “فارسى (ایران)”
         },
         {
             “locale”: “fi-FI”,
             “displayName”: “suomi (Suomi)”
         },
         {
             “locale”: “fil-PH”,
             “displayName”: “Filipino (Pilipinas)”
         },
         {
             “locale”: “fr-BE”,
             “displayName”: “français (Belgique)”
         },
         {
             “locale”: “fr-CA”,
             “displayName”: “français (Canada)”
         },
         {
             “locale”: “fr-CH”,
             “displayName”: “français (Suisse)”
         },
         {
             “locale”: “fr-FR”,
             “displayName”: “français (France)”
         },
         {
             “locale”: “fr-LU”,
             “displayName”: “français (Luxembourg)”
         },
         {
             “locale”: “fr-MC”,
             “displayName”: “français (Principauté de Monaco)”
         },
         {
             “locale”: “ga-IE”,
             “displayName”: “Gaeilge (Éire)”
         },
         {
             “locale”: “gd-GB”,
             “displayName”: “Gàidhlig (An Rìoghachd Aonaichte)”
         },
         {
             “locale”: “gl-ES”,
             “displayName”: “galego (galego)”
         },
         {
             “locale”: “gu-IN”,
             “displayName”: “ગુજરાતી (ભારત)”
         },
         {
             “locale”: “ha-Latn-NG”,
             “displayName”: “Hausa (Nijeriya)”
         },
         {
             “locale”: “he-IL”,
             “displayName”: “עברית (ישראל)”
         },
         {
             “locale”: “hi-IN”,
             “displayName”: “हिंदी (भारत)”
         },
         {
             “locale”: “hr-BA”,
             “displayName”: “hrvatski (Bosna i Hercegovina)”
         },
         {
             “locale”: “hr-HR”,
             “displayName”: “hrvatski (Hrvatska)”
         },
         {
             “locale”: “hu-HU”,
             “displayName”: “magyar (Magyarország)”
         },
         {
             “locale”: “hy-AM”,
             “displayName”: “Հայերեն (Հայաստան)”
         },
         {
             “locale”: “id-ID”,
             “displayName”: “Bahasa Indonesia (Indonesia)”
         },
         {
             “locale”: “is-IS”,
             “displayName”: “íslenska (Ísland)”
         },
         {
             “locale”: “it-CH”,
             “displayName”: “italiano (Svizzera)”
         },
         {
             “locale”: “it-IT”,
             “displayName”: “italiano (Italia)”
         },
         {
             “locale”: “ja-JP”,
             “displayName”: “日本語 (日本)”
         },
         {
             “locale”: “ka-GE”,
             “displayName”: “ქართული (საქართველო)”
         },
         {
             “locale”: “kk-KZ”,
             “displayName”: “Қазақ (Қазақстан)”
         },
         {
             “locale”: “km-KH”,
             “displayName”: “ភាសាខ្មែរ (កម្ពុជា)”
         },
         {
             “locale”: “kn-IN”,
             “displayName”: “ಕನ್ನಡ (ಭಾರತ)”
         },
         {
             “locale”: “ko-KR”,
             “displayName”: “한국어(대한민국)”
         },
         {
             “locale”: “kok-IN”,
             “displayName”: “कोंकणी (भारत)”
         },
         {
             “locale”: “ky-KG”,
             “displayName”: “Кыргыз (Кыргызстан)”
         },
         {
             “locale”: “lb-LU”,
             “displayName”: “Lëtzebuergesch (Lëtzebuerg)”
         },
         {
             “locale”: “lo-LA”,
             “displayName”: “ພາສາລາວ (ສປປ ລາວ)”
         },
         {
             “locale”: “lt-LT”,
             “displayName”: “lietuvių (Lietuva)”
         },
         {
             “locale”: “lv-LV”,
             “displayName”: “latviešu (Latvija)”
         },
         {
             “locale”: “mi-NZ”,
             “displayName”: “Reo Māori (Aotearoa)”
         },
         {
             “locale”: “mk-MK”,
             “displayName”: “македонски јазик (Македонија)”
         },
         {
             “locale”: “ml-IN”,
             “displayName”: “മലയാളം (ഭാരതം)”
         },
         {
             “locale”: “mn-MN”,
             “displayName”: “Монгол хэл (Монгол улс)”
         },
         {
             “locale”: “mr-IN”,
             “displayName”: “मराठी (भारत)”
         },
         {
             “locale”: “ms-BN”,
             “displayName”: “Bahasa Melayu (Brunei Darussalam)”
         },
         {
             “locale”: “ms-MY”,
             “displayName”: “Bahasa Melayu (Malaysia)”
         },
         {
             “locale”: “mt-MT”,
             “displayName”: “Malti (Malta)”
         },
         {
             “locale”: “ne-IN”,
             “displayName”: “नेपाली (भारत)”
         },
         {
             “locale”: “ne-NP”,
             “displayName”: “नेपाली (नेपाल)”
         },
         {
             “locale”: “nl-BE”,
             “displayName”: “Nederlands (België)”
         },
         {
             “locale”: “nl-NL”,
             “displayName”: “Nederlands (Nederland)”
         },
         {
             “locale”: “nn-NO”,
             “displayName”: “norsk, nynorsk (Noreg)”
         },
         {
             “locale”: “nb-NO”,
             “displayName”: “norsk, bokmål (Norge)”
         },
         {
             “locale”: “or-IN”,
             “displayName”: “ଓଡ଼ିଆ (ଭାରତ)”
         },
         {
             “locale”: “pa-IN”,
             “displayName”: “ਪੰਜਾਬੀ (ਭਾਰਤ)”
         },
         {
             “locale”: “pl-PL”,
             “displayName”: “polski (Polska)”
         },
         {
             “locale”: “prs-AF”,
             “displayName”: “درى (افغانستان)”
         },
         {
             “locale”: “pt-AO”,
             “displayName”: “português (Angola)”
         },
         {
             “locale”: “pt-BR”,
             “displayName”: “português (Brasil)”
         },
         {
             “locale”: “pt-PT”,
             “displayName”: “português (Portugal)”
         },
         {
             “locale”: “quz-BO”,
             “displayName”: “runasimi (Qullasuyu)”
         },
         {
             “locale”: “quz-EC”,
             “displayName”: “runa shimi (Ecuador Suyu)”
         },
         {
             “locale”: “quz-PE”,
             “displayName”: “runasimi (Peru)”
         },
         {
             “locale”: “ro-MD”,
             “displayName”: “română (Republica Moldova)”
         },
         {
             “locale”: “ro-RO”,
             “displayName”: “română (România)”
         },
         {
             “locale”: “ru-RU”,
             “displayName”: “русский (Россия)”
         },
         {
             “locale”: “sd-Arab-PK”,
             “displayName”: “سنڌي (پاکستان)”
         },
         {
             “locale”: “si-LK”,
             “displayName”: “සිංහල (ශ්‍රී ලංකා)”
         },
         {
             “locale”: “sk-SK”,
             “displayName”: “slovenčina (Slovenská republika)”
         },
         {
             “locale”: “sl-SI”,
             “displayName”: “slovenščina (Slovenija)”
         },
         {
             “locale”: “sq-AL”,
             “displayName”: “Shqip (Shqipëria)”
         },
         {
             “locale”: “sr-Latn-CS”,
             “displayName”: “srpski (Srbija i Crna Gora (Bivša))”
         },
         {
             “locale”: “sr-Cyrl-BA”,
             “displayName”: “српски (Босна и Херцеговина)”
         },
         {
             “locale”: “sr-Cyrl-CS”,
             “displayName”: “српски (Србија и Црна Гора (Бивша))”
         },
         {
             “locale”: “sv-FI”,
             “displayName”: “svenska (Finland)”
         },
         {
             “locale”: “sv-SE”,
             “displayName”: “svenska (Sverige)”
         },
         {
             “locale”: “sw-KE”,
             “displayName”: “Kiswahili (Kenya)”
         },
         {
             “locale”: “ta-IN”,
             “displayName”: “தமிழ் (இந்தியா)”
         },
         {
             “locale”: “te-IN”,
             “displayName”: “తెలుగు (భారత దేశం)”
         },
         {
             “locale”: “th-TH”,
             “displayName”: “ไทย (ไทย)”
         },
         {
             “locale”: “tk-TM”,
             “displayName”: “Türkmen dili (Türkmenistan)”
         },
         {
             “locale”: “tr-TR”,
             “displayName”: “Türkçe (Türkiye)”
         },
         {
             “locale”: “tt-RU”,
             “displayName”: “Татар (Россия)”
         },
         {
             “locale”: “ug-CN”,
             “displayName”: “ئۇيغۇرچە (جۇڭخۇا خەلق جۇمھۇرىيىتى)”
         },
         {
             “locale”: “uk-UA”,
             “displayName”: “українська (Україна)”
         },
         {
             “locale”: “ur-IN”,
             “displayName”: “اردو (بھارت)”
         },
         {
             “locale”: “ur-PK”,
             “displayName”: “اُردو (پاکستان)”
         },
         {
             “locale”: “uz-Latn-UZ”,
             “displayName”: “O’zbekcha (O’zbekiston Respublikasi)”
         },
         {
             “locale”: “vi-VN”,
             “displayName”: “Tiếng Việt (Việt Nam)”
         },
         {
             “locale”: “zh-CN”,
             “displayName”: “中文(中华人民共和国)”
         },
         {
             “locale”: “zh-SG”,
             “displayName”: “中文(新加坡)”
         },
         {
             “locale”: “zh-HK”,
             “displayName”: “中文(香港特別行政區)”
         },
         {
             “locale”: “zh-MO”,
             “displayName”: “中文(澳門特別行政區)”
         },
         {
             “locale”: “zh-TW”,
             “displayName”: “中文(台灣)”
         }
     ]
}

Permissions:

Permission type	Permissions (from least to most privileged)
Delegated (work or school account)	User.Read, User.ReadBasic.All
Delegated (personal Microsoft account)	User.Read
Application	User.Read.All

Please note,

– APIs under the /beta version in Microsoft Graph are in preview and are subject to change.
– Use of these APIs in production applications is not supported.

Happy development!!