SPS Vienna 2017 - Getting started with APIs for Groups and Planner
•Download as PPTX, PDF•
0 likes•210 views
Office 365 Groups have the main purpose to increase productivity of teams by leveraging different services under a single hub, as well as underlying technology to Planner and Teams in Office 365. Groups can be accessed through Microsoft Graph API that provide relevant information through set of resources contained in the group content. In this session you will get introduced to Groups and Planner APIs in Office 365, learn what are the basic resources available through REST calls and how to use them in your applications. Depending on available time, we might spend some time introducing Microsoft Graph API.
Recommended
More Related Content
What's hot
What's hot (20)
Similar to SPS Vienna 2017 - Getting started with APIs for Groups and Planner
Similar to SPS Vienna 2017 - Getting started with APIs for Groups and Planner (20)
More from Dragan Panjkov
More from Dragan Panjkov (20)
Recently uploaded
Recently uploaded (20)
SPS Vienna 2017 - Getting started with APIs for Groups and Planner
- 2. Office 365 Groups and Planner APIs Getting Started Dragan Panjkov
- 3. Dragan Panjkov Microsoft MVP since 2014 – Office Servers and Services Consultant at K2 Northern Europe (www.k2.com) Website and blog: www.dragan-panjkov.com Twitter: @panjkov Github: www.github.com/panjkov
- 4. Agenda • Groups overview • Microsoft Graph • Groups APIs • Planner overview • Planner APIs
- 5. Hub for TeamworkCo-AuthorConnect Across the Organization Intranets & Content Management Email & Calendar TeamsOffice AppsYammerSharePointOutlook Office 365 Groups Single team membership across apps and services Microsoft Graph Suite-wide intelligence connecting people and content Security and Compliance Centralized policy management Office 365: Universal Toolkit for Teamwork
- 6. Groups in Office 365 One identity Azure Active Directory (AAD) is the master for group identity and membership across Office 365 (Exchange, SharePoint, etc.) Federated resources Office 365 services extend group with their data (e.g., conversations stored in Exchange mailbox and documents stored in OneDrive for a group) Loose coupling Services notify each other of changes to a group (e.g., creation, deletion, updates) Using sync from AAD to Exchange Online AD and SharePoint Online AD they achieve reliability if they miss notifications
- 7. Demo End User Experience for a group
- 8. Building your app • Register app • Native • Web app • Single page app • Configure app permissions • Groups.Read.All • Groups.ReadWrite.All • Get token using OAuth2.0 flow • Use OpenID Connect for SSO • Build your code using Microsoft Graph
- 9. Microsoft Graph for developers • REST based API endpoints • https://graph.microsoft.com/v1.0/$metadata • SDKs available for all popular platforms
- 10. Microsoft Graph • Single resource that proxies multiple Microsoft services • Allows for easy traversal of objects and relationships • Eliminates the need to discovery endpoints • Only one OAuth access token needed • For both personal and work and school accounts • Exposing User, Group and Organizational data
- 12. GROUP /EVENTS /DRIVE/ROOT/CHILDREN https://graph.microsoft.com/v1.0/groups/?$filter=grouptypes/any(c:c eq 'Unified') /CALENDAR /PLANNER /ONENOTE/CONVERSATIONS /SITES
- 15. $batch 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", "method": "GET", "url": "/groups/{id}/events" } ] } Conversation Documents Calendar Tasks Photo Notes
- 16. notifications track changes GET/groups/delta "@odata.deltalink":“groups/delta?$deltatoken=BB", "value" : […] POST /subscriptions { "changeType": "created,updated", "notificationUrl": "https://app.net/callback", "resource": "/groups", } GET/groups/delta ?$deltatoken=BB" "value" : […] Edited a file Got a new hire Added a new member to a group Scheduled a new meeting Got high important email
- 17. Extending Microsoft Graph extensions Open Extensions GET /me/message/<id>/?$expand=extensions { "displayName": “Mike", "extensions": [ { "extensionName": "Com.Contoso.Referral", "companyName": "Wingtip Toys", "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 Customer referral email Carlo’s son: Johnny Favorite color: blue Group: Math 101
- 18. Demo Groups – Delta query
- 19. Provisioning Groups 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);
- 20. Demo Groups – .NET SDK
- 21. Demo Planner end user experience
- 22. Planner - Work Management for Teams Customizable columns Customize each board to the exact needs of your team, process, and content. Interactive Boards Track and organize your team’s work by moving cards between columns Visual and engaging Document previews, images, and summary in stats make it easy to get an overview New Office 365 service Fully integrated into the suite and Office 365 Groups My work organized Access the Planner Hub, My Tasks, and all Plans ordered by activity Build your team Built in experience for adding members and assigning work
- 23. Planner - Task Details Outlook Conversations Discuss each task to get things done. Conversations show up in Outlook clients and are powered by the Outlook services. SharePoint Documents Easily upload new files, attach links, or pick from existing Sharepoint content Focus on the details Rich details experience include progress, start and due dates, assignments, and description. Custom labels Highlight key tasks with colorful customizable labels. Checklists Breakdown complex items into manageable steps. Jot down ideas to make progress.
- 24. Groups, Plans, Buckets, and Tasks
- 25. Task Details, Attachments, Conversations
- 26. Planner Tasks API • Microsoft Graph • Access data across Office 365 and Microsoft at one single endpoint • Read and write to the Tasks API at: • https://graph.microsoft.com/v1.0/me/planner/t asks • https://graph.microsoft.com/v1.0/planner/plans /{id}/tasks • https://graph.microsoft.com/v1.0/groups/{id}/pl anner/plans • OData v4 and OAuth 2.0 • REST • Use common HTTP verbs like GET/POST/PATCH/DELETE Plan Owns Contains
- 27. Demo Planner API – REST and .NET SDK
- 28. Resources • Microsoft Graph website: https://graph.microsoft.io • Microsoft Graph Explorer: https://developer.microsoft.com/en- us/graph/graph-explorer • Demo project: https://github.com/panjkov/Office365PlannerTask • Sessions from Microsoft Ignite (filter/search for Graph, Azure Active Directory, Groups) https://techcommunity.microsoft.com/t5/Microsoft-Ignite-Content- 2017/bd-p/MicrosoftIgniteContent2017
Editor's Notes
- 5
- The way this all comes together is that the creation of a group in O365 anywhere in the suite create an identity for that team in Office 365 that holds membership, common properties, and links to workloads in the suite. When an app needs to make an update to a property or membership, updates are made to the group in AD, Various applications either read these values directly or hold them in caches, but all common data is mastered in AD.
- No support for $skip and $orderby so paging is post-query
- No support for $skip and $orderby so paging is post-query