Since the launch of the Microsoft Graph, a ton of new possibilities are being made available to the Office 365 and SharePoint Developers. The unified API of all the Office 365 is one of the greatest Microsoft innovation of the last few years and is changing the way that solutions are built on Office 365 and SharePoint Online. The launch of the SharePoint endpoints on the Microsoft Graph will enhance our development story and lead to amazing cloud solutions. This session is a deep-dive into the Microsoft Graph by analyzing the current /v1.0 version of the API and what is coming on the future /beta endpoint. The focus of the session will be on the SharePoint-specific features that the Graph is now offering to the SharePoint developers. This very demo-intensive session will make sure that at the end you get those 3 key takeaways : - Understand the role of the Microsoft Graph in the Office 365 ecosystem - Leverage and interact with your SharePoint data from the Microsoft Graph - Change the way you will think for your next SharePoint Online solution

1. Everything you need to know about the
Microsoft Graph as a SharePoint Developer
Sébastien Levert

2. Who’s that guy ?
@sebastienlevert | http://sebastienlevert.com | Product Evangelist & Partner Manager at

3. Agenda

4. Introduction

5. Building integration with Office 365

6. What is the Microsoft Graph?
Single endpoint for:
1 - Accessing data
/me, /users, /groups, /messages, /drive, ….
2 -Traversing data
/drive/<id>/lastmodifiedByUser
3 - Accessing insights
/me/insights/trending
4-Work/School and Personal
https://graph.microsoft.com/

7. Use the Microsoft Graph to build smart apps
Gateway to data and
insights in Office365
Easy traversal of objects and
rich relationships
Web Standards, Open
Platform
Secure data access

8. Authentication & Authorization

9. Azure AD Application
• Proxy to you Office 365 data
• Enable user-consent to be
transparent with the way the
application will play with the data
• Secure protocol
• No capturing user credentials
• Fine-grained access scopes
• Long-term access through refresh
tokens

10. Permissions
• Application permissions
• Act on the Microsoft Graph as a Deamon
• Authentication is certificate-based
• Delegated permissions
• Act on the Microsoft Graph as an authenticated user
• 60+ delegated permissions
• Does not replace the actual permissions on the data

11. Implicit Flow
Azure AD
Client Application Microsoft Graph
1
2
3
4
Token
Token
Ressources

12. Let’s play

13. Acting on the graph
• Getting Graph data
• Creating Graph data
• Updating Graph data
• Deleting Graph data
• Executing actions on the Graph

14. Acting on the Graph
GET https://graph.microsoft.com/v1.0/me
POST https://graph.microsoft.com/v1.0/groups
{
…
}
PATCH https://graph.microsoft.com/v1.0/groups/<id>
DELETE https://graph.microsoft.com/v1.0/groups/<id>
POST https://graph.microsoft.com/v1.0/me/sendMail

15. Exploring the Graph
• Using the Graph Explorer
• Using REST HTTP Calls
• Using .NET
• Using PnP PowerShell
• Using JavaScript
• Using the SDKs

16. Using the Graph Explorer

17. Using REST HTTP Calls
Authorization: Bearer eyJ0eXAiOiJKV1QiLCJub25j…
Accept: application/json
GET https://graph.microsoft.com/v1.0/me
GET https://graph.microsoft.com/v1.0/me/messages
GET https://graph.microsoft.com/v1.0/me/drive/root/children
GET
https://graph.microsoft.com/v1.0/groups?$filter=groupTypes/a
ny(c:c+eq+'Unified')
GET https://graph.microsoft.com/beta/me/trendingAround
GET https://graph.microsoft.com/beta/me/plans

18. Using REST HTTP Calls (SharePoint)
Authorization: Bearer eyJ0eXAiOiJKV1QiLCJub25j…
Accept: application/json
GET https://graph.microsoft.com/beta/sharePoint/sites
GET https://graph.microsoft.com/beta/sharePoint/site
GET https://graph.microsoft.com/beta/sharePoint:/site/lab
GET https://graph.microsoft.com/beta/sharePoint/site/lists
GET https://graph.microsoft.com/beta/sharePoint/site/lists/<id>/items
GET https://graph.microsoft.com/beta/sharePoint/site/drives
GET https://graph.microsoft.com/beta/sharePoint/site/lists/<id>/drive
GET https://graph.microsoft.com/beta/sharePoint/site/lists/<id>/drive/root/children

