OneNote REST API supports application-level permissions now
The OneNote API team has announced that it has enabled application-level permissions support for the OneNote API. So far, OneNote API calls could be made with user-delegated permissions only which implied that your application would be restricted to scenarios that needed a user to be signed in. With the latest updates, your application supports scenarios do not call for a user to be signed in which is great news.
- Fariha Khan
- February 10, 2017
With the help of OneNote API application-level permissions support, a number of new scenarios that were not likely in the past are enabled now. Here are for scenario examples:
• Background update of OneNote content.
• Dashboards (based on OneNote metadata and content exposed by the OneNote API).
• Analytics (based on OneNote metadata and content exposed by the OneNote API).
• Background provisioning of OneNote content.
In the development process of building the new application-level permissions support for OneNote API, the company’s Product Management and Engineering teams worked closely with third-party partners in order to make sure that pertinent and important education scenarios were implemented. It also ensured that its API would work great with new and upcoming third-party solutions. Hapara was one of these companies they worked with.
The Hapara Dashboard provides educators with a bird’s-eye view into student work across the Office 365 platform. With Dashboard, educators view and access student work from OneDrive and OneNote Class Notebooks from a central hub, making it easier to engage with students and their work across the Office 365 platform. Hapara relies on the new OneNote API to help co-teachers, counselors, coaches and school administrators gain appropriate access to student work in any classroom, something that previously required manual sharing and significant administrative effort by the individual teachers. Now, cross-school teams gain the same level of access and visibility into Class Notebooks via the Hapara Dashboard as teachers get via the OneNote Class Notebook app. This allows all to participate in serving students, while reducing the administrative burden on the teachers.
Nara Chilluvuri, product manager at Hapara
With the accessibility of application-level permissions support for OneNote API, IT admins, solution providers as well as ISVs can access vital usage data about OneNote across a tenant, including:
• Student usage of Class Notebooks.
• Teacher usage of Class Notebooks.
• Information about particular pages or sections.
• No of pages that were touched and last time each page was touched.
• Information about OneNote Page content, including paragraphs, tables, images and attachments.
• Information about the Collaboration Space usage in the Class Notebook.
Creating a new application or updating your existing application to use the new application-level permissions support for OneNote API calls for two extra steps. In order to find out step-by-step instructions, you can check out the detailed OneNote app-only API documentation on MSDN.