Dive into the Power of the Microsoft Graph Toni Pohl atwork.at

Dive into the Power of the Microsoft Graph What’s now and what’s new in GA and Preview Line-of-business app viewpoint on Microsoft Graph Code and demos

Toni Pohl atwork.at I work as consultant and I am book author, conference speaker, blogger at blog.atwork.at, IT-geek, community-guy, Vespa-fan, scuba diver, travel-addicted, and a Microsoft MVP. Contact details Email : tp@atwork.at Twitter : @atwork www.facebook.com/toni.pohl www.linkedin.com/in/tonipohl

Agenda Overview – Why and How-To Demos Line of Business App demo News

Various API styles and endpoints Microsoft 2016 9/16/2018 4:38 AM Various API styles and endpoints Azure Active Directory Graph API https://graph.windows.net/contoso.com/users https://graph.windows.net/contoso.com/groups SharePoint User Profile API https://contoso.sharepoint.com/_api/SP.UserProfiles.PeopleManager/GetMyProperties Exchange HD Picture API https://graph.microsoft.com/v1.0/me/photo Outlook REST API https://outlook.office.com/api/v2.0/me/Messages https://outlook.office.com/api/v2.0/me/Events Office Graph in SharePoint Online https://contoso.sharepoint.com/_api/search/query?Querytext='*'&Properties='GraphQuery:actor(ME,action\:1020,or(action\:1020\,action\:1003,action\:1001,action\:1024,action\:1005,action\:1037,action\:1039,action\:1036)'&SelectProperties='Docid,Title OneDrive for Business API https://contoso-my.sharepoint.com/personal /jean_contoso_com/_api/v2.0/drive https://contoso.sharepoint.com/sites /designCouncil/_api/v2./drive OneDrive API https://api.onedrive.com/v1.0/drive Windows Live Profile API https://apis.live.net/v5.0/me © 2016 Microsoft Corporation. All rights reserved. MICROSOFT MAKES NO WARRANTIES, EXPRESS, IMPLIED OR STATUTORY, AS TO THE INFORMATION IN THIS PRESENTATION.

- User, group and organizational Data - User, group and organizational Microsoft Teams API - preview Project Rome API - preview SharePoint Sites API – GA OneNote API – GA Planner API – GA One endpoint One token All users Your app https://graph.microsoft.com Users Groups Outlook Calendar SharePoint Excel Intune Teams Azure AD OneNote Planner

Demo: Using Microsoft Graph developer.microsoft.com Microsoft Build 2017 9/16/2018 4:38 AM Demo: Using Microsoft Graph developer.microsoft.com © Microsoft Corporation. All rights reserved. MICROSOFT MAKES NO WARRANTIES, EXPRESS, IMPLIED OR STATUTORY, AS TO THE INFORMATION IN THIS PRESENTATION.

Calling the API https://graph.microsoft.com /{version} /{resource} Build 2015 9/16/2018 4:38 AM Calling the API https://graph.microsoft.com /{version} /{resource} /{id} /{property} ?{query-parameters} HTTP verbs dictate the request intent: GET | POST | PATCH | PUT | DELETE Version: /v1.0 or /beta Resource: /users, /groups, /sites, /drives, /devices, more… Member from collection: /users/AAA Property: /users/AAA/department Traverse to related resources via navigations: /users/AAA/events Query parameters: /users/AAA/events?$top=5 Format results: $select | $orderby Control results: $filter | $expand Paging: $top | $skip | $skiptoken © 2015 Microsoft Corporation. All rights reserved. MICROSOFT MAKES NO WARRANTIES, EXPRESS, IMPLIED OR STATUTORY, AS TO THE INFORMATION IN THIS PRESENTATION.