19. Using .NET
var me = graphServiceClient.Me.Request().GetAsync();
var calendar = await graphServiceClient
.Me
.Calendar
.Request()
.Select("id")
.GetAsync();
var children = await graphServiceClient
.Me
.Drive
.Root
.Children
.Request()
.Expand("thumbnails")
.GetAsync();

20. Using PnP PowerShell
Connect-PnPMicrosoftGraph -Scopes @("Group.ReadWrite.All")
$group = New-PnPUnifiedGroup -DisplayName “SPFest DC" `
-Description “SPFest DC" `
-MailNickname “spfest-dc"
Get-PnPUnifiedGroup –Identity “SPFest DC”
Remove-PnPUnifiedGroup -Identity $group.GroupId

21. Using JavaScript
// construct the email object
const mail = {
subject: "Microsoft Graph JavaScript Sample",
toRecipients: [{
emailAddress: {
address: "example@example.com"
}
}],
body: {
content: "<h1>MicrosoftGraph JavaScript Sample</h1>Check out https://github.com/microsoftgraph/msgraph-
sdk-javascript",
contentType: "html"
}
}
client
.api('/users/me/sendMail')
.post({message: mail}, (err, res) => {
console.log(res)
})

22. Using the SDKs

23. Be notified by the Graph
• Webhooks

24. Creating a webhook on the Graph
POST https://graph.microsoft.com/beta/subscriptions
{
"changeType": "Created",
"notificationUrl": "https://<url>/api/webhookCallback",
"resource": "me/messages"
}

25. Being notified from a webhook
POST https://<url>/api/webhookCallback
{
"value":[
{
"subscriptionId":"7f105c7d-2dc5-4530-97cd-4e7af6534c07",
"subscriptionExpirationDateTime":"2015-11-20T18:23:45.9356913Z",
"changeType":"Created",
"resource":"Users/<user-id>/messages/<message-id>",
"resourceData":{
"@odata.type":"#Microsoft.Graph.Message",
"@odata.id":"Users/<user-id>/messages/<message-id>",
"@odata.etag":"W/"CQAAABYAAACoeN6SYXGLRrvRm+CYrrfQAACvvGdb"",
"Id“:"<message-id>"
}
}
]
}

26. Extending the Graph
• Open type extensions
• Schema extensions

27. Open type extensions
POST https://graph.microsoft.com/beta/me/contacts/ID/extensions
{
"@odata.type": "Microsoft.Graph.OpenTypeExtension",
"extensionName": "Contacts.Extensions.LinkedIn",
"linkedInUrl": "https://www.linkedin.com/in/seb/"
}

28. Getting the valo of an OpenType
GET
https://graph.microsoft.com/beta/me/contacts/ID?expand=Extensions($filter=Id
eq 'Contacts.Extensions.LinkedIn')
{
…
"extensions": [
{
"@odata.type": "#microsoft.graph.openTypeExtension",
"extensionName": "Contacts.Extensions.LinkedIn",
"linkedInUrl": https://www.linkedin.com/in/seb/
}
]
}

29. Defining a schema extension
POST https://graph.Microsoft.com/beta/schemaExtensions
{
"id": "linkedin_information",
"description": "All information about LinkedIn account",
"targetType": ["Contacts"],
"available": "Online",
"properties" : [
"name": "linkedInUrl",
"type": "String"
]
}

30. Adding a schema extension data
POST https://graph.microsoft.com/beta/me/contacts/ID
{
"linkedin_information": {
"linkedInUrl": "https://www.linkedin.com/in/seb/"
}
}

31. Next Steps

32. Resources
• https://dev.office.com
• https://graph.microsoft.io
• https://channel9.msdn.com/Events/Connect/2016/213
• https://techcommunity.microsoft.com/t5/Microsoft-Ignite-
Content/BRK4016-Access-SharePoint-files-and-lists-using-
SharePoint-API/td-p/10403
• https://mva.microsoft.com/product-training/office-development

33. Samples
• https://github.com/SharePoint/PnP-PowerShell
• https://github.com/microsoftgraph/msgraph-sdk-javascript
• https://github.com/microsoftgraph/aspnet-webhooks-rest-sample
• https://github.com/sebastienlevert/officehub

34. Share your experience
• Use hashtags to share your experience
• #Office365Dev
• #MicrosoftGraph
• Contribute and ask question to the MicrosoftTech Community
• https://slevert.me/tech-community-sp-dev
• Log issues & questions to the GitHub Repositories

35. Thank you!
@sebastienlevert | http://sebastienlevert.com | Product Evangelist & Partner Manager at