1. 5/13/2018 8:08 AM
© Microsoft Corporation. All rights reserved. MICROSOFT MAKES NO WARRANTIES, EXPRESS, IMPLIED OR STATUTORY, AS TO THE INFORMATION IN THIS PRESENTATION.

2. Catch up on Planner APIs in Microsoft Graph
5/13/2018 8:08 AM
P4182
Catch up on Planner APIs in Microsoft Graph
Eray Chou
Principal PM Manager
© Microsoft Corporation. All rights reserved. MICROSOFT MAKES NO WARRANTIES, EXPRESS, IMPLIED OR STATUTORY, AS TO THE INFORMATION IN THIS PRESENTATION.

3. Agenda Overview of Planner Updates to the Planner Task API
5/13/2018 8:08 AM
Agenda
Overview of Planner
Updates to the Planner Task API
Demo of key updates
© 2016 Microsoft Corporation. All rights reserved. MICROSOFT MAKES NO WARRANTIES, EXPRESS, IMPLIED OR STATUTORY, AS TO THE INFORMATION IN THIS PRESENTATION.

4. Planner - Work Management for Teams
Microsoft
5/13/2018
Planner - Work Management for Teams
Build your team
Built in experience for adding members and assigning work
New Office 365 service
Fully integrated into the suite and Office 365 Groups
Customizable columns
Customize each board to the exact needs of your team, process, and content.
My work organized
Access the Planner Hub, My Tasks, and all Plans ordered by activity
Visual and engaging
Document previews, images, and summary in stats make it easy to get an overview
Interactive Boards
Track and organize your team’s work by moving cards between columns
© 2014 Microsoft Corporation. All rights reserved. Microsoft, Windows, and other product names are or may be registered trademarks and/or trademarks in the U.S. and/or other countries.
The information herein is for informational purposes only and represents the current view of Microsoft Corporation as of the date of this presentation. Because Microsoft must respond to changing market conditions, it should not be interpreted to be a commitment on the part of Microsoft, and Microsoft cannot guarantee the accuracy of any information provided after the date of this presentation. MICROSOFT MAKES NO WARRANTIES, EXPRESS, IMPLIED OR STATUTORY, AS TO THE INFORMATION IN THIS PRESENTATION.

5. Planner - Task Details Microsoft 5/13/2018 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.
SharePoint Documents Easily upload new files, attach links, or pick from existing Sharepoint content
Outlook Conversations
Discuss each task to get things done. Conversations show up in Outlook clients and are powered by the Outlook services.
© 2014 Microsoft Corporation. All rights reserved. Microsoft, Windows, and other product names are or may be registered trademarks and/or trademarks in the U.S. and/or other countries.
The information herein is for informational purposes only and represents the current view of Microsoft Corporation as of the date of this presentation. Because Microsoft must respond to changing market conditions, it should not be interpreted to be a commitment on the part of Microsoft, and Microsoft cannot guarantee the accuracy of any information provided after the date of this presentation. MICROSOFT MAKES NO WARRANTIES, EXPRESS, IMPLIED OR STATUTORY, AS TO THE INFORMATION IN THIS PRESENTATION.

6. Groups, Plans, Buckets, and Tasks
Microsoft
5/13/2018
Groups, Plans, Buckets, and Tasks
Group
Plan
Bucket
Task
Task
© 2014 Microsoft Corporation. All rights reserved. Microsoft, Windows, and other product names are or may be registered trademarks and/or trademarks in the U.S. and/or other countries.
The information herein is for informational purposes only and represents the current view of Microsoft Corporation as of the date of this presentation. Because Microsoft must respond to changing market conditions, it should not be interpreted to be a commitment on the part of Microsoft, and Microsoft cannot guarantee the accuracy of any information provided after the date of this presentation. MICROSOFT MAKES NO WARRANTIES, EXPRESS, IMPLIED OR STATUTORY, AS TO THE INFORMATION IN THIS PRESENTATION.