With Microsoft Graph Get the user profile JeanLuc Admiral Groups Riker Microsoft Build 2017 9/16/2018 4:38 AM GET: /users/JeanLuc { "displayName": "JeanLuc Picard", "jobTitle": “Captain", } GET: /users/JeanLuc/photo/… {} GET: /users/JeanLuc/manager {"displayName": "Starfleet Admiral", …} GET: /users/JeanLuc/directReports "value" : [ {"displayName": "Riker", …}, {"displayName": "Worf", …}, ] GET: /me/memberOf/… {"displayName": "Starfleet engineering", …}, {"displayName": "Beaming", …}, With Microsoft Graph Get the user profile Admiral manager Groups memberOf JeanLuc Riker Worf Data directReports © Microsoft Corporation. All rights reserved. MICROSOFT MAKES NO WARRANTIES, EXPRESS, IMPLIED OR STATUTORY, AS TO THE INFORMATION IN THIS PRESENTATION.

Microsoft Build 2017 9/16/2018 4:38 AM GET /me/drive/root/… "value" : [ {"name": "proposal.pptx",… }, {"name": "forecast.xlsx",… } ] GET /drives/items/{id}/workbook GET /me/messages GET /me/events GET /me/contacts GET /me/onenote/notebooks GET /me/planner/tasks GET /me/devices GET /sites:/teams/opg:/ GET /sites:/teams/opg:/lists GET /groups/{id}/conversations ` With Microsoft Graph Get content for email, calendar, files, tasks, sites, notes & more Documents Calendar Sites Tasks Email Meetings Contacts © Microsoft Corporation. All rights reserved. MICROSOFT MAKES NO WARRANTIES, EXPRESS, IMPLIED OR STATUTORY, AS TO THE INFORMATION IN THIS PRESENTATION.

With Microsoft Graph Get insights based on activities Out of office Microsoft Build 2017 9/16/2018 4:38 AM GET /me/insights/trending "value" : [ {"name": "presentation.pptx", …}, {"name": "forecast.xlsx", …} ] GET /me/drive/recent {"name": "guidelines.pptx", …}, {"name": "budget.xlsx", …} GET people/?$search="topic: planning" {"displayName": "Data", …}, {"displayName": "Worf", …}, POST: /me/findMeetingTimes { "attendees": [ "type": "required", "emailAddress": { "address": "riker@contoso.com" } ], "meetingDuration": "2h" With Microsoft Graph Get insights based on activities Out of office Trending Documents Find me the best time to meet Ana Search people based on topics People I’m working with Recent Documents © Microsoft Corporation. All rights reserved. MICROSOFT MAKES NO WARRANTIES, EXPRESS, IMPLIED OR STATUTORY, AS TO THE INFORMATION IN THIS PRESENTATION.

Have you been using other API’s before? Microsoft Ignite 2016 9/16/2018 4:38 AM Have you been using other API’s before? © 2016 Microsoft Corporation. All rights reserved. MICROSOFT MAKES NO WARRANTIES, EXPRESS, IMPLIED OR STATUTORY, AS TO THE INFORMATION IN THIS PRESENTATION.

Azure AD Graph API = Graph API >>> Use Graph API https://msdn.microsoft.com/en-us/library/azure/hh974476.aspx https://blogs.msdn.microsoft.com/wushuai/2016/09/14/the-difference-between-the-tokens-used-by-microsoft-graph-and-azure-ad-graph/

Graph API = Outlook API >>> Use Graph API Microsoft 2016 9/16/2018 4:38 AM Graph API = Outlook API >>> Use Graph API https://msdn.microsoft.com/en-us/office/office365/api/mail-rest-operations Synchronization supports the query expressions $select, $top, $expand. There is limited support for $filter and $orderby, and no support for $search. The only supported $filter expresssions are “$filter=ReceivedDateTime+ge+{value}” or “$filter=ReceivedDateTime+gt+{value}". The only supported $orderby expression is “$orderby=ReceivedDateTime+desc”. If you do not include an $orderby expression, the return order is not guaranteed. See OData query parameters for filtering, sorting, and paging parameters. © 2016 Microsoft Corporation. All rights reserved. MICROSOFT MAKES NO WARRANTIES, EXPRESS, IMPLIED OR STATUTORY, AS TO THE INFORMATION IN THIS PRESENTATION.

Graph API = Office 365 API >>> Use Graph API Microsoft 2016 9/16/2018 4:38 AM Graph API = Office 365 API >>> Use Graph API https://msdn.microsoft.com/en-us/office/office365/api/api-catalog https://msdn.microsoft.com/en-us/office/office365/api/api-catalog © 2016 Microsoft Corporation. All rights reserved. MICROSOFT MAKES NO WARRANTIES, EXPRESS, IMPLIED OR STATUTORY, AS TO THE INFORMATION IN THIS PRESENTATION.

New Capabilities Traversal of relationships Query parameters Microsoft Build 2017 9/16/2018 4:38 AM New Capabilities Traversal of relationships Query parameters Batching - preview Notifications - users & groups - preview Track changes - GA Extensions - GA © Microsoft Corporation. All rights reserved. MICROSOFT MAKES NO WARRANTIES, EXPRESS, IMPLIED OR STATUTORY, AS TO THE INFORMATION IN THIS PRESENTATION.

Microsoft Build 2017 9/16/2018 4:38 AM Batching POST /$batch { "requests": [{ "id": "1", "url": "/me/drive/root/children",    "method": "POST",    "body": {     "name": "folder1",     "folder": {}    },    "headers": {     "content-type": "application/json"    }   }, {    "id": "2",    "url": "/me/drive/root/children/folder1",    "method": "GET",    "dependsOn": ["1"] }, { "id": "3", "method": "GET", "url": "/me/planner/tasks" "id": "4", "url": "/groups/{id}/events" }  ] With Microsoft Graph Use $batch to combine multiple requests in one call Documents Calendar Sites Tasks Email Meetings Contacts © Microsoft Corporation. All rights reserved. MICROSOFT MAKES NO WARRANTIES, EXPRESS, IMPLIED OR STATUTORY, AS TO THE INFORMATION IN THIS PRESENTATION.

With Microsoft Graph Get notifications & track changes Edited a file GET/me/mailFolders/{id}/messages/delta "@odata.deltalink":"me/mailfolders('AA')/messages/delta?$deltatoken=BB", "value" : […] POST /subscriptions { "changeType": "created,updated", "notificationUrl": "https://app.net/callback", "resource": "/me/mailfolders('AA')/messages", } GET/me/mailFolders/{id}/messages/delta ?$deltatoken=BB" With Microsoft Graph Get notifications & track changes Edited a file Scheduled a new meeting Got a new hire Added a new member to a group Got high important email

Extending the Graph Add extensions to user, group, mail & more Open Extensions GET /me/message/<id>/?$expand=extensions { "displayName": “JeanLuc", "extensions": [ "extensionName": "Com.Contoso.Referral", "companyName": "atwork", "expirationDate": "2017-12-30T11", "dealValue": 10,000 } ] Schema extensions POST /schemaExtensions "id": "training_courses", "targetTypes": [ "Group" ], "properties": [ "name": "courseName", "type": "String" }… GET /groups?$filter=courses/name eq Math101 Extending the Graph Add extensions to user, group, mail & more Customer referral email Group: Math 101 Carlo’s son: Johnny Favorite color: blue

Project ROME

http://aka.ms/projectrome

Quick Start Microsoft Build 2017 9/16/2018 4:38 AM © Microsoft Corporation. All rights reserved. MICROSOFT MAKES NO WARRANTIES, EXPRESS, IMPLIED OR STATUTORY, AS TO THE INFORMATION IN THIS PRESENTATION.

Get started! https://developer.microsoft.com/graph - try it out https://apps.dev.microsoft.com – register you app

Visual Studio Integration Microsoft Build 2017 9/16/2018 4:38 AM Visual Studio Integration © Microsoft Corporation. All rights reserved. MICROSOFT MAKES NO WARRANTIES, EXPRESS, IMPLIED OR STATUTORY, AS TO THE INFORMATION IN THIS PRESENTATION.

SDKs, samples and tooling Microsoft Tech Summit FY17 9/16/2018 4:38 AM SDKs, samples and tooling PREVIEW GA* GA GA GA ASP.NET MVC JavaScript Angular PHP Python PREVIEW PREVIEW GA* GA* GA* Xamarin UWP Android iOS Ruby UPDATED VS integration © 2016 Microsoft Corporation. All rights reserved. MICROSOFT MAKES NO WARRANTIES, EXPRESS, IMPLIED OR STATUTORY, AS TO THE INFORMATION IN THIS PRESENTATION.

(Serverless) Line-of-Business Apps Microsoft Build 2017 9/16/2018 4:38 AM (Serverless) Line-of-Business Apps © Microsoft Corporation. All rights reserved. MICROSOFT MAKES NO WARRANTIES, EXPRESS, IMPLIED OR STATUTORY, AS TO THE INFORMATION IN THIS PRESENTATION.

Graph News Microsoft Build 2017 9/16/2018 4:38 AM © Microsoft Corporation. All rights reserved. MICROSOFT MAKES NO WARRANTIES, EXPRESS, IMPLIED OR STATUTORY, AS TO THE INFORMATION IN THIS PRESENTATION.

Microsoft Graph Data Generally Available ( v1.0 ) Preview ( beta ) Microsoft Build 2017 9/16/2018 4:38 AM Microsoft Graph Data Generally Available ( v1.0 ) Preview ( beta ) Azure Active Directory Outlook mail, calendar and contacts Office 365 groups and conversations OneDrive drives and files Excel Planner  OneNote  SharePoint Sites People Microsoft Teams Insights (powering Delve)* SharePoint Lists Outlook Tasks Intune Office 365 Reporting AD Administrative Units Project Rome © Microsoft Corporation. All rights reserved. MICROSOFT MAKES NO WARRANTIES, EXPRESS, IMPLIED OR STATUTORY, AS TO THE INFORMATION IN THIS PRESENTATION.

Microsoft Graph Capabilities Generally Available ( v1.0 ) Microsoft Build 2017 9/16/2018 4:38 AM Microsoft Graph Capabilities Generally Available ( v1.0 ) Preview ( beta ) Webhooks for OneDrive and Outlook Delta query for OneDrive SDKs for .Net/Xamarin and Android SDKs for JS/Node and PHP  AppOnly webhooks for Outlook Delta query for AAD and Outlook  Extend Graph with your own data SDKs for iOS, Python, Ruby Hybrid on-premise support for Outlook (config wizard support) Webhooks for users and groups Webhooks for Outlook consumer Delta query scoping filter for AAD Batching Microsoft Graph is available in every Office 365 and Azure region and complies with sovereign/national cloud data requirements © Microsoft Corporation. All rights reserved. MICROSOFT MAKES NO WARRANTIES, EXPRESS, IMPLIED OR STATUTORY, AS TO THE INFORMATION IN THIS PRESENTATION.

SharePoint functions

Provisioning Sites with CSOM 9/16/2018 4:38 AM Provisioning Sites with CSOM var tenant = new Tenant(clientContext); var spoOperation = tenant.CreateSite(new SiteCreationProperties { Url ="https://<tenant>.sharepoint.com/sites/<siteName>", Owner = "user@tenant.com", Template = "BLANKINTERNETCONTAINER#0", Title = "Contoso Property Management Dashboard", StorageMaximumLevel = 1000, StorageWarningLevel = 750, TimeZoneId = 7, UserCodeMaximumLevel = 550, UserCodeWarningLevel = 500 }); clientContext.Load(spoOperation); clientContext.ExecuteQuery(); CSOM is around since long time. Until now… © 2014 Microsoft Corporation. All rights reserved. MICROSOFT MAKES NO WARRANTIES, EXPRESS, IMPLIED OR STATUTORY, AS TO THE INFORMATION IN THIS PRESENTATION.

Provisioning Groups with Graph 9/16/2018 4:38 AM Provisioning Groups with Graph var g = new Group { DisplayName = "My Group", MailNickname = "MyGroup", SecurityEnabled = false, MailEnabled = true, Description = "A nice group", GroupTypes = new[] { "Unified" }, }; g = await graphService.Groups.Request().AddAsync(g); Less complex, cleaner, more modern with the Graph. One simple call. Graph Service.do something. With the group, make a request – type safe wrapper (will be translated to http put or delete… depending on the operation) Wrapper (SDK) can significantly reduce code. © 2014 Microsoft Corporation. All rights reserved. MICROSOFT MAKES NO WARRANTIES, EXPRESS, IMPLIED OR STATUTORY, AS TO THE INFORMATION IN THIS PRESENTATION.

Read data from existing SharePoint site 9/16/2018 4:38 AM Read data from existing SharePoint site GET https://graph.microsoft.com/beta/sites/ {siteId}/lists/{listId}/items?expand=columnSet { "value":[ { "createdBy": { "user" : {"id":"d54e4cdd-d2ca-4c39-bfa5-35895bca12f0","displayName":"John"}}, "createdDateTime":"2017-09-20T08:16:21Z", "eTag":"1610ac6a-24f6-4458-9733-1e5977c63caa,1", "id":"1610ac6a-24f6-4458-9733-1e5977c63caa", "lastModifiedBy":{"user":{"id":"d54e4cdd-d2ca-4c39-bfa5-35895bca12f0","displayName":"John"}}, "lastModifiedDateTime":"2017-09-0T08:16:21Z", "webUrl":"https://site.sharepoint.com/sites/mysite/Lists/mytasks/1_.000", "listItemId":1, "columnSet":{ "Title":"Project Upgrade: Use the Microsoft Graph", "Description":"Set up group for new technologies.", "id":"1", ... } }]} No SDKs for SP operations © 2014 Microsoft Corporation. All rights reserved. MICROSOFT MAKES NO WARRANTIES, EXPRESS, IMPLIED OR STATUTORY, AS TO THE INFORMATION IN THIS PRESENTATION.

Planner and Excel functions

Create a plan for new employee tasks 9/16/2018 4:38 AM Create a plan for new employee tasks POST https://graph.microsoft.com/beta/plans { "title" : "My plan with Bob", "owner" : "<groupIdGuid>" } POST https://graph.microsoft.com/beta/buckets "name" : "Urgent", "planId" : "<planId>" // From response to previous call © 2014 Microsoft Corporation. All rights reserved. MICROSOFT MAKES NO WARRANTIES, EXPRESS, IMPLIED OR STATUTORY, AS TO THE INFORMATION IN THIS PRESENTATION.

OneDrive + Excel Services 9/16/2018 4:38 AM OneDrive + Excel Services GET https://graph.microsoft.com/v1.0/me/drive/ root/search(q='.xlsx')?select=name,id,webUrl GET https://graph.microsoft.com/1.0/me/drive/ items/<id>/workbook/worksheets GET https://graph.microsoft.com/beta/me/drive/ items/{itemId}/workbook/worksheets('Time’)/ range(address='a2:d4') © 2014 Microsoft Corporation. All rights reserved. MICROSOFT MAKES NO WARRANTIES, EXPRESS, IMPLIED OR STATUTORY, AS TO THE INFORMATION IN THIS PRESENTATION.

Update latest timesheet data 9/16/2018 4:38 AM Update latest timesheet data PATCH https://graph.microsoft.com/beta/me/drive/ items/{itemId}/workbook/worksheets('Sheet1')/ range(address='a2:b2') { "values": [ ["September", "200.0"] ], "valueTypes": [ ["String", "Double"] ], } © 2014 Microsoft Corporation. All rights reserved. MICROSOFT MAKES NO WARRANTIES, EXPRESS, IMPLIED OR STATUTORY, AS TO THE INFORMATION IN THIS PRESENTATION.

Intune functions

Intune app provisioning code 9/16/2018 4:38 AM Intune app provisioning code POST https://graph.microsoft.com/beta/mobileApps { "@odata.type": "#microsoft.graph.iosStoreApp", "description":"Collab app for iPhone.", "displayName": "Collab App", "isFeatured": false, "publisher": "atwork", "appStoreUrl": "https://itunes.apple.com/us/app/collab/id586683407?mt=8&uo=4", "applicableDeviceType": { "iPad": true, "iPhoneAndIPod": true }, "minimumSupportedOperatingSystem": { "v7_1": false, "v8_0": true, "v9_0": false } { "@odata.type": "#microsoft.graph.iosGeneralDeviceConfiguration", "id": "c7d530ac-f700-401e-b77c-3e686814f654", ... } © 2014 Microsoft Corporation. All rights reserved. MICROSOFT MAKES NO WARRANTIES, EXPRESS, IMPLIED OR STATUTORY, AS TO THE INFORMATION IN THIS PRESENTATION.

Intune app-assignment code 9/16/2018 4:38 AM Intune app-assignment code POST https://graph.microsoft.com/beta/mobileApps/{appIdGuid}/updateAppAssignments { "mobileAppGroupAssignments": [ "targetGroupId": "{GuidOfMyO365Group}", "installIntent": "required" } ] © 2014 Microsoft Corporation. All rights reserved. MICROSOFT MAKES NO WARRANTIES, EXPRESS, IMPLIED OR STATUTORY, AS TO THE INFORMATION IN THIS PRESENTATION.

Improved developer experience Microsoft Build 2017 9/16/2018 4:38 AM Improved developer experience Updated: Portal Graph Explorer Documentation Samples Tooling © Microsoft Corporation. All rights reserved. MICROSOFT MAKES NO WARRANTIES, EXPRESS, IMPLIED OR STATUTORY, AS TO THE INFORMATION IN THIS PRESENTATION.

Coming to Microsoft Graph Microsoft Build 2017 9/16/2018 4:38 AM Coming to Microsoft Graph New data sets More permission options and improved consent experience Richer query capabilities General availability of preview features Hybrid, batching, webhooks for users and groups © Microsoft Corporation. All rights reserved. MICROSOFT MAKES NO WARRANTIES, EXPRESS, IMPLIED OR STATUTORY, AS TO THE INFORMATION IN THIS PRESENTATION.

Call to Action Microsoft Build 2017 9/16/2018 4:38 AM © Microsoft Corporation. All rights reserved. MICROSOFT MAKES NO WARRANTIES, EXPRESS, IMPLIED OR STATUTORY, AS TO THE INFORMATION IN THIS PRESENTATION.

Follow / Check out https://graph.microsoft.com #MicrosoftGraph 9/16/2018 4:38 AM Follow / Check out https://graph.microsoft.com Twitter #MicrosoftGraph GitHub /MicrosoftGraph StackOverflow [MicrosoftGraph] © Microsoft Corporation. All rights reserved. MICROSOFT MAKES NO WARRANTIES, EXPRESS, IMPLIED OR STATUTORY, AS TO THE INFORMATION IN THIS PRESENTATION.