1. Interacting with O365 using MS Graph API
“One endpoint to rule them all”
Nilesh Shah, Consultant
Solvera Solutions

2. About Me Developer/Consultant - MS .NET/Azure TOGAF 9.1 certified EA
MCSD, Microsoft Specialist, MCP
Certified Scrum Master (CSM), Certified Scrum Developer (CSD), Six Sigma Green Belt
Founder member - C# Corner Regina, SK chapter

3. About Solvera Solutions
HO – Regina, Offices in Western Canada
Application Development Consultancy
Architecture & Management Consultancy
One of Canada’s Top 100 Employers
One of Canada’s best managed companies
AON – Best Employer – Platinum Category

4. Contents Overview of Microsoft Graph API
Why Graph?
Advantages, Features, Limitations
Demo
Office 365 developer program
Microsoft Graph API Explorer
Microsoft App Registration Portal
MS Graph SDK
Q & A

5. Why know Graph API? 85% of all Fortune 500 companies are using O365
a.k.a. little sales speech…
85% of all Fortune 500 companies are using O365
85M monthly active users on Office 365 commercial
400M Outlook.com monthly active users
8T resources ( s, events, users, files, groups, and more) in Microsoft Graph

6. Why MS Graph API?

7. Warning: Logo missing…

8. Many Office 365 Apps…

9. Resulting in scattered data…
AND CONVERSATIONS
USER
FILES
EVENTS
PEOPLE
GROUPS

10. Requiring different endpoints…
For Outlook mails, contacts, calendar
For files from cloud
Yammer
OneNote
And many more…
Audience poll – how many has used any of the O365 API? What was their experience? Next slide to focus on dealing with O365 API

11. Calling O365/Cloud API Find the URL/endpoint of the API
Authenticate/Get access token
Get information from the API
Repeat for each service/API
Multiple token management

12. One endpoint to rule them all
Solution… … …
One endpoint to rule them all

13. MS Graph API is…
The easiest way to call Microsoft Office 365 APIs

14. Advantages Ease of development Single well-known resource
Unified API endpoint - No more calling a different endpoint for each service
No more obtaining separate tokens for different services
Single well-known resource
Users, Groups, Mail, Calendars, Contacts
Files, Tasks, People, Notes and more — all from a single endpoint
Logical navigation across item relationships
Platform flexibility
Audience poll for OAUTH and ODATA, slides on OAUTH and ODATA shown based on audience familiarity with these topics, otherwise can skip those slides.

15. Why the name - Graph?
The structure looks like a graph so the name Graph API, Facebook also has graph API

16. Pick the platform of your choice

17. Features The Microsoft identity stack
Used by 85% of the Fortune 500
Access intelligence and insights from the Microsoft cloud
trending documents
best team meeting times
who people typically work with
Open standards support
REST JSON
OAUTH 2.0 OpenID Connect
ODATA V4

18. OAUTH Open standard for “authorization” Microsoft supports OAuth 2.0
It is not “authentication” protocol
Authorize access without password
Uses token after third party authentication is done
Provides secured delegated access on behalf of owner
Microsoft supports OAuth 2.0
Mostly all leading SM providers support it
OpenID Authentication
An extension to OAuth 2.0 authorization
This works as identity layer
Identity provider asserts identity

19. ODATA The Open Data Protocol “The best way to REST”
URL query string operators used to identify data
Simple, standard and readable expressions
MS Graph API compatible with OData V4

20. Authorization flow

21. MS Graph development stack

22. Basic URL pattern
= Microsoft Graph API endpoint
Version = v1.0 or beta
Resource = segment or path
users, groups, devices, events, etc.
Alias: me (logged in user), organization
query_parameters (Optional) = $top, $count, etc.

23. Query Parameters $top $skip $count $select $orderby
Select only specific no. of items
$skip
Skip some items
$count
How many items in result
$select
Specific property
$orderby
Sort the items
There are many more, outlined by OData V4 query language, but this list shows only some of them.

24. Application flow Register the application
Microsoft App Registration Portal :
Configure the project with ID & key
Authenticate the user and get an access token
Call Microsoft Graph API
Show the result

25. Limitations
New functionalities appear first in individual Office 365 REST API
Some functionality not yet available
Batching is not supported
REST APIs in hybrid deployments (currently in preview)
Some OData related limitation
nextLink not supported
$expand: 1 level only
Show demo if possible of not supported functionality like $expand

26. Demo

27. Office 365 Developer Program

28. Office 365 Developer Program

29. Office 365 Developer Program

30. Office 365 Developer Program

31. Office 365 Developer Program

32. Office 365 Developer Program

33. Office 365 Developer Program

34. MS Graph Explorer https://graph.microsoft.io/en-us/graph-explorer
Graph Explorer Permissions

35. Graph Explorer Permissions
Show demo if possible of not supported functionality like $expand

36. Microsoft App Registration Portal
Show demo if possible of not supported functionality like $expand

37. Microsoft App Registration Portal
Show demo if possible of not supported functionality like $expand

38. Microsoft App Registration Portal
Show demo if possible of not supported functionality like $expand

39. Microsoft App Registration Portal
Show demo if possible of not supported functionality like $expand

40. Microsoft App Registration Portal
Show demo if possible of not supported functionality like $expand

41. Summary

42. Useful Resources & Links
All-in-One source:
Try It Yourself:
Watch & Learn:
(Graph API and more, O365 dev)
Repos:
Get Your Hands Dirty:
Office 365 Developer Program

43. Questions & Answers

44. Thanks to Our Sponsors!

45. Sponsors
Special Thanks:

46. What’s next today @ SPS Calgary
Closing and Prize Draws at 3:55pm
Meet at 3:55pm at MacDonald Hall
SharePint and Networking
Time: 4:30pm - 6:00pm, Location TBD

47. Thank You!!! Sharing is caring… nilesh.shah@hotmail.com @NileshR_Shah
/members/nilesh-shah9
Sharing is caring…