SharePoint Saturday Chicago - Everything your need to know about the Microsoft Graph as a SharePoint developer
Download as PPTX, PDF3 likes285 views
This document provides an overview of the Microsoft Graph and how it can be used by SharePoint developers. It discusses how the Graph provides a single endpoint for accessing data from Office 365 through REST APIs. It covers authentication, permissions, and exploring the Graph through tools like the Graph Explorer. It also demonstrates how to retrieve and modify data from the Graph using various approaches like REST calls, SDKs, and webhooks. Finally, it discusses extending the Graph through open extensions and schema extensions.
![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)
})](https://image.slidesharecdn.com/everythingyourneedtoknowaboutthemicrosoftgraphasasharepointdeveloper-170524140926/85/SharePoint-Saturday-Chicago-Everything-your-need-to-know-about-the-Microsoft-Graph-as-a-SharePoint-developer-26-320.jpg)
![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>"
}
}
]
}](https://image.slidesharecdn.com/everythingyourneedtoknowaboutthemicrosoftgraphasasharepointdeveloper-170524140926/85/SharePoint-Saturday-Chicago-Everything-your-need-to-know-about-the-Microsoft-Graph-as-a-SharePoint-developer-30-320.jpg)
![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/
}
]
}](https://image.slidesharecdn.com/everythingyourneedtoknowaboutthemicrosoftgraphasasharepointdeveloper-170524140926/85/SharePoint-Saturday-Chicago-Everything-your-need-to-know-about-the-Microsoft-Graph-as-a-SharePoint-developer-33-320.jpg)
![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"
]
}](https://image.slidesharecdn.com/everythingyourneedtoknowaboutthemicrosoftgraphasasharepointdeveloper-170524140926/85/SharePoint-Saturday-Chicago-Everything-your-need-to-know-about-the-Microsoft-Graph-as-a-SharePoint-developer-34-320.jpg)
![[Draskovic] The next chapter: What's new in SharePoint Server 2019?](https://cdn.slidesharecdn.com/ss_thumbnails/emu0xnrcqfqlcb5tqaku-signature-d4523b3bf020616e67040d2a940ba8bf9aeab187b20da49956548f98de22ea12-poli-180606121948-thumbnail.jpg?width=560&fit=bounds)
![[Vochten/Harbar] SharePoint Server On Premises & Hybrid PowerClass](https://cdn.slidesharecdn.com/ss_thumbnails/ecs18thomasvochtenworkshopitprohybrid-180605144020-thumbnail.jpg?width=560&fit=bounds)
Ad
More Related Content
What's hot (20)
Similar to SharePoint Saturday Chicago - Everything your need to know about the Microsoft Graph as a SharePoint developer (20)
Ad
More from Sébastien Levert (20)
Ad
Recently uploaded (20)
SharePoint Saturday Chicago - Everything your need to know about the Microsoft Graph as a SharePoint developer
- 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. Sponsors
- 4. Agenda
- 5. Introduction
- 6. Building integration with Office 365
- 7. 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/
- 8. 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
- 9. What was announced at //build? • General Availability of Planner APIs • General Availability of SharePoint Sites APIs • General Availability of OneNote APIs • Preview Release of MicrosoftTeams APIs • Preview Release of Insights APIs
- 11. 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
- 12. 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
- 13. Implicit Flow Azure AD Client Application Microsoft Graph 1 2 3 4 Token Token Ressources
- 14. What was announced at //build? • Preview of MSAL for multiple platforms (iOS, Android, Javascript) • OpenId connect enabled for SharePoint Online • Integration of the Graph Client in the SharePoint Framework, but… • Only specific Enpoints are available • Not available yet in the Developer previews (will be, but in a “couple” of weeks)
- 15. Let’s play
- 16. Acting on the graph • Getting Graph data • Creating Graph data • Updating Graph data • Deleting Graph data • Executing actions on the Graph • What about the Office Graph?
- 17. 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
- 18. What about the Office Graph? • Office Graph is officially getting deprecated • Parts of its APIs are being migrated to the Microsoft Graph • Shared • Used • Available on May 22nd, 2017 • GQL APIs to be discontinued on August 31st, 2017
- 19. Exploring the Graph • Using the Graph Explorer • Using REST HTTP Calls • Using .NET • Using PnP PowerShell • Using JavaScript • Using the SDKs
- 20. Using the Graph Explorer
- 21. 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
- 22. Using REST HTTP Calls (SharePoint) Authorization: Bearer eyJ0eXAiOiJKV1QiLCJub25j… Accept: application/json GET https://graph.microsoft.com/v1.0/sites/root GET https://graph.microsoft.com/v1.0/sites/<hostname> GET https://graph.microsoft.com/v1.0/sites/<hostname>:/site/lab GET https://graph.microsoft.com/beta/sites/root/lists GET https://graph.microsoft.com/beta/sites/root/lists/<id>/items GET https://graph.microsoft.com/v1.0/sites/root/drives GET https://graph.microsoft.com/beta/sharePoint/site/lists/<id>/drive
- 23. Oh… And for existing SharePoint Devs…
- 24. 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();
- 25. 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
- 26. Using JavaScript // construct the email object const mail = { subject: "Microsoft Graph JavaScript Sample", toRecipients: [{ emailAddress: { address: "[email protected]" } }], 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) })
- 27. Using the SDKs
- 28. Be notified by the Graph • Webhooks
- 29. Creating a webhook on the Graph POST https://graph.microsoft.com/beta/subscriptions { "changeType": "Created", "notificationUrl": "https://<url>/api/webhookCallback", "resource": "me/messages" }
- 30. 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>" } } ] }
- 31. Extending the Graph • Open type extensions • Schema extensions
- 32. 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/" }
- 33. 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/ } ] }
- 34. 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" ] }
- 35. Adding a schema extension data POST https://graph.microsoft.com/beta/me/contacts/ID { "linkedin_information": { "linkedInUrl": "https://www.linkedin.com/in/seb/" } }
- 36. Next Steps
- 37. 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
- 38. 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
- 39. 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
- 40. Sponsors
- 41. Thank you! @sebastienlevert | http://sebastienlevert.com | Product Evangelist & Partner Manager at