Connect to data that drives productivity and build smarter apps with Microsoft Graph Gideon Huang

Transcription

1 17-18 March, 2018 Beijing Connect to data that drives productivity and build smarter apps with Microsoft Graph Gideon Huang

2 Opportunity Agenda Microsoft Graph 101 Smart Apps

3 Microsoft Graph a unified REST API and comprehensive developer experience for integrating the data and intelligence exposed by Microsoft services.

4 Microsoft Graph CONVERSATIONS ACTIVITY CONTENT INSIGHTS ME TRENDING ORGANIZATION GROUPS DOCUMENTS CHATS REPORTS EVENTS DEVICES SHARED CONTACTS COLLABORATION PEOPLE TASKS

5 Office 365 Platform EXTENSIONS STANDALONE WEB AND DEVICE APPS DOCUMENTS PAGES CANVASES CONVERSATIONS EMBEDDED CANVASES Microsoft Graph

6 Microsoft Graph Access user, group and organizational data One endpoint One token Your app All users Users Groups SharePoint Outlook OneNote Planner Teams Excel Intune Azure AD more

7 Microsoft Graph API vs. Service APIs Microsoft Graph: Simplest way to access data in Office 365 and other Microsoft cloud services Service specific endpoints: Available and supported Require resource specific access tokens Your app Your app SharePoint Outlook Azure AD

8 Opportunity Agenda Microsoft Graph 101 Smart Apps

9 Microsoft Graph

10 Microsoft Graph Data Active Directory Users profile photo direct reports Groups members conversations SharePoint Sites Lists OneDrive Files upload download copy versions Outlook Mail messages folders send message Calendar events find times Excel OneNote Planner Contacts Directory Beta Teams Insights Project Rome Devices Activities Intune Reports and mu h m e

11 Developing with Microsoft Graph Try Graph Explorer Try a quick start Register your app Find SDKs, samples and tooling Build and distribute

12 With Microsoft Graph Get the user profile GET: { "displayname": Jonathan Tang", "jobtitle": "PRINCIPAL GROUP ENG MANAGER", } GET: /users/jontang@microsoft.com/photo/ {} Yongdong manager Jonathan directreports memberof Frank Kevin Yao Groups GET: /users/jontang@microsoft.com/manager {"displayname": Yongdong", } GET: /users/jontang@microsoft.com/directreports "value" : [ {"displayname": Yao", }, {"displayname": Frank", }, ] GET: /users/jontang@microsoft.com /memberof/ "value" : [ {"displayname": "Office engineering", }, ]

13 Get content GET /me/drive/root/ "value" : [ {"name": "proposal.pptx", }, {"name": "forecast.xlsx", } ] GET /drives/items/{id}/workbook Documents GET /me/messages GET /me/events Calendar Contacts Meetings Sites Tasks 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

14 Get insights GET /me/insights/trending "value" : [ {"name": "presentation.pptx", }, {"name": "forecast.xlsx", } ] Trending Documents Find me the best time to meet Ana Recent Documents Out of office Search people based on topics Pe ple I m working with GET /me/drive/recent "value" : [ {"name": "guidelines.pptx", }, {"name": "budget.xlsx", } ] GET /me/people/?$search="topic: planning" "value" : [ {"displayname": "Dan", }, {"displayname": "Sean", }, ] POST /me/findmeetingtimes { "attendees": [ { "type": "required", " address": { "address": "ana@contoso.com" } ], "meetingduration": "2h" }

15 Calling the API /{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: Property: /users/gihuang/department Traverse to related resources via navigations: /users/gihuang/events Query parameters: /users/gihuang/events?$top=5 o o o Format results: $select $orderby Control results: $filter $expand Paging: $top $skip $skiptoken

16 Microsoft Graph Capabilities Auth Credentials Work/School Personal OAuth scopes User App OData Filter Order Pagination Compliance Conditional access National clouds Query patterns Web hooks Delta Extensions Batching SDKs & tools

17 Get changes GET/me/mailFolders/{id}/messages/delta delta?$deltatoken=bb", "value" : [ ] Edited a file Added a new member to a group Scheduled a new meeting Got a new hire Got high important POST /subscriptions { "changetype": "created,updated", "notificationurl": " "resource": "/me/mailfolders('aa')/messages", } GET/me/mailFolders/{id}/messages/delta?$deltatoken=BB" "value" : [ ]

18 Add extensions Group: Math 101 Favorite color: blue Customer referral PMP Certified Open Extensions GET /me/message/<id>/?$expand=extensions { "displayname": "Yina", "extensions": [ { "extensionname": "Com.Contoso.Referral", "companyname": "Wingtip Toys", "expirationdate": " T11", "dealvalue": 10,000 } ] } Schema extensions POST /schemaextensions { "id": "training_courses", "targettypes": [ "Group" ], "properties": [ { "name": "coursename", "type": "String" } ] } GET /groups?$filter=courses/name eq Math101

19 Use $batch Folder Events Tasks 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", "method": "GET", "url": "/groups/{id}/events" } ] }

20 Azure AD auth endpoints with ADAL Work and school Personal

21 App registration v2.0 Create a new application A unique Id is created for your app Add app platform Web App, SPA, Daemon Native App Web API (Office Add-in) Add permissions for admin consent flows For delegated access for all users in the organization For application access

22 App types and permissions Get access on behalf of users Get access as a service Permission type: delegated Effective permission Permission type: application Delegated permission s User privileges App permissions Users can consent for their data or admin can consent for all users Only admin can consent

23 Auth Microsoft Identity id_token access_token refresh_toke n YOUR APP MSAL or ADAL access_token Microsoft Graph

24 App Demo App: ASP.net Web App Send Get user profile picture Upl ad p u e u e OneD ve Create a table in Excel

25 Opportunity Agenda Microsoft Graph 101 Smart Apps

26 Rich Context Is this person out of the office? Who is their manager? Where do they need to be next? What documents have they been working on recently? The core data that drives business is accessible through the Microsoft Graph Deep Insights Real-time Updates Reschedule meeting when a conflict appears Notify owner when a file is modified Continue a process immediately after approval mail is received

27 Microsoft identity Rich context Deep insights Real-time updates

28 Background Processes Leveraging Microsoft Graph Web apps Native & device apps Bots Microsoft Graph

29 A live smart form demo DevDays Survey Form DevDays Survey Excel

30 Connect Forms and Excel Excel Graph request

31 Resources Document Microsoft Graph Explorer Microsoft Graph Developer Portal Microsoft Graph Docs Training videos Short Video: Using Microsoft Graph to connect to Office 365 data Long Session recording: Microsoft Graph: Build better apps with the API to your organization Auth recording: Office development: Authentication demystified Building Microsoft Graph applications: Authenticate and connect with Microsoft Graph: Microsoft Graph Capabilities: Sample code