Microsoft Graph OneNote API iOS Sample README
Created by Microsoft Corporation, 2017. Provided As-is without warranty. Trademarks mentioned here are the property of their owners.
API functionality demonstrated in this sample
The following aspects of the API are covered in this sample. You can find additional documentation at the links below.
- Log-in the user using the ADAL SDK
- GET a user's OneNote notebooks
- GET a user's OneNote notebooks with expanded sections
- GET a user's OneNote pages
- GET a user's OneNote sections
- POST a simple HTML page to a new OneNote QuickNotes page
Prerequisites
Tools and Libraries you will need to download, install, and configure for your development environment.
Be sure to verify the prerequisites for these too.
- Apple XCode and the iOS SDKs.
- Installation of CocoaPods as a dependency manager. CocoaPods will allow you to pull the required dependencies into the project.
Accounts
- As the developer, you'll need to have a Microsoft account and get a client ID string so your app can authenticate with the ADAL SDK. As this sample uses the ADAL SDK, users will need to authenticate using an Azure AD/Org ID account, although converged auth is supported by the Microsoft Graph API.
- If you need other stuff for your iOS app development, visit the Apple developer site to get an apple developer account.
Using the sample
After you've setup your development tools, and installed the prerequisites listed above,....
- Download the repo as a ZIP file to your local Mac, and extract the files. Or, clone the repository into a local copy of Git.
- Using CocoaPods, run
pod installat the root of the project. - Open the MSGraphOneNoteiOSSample.xcworkspace file generated by the previous step.
- Get a client ID string and copy it into MSGONAppConfig.m (~line 25).
- Build and run the app.
- Log in using the running app, using your Azure AD account.
- Allow the app read and write access to your OneNote notebooks.
Version Info
| Date | Change |
|---|---|
| April 2017 | Updated to utilize the Microsoft Graph API endpoints. |
| May 2014 | Initial public release for this code sample. |
Learning More
- Visit the dev.onenote.com Dev Center
- Contact us on StackOverflow (tagged OneNote)
- Follow us on Twitter @onenotedev
- Read our OneNote Developer blog
- Explore the API using the Microsoft Graph Explorer via the beta endpoints. Also, see the OneNote resource documentation.
- Getting Started with the Microsoft Graph APIs
- Overview of Microsoft Graph
This project has adopted the Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ or contact opencode@microsoft.com with any additional questions or comments.