SharePoint Fest Seattle 2017 - Everything your need to know about the Microsoft Graph as a SharePoint Developer
Download as PPTX, PDF0 likes53 views
The document introduces the Microsoft Graph API and how it can be used by SharePoint developers. It provides an overview of the Graph and how it provides a single endpoint for accessing data and insights from Office 365 through various permissions and authentication methods. It also demonstrates how to make HTTP requests to the Graph and explore it using tools like Postman, SDKs, and code examples in languages like C#, JavaScript, and PowerShell.
![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/dev201-everythingyourneedtoknowaboutthemicrosoftgraphasasharepointdeveloper-180318201752/85/SharePoint-Fest-Seattle-2017-Everything-your-need-to-know-about-the-Microsoft-Graph-as-a-SharePoint-Developer-21-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/dev201-everythingyourneedtoknowaboutthemicrosoftgraphasasharepointdeveloper-180318201752/85/SharePoint-Fest-Seattle-2017-Everything-your-need-to-know-about-the-Microsoft-Graph-as-a-SharePoint-Developer-25-320.jpg)
![Getting the value 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/dev201-everythingyourneedtoknowaboutthemicrosoftgraphasasharepointdeveloper-180318201752/85/SharePoint-Fest-Seattle-2017-Everything-your-need-to-know-about-the-Microsoft-Graph-as-a-SharePoint-Developer-28-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/dev201-everythingyourneedtoknowaboutthemicrosoftgraphasasharepointdeveloper-180318201752/85/SharePoint-Fest-Seattle-2017-Everything-your-need-to-know-about-the-Microsoft-Graph-as-a-SharePoint-Developer-29-320.jpg)
SharePoint Fest Seattle 2017 - 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. Hi! I’m Seb! @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
- 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 Seattle" ` -Description "SPFest Seattle" ` -MailNickname "spfest-seattle" Get-PnPUnifiedGroup –Identity "SPFest Seattle" 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 value 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