7. Task Details, Attachments, Conversations
Microsoft
5/13/2018
Task Details, Attachments, Conversations
Planner Task Details
File Attachments Powered by SharePoint
Group Conversations powered buy Outlook
© 2014 Microsoft Corporation. All rights reserved. Microsoft, Windows, and other product names are or may be registered trademarks and/or trademarks in the U.S. and/or other countries.
The information herein is for informational purposes only and represents the current view of Microsoft Corporation as of the date of this presentation. Because Microsoft must respond to changing market conditions, it should not be interpreted to be a commitment on the part of Microsoft, and Microsoft cannot guarantee the accuracy of any information provided after the date of this presentation. MICROSOFT MAKES NO WARRANTIES, EXPRESS, IMPLIED OR STATUTORY, AS TO THE INFORMATION IN THIS PRESENTATION.

8. Microsoft Graph
The gateway to Office 365, Azure AD, Intune and more services in the Microsoft Cloud

9. 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

10. Planner Tasks API, now in V1!
5/13/2018
Planner Tasks API, now in V1!
Microsoft Graph
Access data across Office 365 and Microsoft at one single endpoint
Read and write to the Tasks API at:
OData v4 and OAuth 2.0
REST
Use common HTTP verbs like GET/POST/PATCH/DELETE
Group
Owns
Plan
Contains
Task
Task
Task
© 2014 Microsoft Corporation. All rights reserved. Microsoft, Windows, and other product names are or may be registered trademarks and/or trademarks in the U.S. and/or other countries. The information herein is for informational purposes only and represents the current view of Microsoft Corporation as of the date of this presentation. Because Microsoft must respond to changing market conditions, it should not be interpreted to be a commitment on the part of Microsoft, and Microsoft cannot guarantee the accuracy of any information provided after the date of this presentation. MICROSOFT MAKES NO WARRANTIES, EXPRESS, IMPLIED OR STATUTORY, AS TO THE INFORMATION IN THIS PRESENTATION.

11. Recent API Updates New /planner segment Service Generated Order Hints
Tasks assigned to multiple people
Additional properties
Sortable etags

12. New /planner segment Old URLs New URLs /plans /planner/plans /buckets
/planner/buckets
/tasks
/planner/tasks
/user/id/plans
/user/id/planner/plans
/user/id/tasks
/user/id/planner/tasks
/groups/id/plans/
/groups/id/planner/plans/

13. Service Generated Order Hints
Planner objects can be sorted by orderHints. orderHints are strings and should be sorted by their ordinal values
The service will generate orderHints values.
To specify where an item goes, use this format:
"orderHint": "<previous order hint> <next order hint>!"

14. Ex: “<previous order hint> <next order hint>!”
Item 1 { orderHint: ‘5678’}
Item 2 { orderHint: ‘abcd’}
To put an item before item 1
orderHint: ‘ 5678!’
To put an item after item 2
orderHint: ‘abcd !’
To put an item between item 1 and 2
orderHint: ‘5678 abcd!’

15. Tasks assigned to multiple people
assignedTo is now a collection of assignments instead of a single string

16. Demo

17. Other updates Additional properties on Task Sortable etags
activeChecklistItem
checklistItemCount
referenceCount
Sortable etags
ETags will be sortable by ordinal values
Read-only user fields will return an identitySet instead of string
completedBy, createdBy, modifiedBy, assignedBy

18. Call to action Planner Task API Documentation
Microsoft Build 2017
5/13/2018 8:08 AM
Call to action
Planner Task API Documentation
General Microsoft Graph Resources
Learn more at
Find SDKs and samples at
Re-visit Build session recordings on Channel 9
© Microsoft Corporation. All rights reserved. MICROSOFT MAKES NO WARRANTIES, EXPRESS, IMPLIED OR STATUTORY, AS TO THE INFORMATION IN THIS PRESENTATION.

19. Related sessions
Build smart productivity apps with Microsoft Graph .Net SDK 
Automating Data Processing using the Microsoft Graph PHP SDK
Microsoft Graph delta query and webhooks
What is new in Insights APIs in Microsoft Graph
Microsoft Graph extensibility
Catch up on OneNote APIs in Microsoft Graph
Catch up on OneDrive and SharePoint files in Microsoft Graph
Catch up on Outlook APIs in Microsoft Graph
Build smart productivity apps with Microsoft Graph JavaScript SDK 
#MSBuild

20. Thanks!