チュートリアル: OneNote アプリを作成する

[アーティクル]
01/12/2016

適用対象: OneDrive のコンシューマーノートブック | Office 365 のエンタープライズノートブック

このチュートリアルでは、OneNote のコンテンツを取得して作成するためにOneNote API を使用する、シンプルなアプリを作成する方法を示します。ここで作成するアプリは、OneNote REST API を使用し、次の 2 つの呼び出しを行います。

直近に変更された 10 のセクションの名前と ID を取得します。

GET ../notes/sections?select=name,id&top=10&orderby=lastModifiedTime%20desc
特定のセクションにページを作成します。

POST ../notes/sections/{id}/pages

プラットフォームを選ぶ:

iOS 向け OneNote アプリを作成する
ASP.NET 向けの OneNote アプリを作成する

注意

このチュートリアルの目的は、OneNote API にアクセスする方法を示すことですが、運用環境向けのコードは含まれていません。アプリを作成するときには、潜在的なセキュリティ、検証、その他コードの品質に関係する問題が生じないかどうか、コードを慎重に確認してください。

iOS 向け OneNote アプリを作成する

アプリは認証とネットワークの呼び出しを処理するために、OneDrive SDK for iOS を使用します。

前提条件

以下に、このチュートリアルを使用するために必要なものを示します。

Apple から入手した Xcode 7。
CocoaPods 依存管理マネージャー。CocoaPods を使い慣れていない場合は、CocoaPods ガイドをご覧ください。
Azure の管理ポータルで登録したネイティブクライアントアプリ、または Microsoft アカウントデベロッパーセンターで登録したモバイルクライアントアプリ。(「アプリを登録する」方法をご覧ください。)

キーサンプルファイルの「完全なコード例」は、このチュートリアルの末尾にあります。

Xcode でプロジェクトを作成する

Xcode で、iOS 向けの OneNote-iOS-App という名前の Single View Application (シングルビューアプリケーション) プロジェクトを作成します。Objective C を選択し、Devices で iPhone を選択します。
プロジェクトを作成後、Xcode を閉じます。Podfile を作成した後、ワークスペースを開きます。

OneDrive SDK 依存関係を追加する

このチュートリアルのアプリでは、Microsoft アカウント (以前の Live Connect) と Azure Active Directory 認証の両方に OneDrive SDK を使用します。Microsoft アカウント認証は、OneDrive のコンシューマーノートブックにアクセスするために使用します。Azure AD 認証は、Office 365 のエンタープライズノートブックにアクセスするために使用します。

Podfile を作成し、Xcode でファイルを開くために、ターミナルで以下のコマンドを実行します。
```
cd {path to the OneNote-iOS-App project directory} 
touch podfile 
open -a xcode podfile 
```
Podfile に OneDrive SDK 依存関係を追加し、ファイルを保存します。
```
pod 'OneDriveSDK'
```
依存関係をインストールし、Xcode でプロジェクトワークスペースを開くために、ターミナルで以下のコマンドを実行します。インストールが完了すると、確認メッセージが表示されます。
```
pod install
open onenote-ios-app.xcworkspace/
```

iOS 9.0 を対象とする Xcode 7 アプリ

Xcode 7 で iOS 9 アプリを対象とする場合、PFS 例外を有効にする必要があります。手順については、iOS 向け OneDrive SDK の readme ファイルのiOS 9 アプリのトランスポートセキュリティ セクションをご覧ください。

UI を構築する

直近にユーザーが変更した 10 のセクションを表示するピッカーと、選択したセクションに OneNote のページを作成するボタンを追加します。

Xcode で、Main.storyboard を開き、size class control (キャンバスの下にあります) を wCompact/hAny に変更します。
Object Library からキャンバスに Picker View と Button をドラッグします。ボタンのテキストは、Create page にします。
次の手順で、ピッカービューの接続を作成します。
a.Control キーを押しながら、Picker View をキャンバスの上にある View Controller アイコンにドラッグします。dataSource outlet を選択します。
b.delegate outlet について同様の操作を繰り返します。
c.View、Assistant Editor、Show Assistant Editor の順に選択し、2 番目のウィンドウで ViewController.h を開きます。
d.Control キーを押しながら、キャンバス内のピッカービューを @interface コードブロックにドラッグします。sectionPicker という名前の Outlet 接続を挿入します。
次の手順で、ボタンの接続を作成します。
a.Control キーを押しながら、キャンバス内のボタンを @interface コードブロックにドラッグします。createPageButton という名前の Outlet 接続を挿入します。
b.アシスタントエディターで ViewController.m を開きます。
c.Control キーを押しながら、キャンバス内のボタンを @implementation コードブロックにドラッグします。Touch Up Inside イベントのための、createPage という名前の Action 接続を挿入します。

UIPickerViewDelegate プロトコルと UIPickerViewDataSource プロトコルを宣言します。

ViewController.h は、以下のようになっています。

 import <UIKit/UIKit.h>

 @interface ViewController : UIViewController<UIPickerViewDelegate, UIPickerViewDataSource>

 @property (weak, nonatomic) IBOutlet UIPickerView *sectionPicker;
 @property (weak, nonatomic) IBOutlet UIButton *createPageButton;

 @end

ViewController.m で、次のデリゲートメソッドをピッカービューに追加します。

 #pragma mark - Delegate Methods
-(NSInteger)numberOfComponentsInPickerView:(UIPickerView *)pickerView {
    return 1;
}

-(NSInteger)pickerView:(UIPickerView *)pickerView numberOfRowsInComponent:(NSInteger)component {
    return sectionNamesForPicker.count;
}

-(NSString *)pickerView:(UIPickerView*)pickerView titleForRow:(NSInteger)row forComponent:(NSInteger)component {
    return [sectionNamesForPicker objectAtIndex:row];
}

sectionNamesForPicker というエラーが表示されますが、気にしないでください。あとで変数を追加します。

viewDidLoad メソッドで、ピッカーに接続するために、[super viewDidLoad] という行のあとに以下のコードを追加します。
```
 self.sectionPicker.delegate = self;
 self.sectionPicker.dataSource = self;
```

認証サポートを追加する

OneDrive SDK は、認証と承認を処理します。必要なのは、アプリケーションに ID を提供し、ODClient を使用することだけです。SDK は、ユーザーがアプリケーションを初回に実行するときに、サインイン UI を呼び出します。その後、アカウント情報は保存されます。(詳しくは、「SDK での認証」をご覧ください。)

AppDelegate.m で、OneDrive SDK をインポートします。
```
 #import <OneDriveSDK/OneDriveSDK.h>
```

didFinishLaunchingWithOptions メソッドを、次のコードに置き換えます。

次に、プレースホルダーのプロパティ値を、登録したアプリの情報に置き換えます。単独のアプリでテストするだけの場合、使用しないプロパティはコメントアウトしても構いません。

  (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {

     // Set the client ID and permission scopes of your app registered on the Microsoft account Developer Center.
     static NSString *const msaClientId = @"000000001A123456";
     static NSString *const msaScopesString = @"wl.signin,wl.offline_access,office.onenote_update";

     // Set the client ID and redirect URI of your app registered on the Azure Management Portal.
     static NSString *const aadClientId = @"0b18d05c-386d-4133-b481-az1234567890";
     static NSString *const aadRedirectUri = @"https://localhost/";

     // Set properties on the ODClient.
     NSArray *const msaScopes = [msaScopesString componentsSeparatedByString:@","];
     [ODClient setMicrosoftAccountAppId:msaClientId
                                 scopes:msaScopes];

     [ODClient setActiveDirectoryAppId:aadClientId
                            capability:@"Notes"
                           redirectURL:aadRedirectUri];
     return YES;
 }

注意

このアプリでは、一度に 1 アカウント (Microsoft アカウント、職場または学校のアカウント) でサインインします。アカウントの種類、および複数アカウントの保存の両方をサポートする方法については、CloudRoll のサンプルをご覧ください。

ViewController.h で、OneDrive SDK をインポートし、ODClient オブジェクトのプロパティを宣言します。SDK に対するすべての呼び出しは、ODClient オブジェクトを介して行われます。

a.次のように import ステートメントを追加します。
```
  #import <OneDriveSDK/OneDriveSDK.h>
```
b.次のように、@interface コードブロックに client プロパティを追加します。
```
  @property (strong, nonatomic) ODClient *client;
```
ViewController.m で、認証済みの ODClient を取得するため、viewDidLoad メソッドの末尾に、次のコードを追加します。

SDK は、ユーザーがアプリケーションを初回に実行するときに、サインイン UI を呼び出します。その後、アカウント情報は保存されます。
```
     [ODClient clientWithCompletion:^(ODClient *odClient, NSError *error) {
         if (!error){
             self.client = odClient;
             [self getSections];
         }
         else {
             NSLog(@"Error with auth: %@", [error localizedDescription]);
         }
     }];
```
次のセクションでは、getSections メソッドを追加します。

ViewController.m で、sendRequest メソッドを @implementation コードブロックに追加します。

このメソッドは、必要な承認ヘッダーを GET sections と POST pages 要求に追加し、データ転送タスクを作成します。

 // Send the request.
 - (void)sendRequest:(NSMutableURLRequest *)request {

     // Add the required Authorization header with access token.
     [self.client.authProvider appendAuthHeaders:request completion:^(NSMutableURLRequest *requests, NSError *error) {

         // This app also uses the OneDrive SDK to send HTTP requests.
         [[self.client.httpProvider dataTaskWithRequest:(request)
                 completionHandler:^(NSData *data,
                 NSURLResponse *response,
                 NSError *error) {
                     [self handleResponse:data response:response error:error];
         }] resume];
     }];
 }

これで、Onenote サービスに呼び出しを行う準備が整いました。

OneNote API を呼び出す

アプリが読み込まれると、直近に変更された 10 のセクションの名前と ID を取得され、セクション名がピッカーに表示されます。選択したセクションで、新しいページが作成されます。

ViewController.h で、次のように応答を格納するプロパティを追加します。
```
// Variables to store the response data.
@property (strong, nonatomic) NSHTTPURLResponse *returnResponse;
@property (strong, nonatomic) NSMutableData *returnData;
```
次の手順のすべてのコードを ViewController.m の @implementation コードブロックに追加します。アプリの作成中に表示されるエラーは気にしないでください。コードが完成すれば、それらのエラーはなくなります。
ViewController.m で、OneNote サービスルート URL、セクション名と ID の辞書、ピッカーに表示されるセクション名の配列に対する変数を追加します。
```
static NSString const *serviceRootUrl = @"https://www.onenote.com/api/v1.0/me/notes/";
NSMutableDictionary *sectionNamesAndIds;
NSArray *sectionNamesForPicker;
```

getSections メソッドを追加して、GET sections 要求を構築します。

 // Build the "GET sections" request.
 - (void)getSections {

     // Construct the request URI and the request.
     NSString *sectionsEndpoint =
             [serviceRootUrl stringByAppendingString:@"sections?select=name,id&top=10&orderby=lastModifiedTime%20desc"];
     NSMutableURLRequest *request =
             [[NSMutableURLRequest alloc] initWithURL:[[NSURL alloc] initWithString:sectionsEndpoint]];
     request.HTTPMethod = @"GET";
     if (self.client)
     {

         // Send the HTTP request.
         [self sendRequest:request];
     }
     _createPageButton.enabled = false;
 }

handleResponse メソッドを追加して、GET sections と POST pages 要求からの応答を処理します。

// Handle the response.
- (void)handleResponse:(NSData *)data response:(NSURLResponse *)response error:(NSError *) error {

    // Log the response.
    NSLog(@"Response %@ with error %@.\n", response, error);
    NSString *stringData = [[NSString alloc] initWithData:data encoding:NSUTF8StringEncoding];
    NSLog(@"Body: %@.\n", stringData);

    // Store the response.
    self.returnData = [[NSMutableData alloc] init];
    NSMutableData *convertedData = [data mutableCopy];
    [self.returnData appendData:convertedData];
    self.returnResponse = (NSHTTPURLResponse *)response;

    NSInteger status = [self.returnResponse statusCode];

    // Check for "GET sections" success.
    if (status == 200) {
        NSLog(@"Sections retrieved!\n");

        // Get the section data and populate the picker.
        [self getSectionNamesAndIds];
    }

    // Check for "POST pages" success.
    else if (status == 201) {
        NSLog(@"Page created!\n");

        // Get the page object and parse out some properties.
        NSDictionary *pageProperties = [self convertData];
        NSString *selfLink = [pageProperties objectForKey:@"self"];
        NSDictionary *links = [pageProperties objectForKey:@"links"];
        NSString *clientUrl = [[links objectForKey:@"oneNoteClientUrl"] objectForKey:@"href"];
        NSString *webUrl = [[links objectForKey:@"oneNoteWebUrl"] objectForKey:@"href"];
        NSLog(@"Link to new page endpoint: %@\n", selfLink);
        NSLog(@"Link open page in the installed client: %@\n", clientUrl);
        NSLog(@"Link to open page in OneNote Online: %@\n", webUrl);
    }
    else {
        NSLog(@"Status code: %ld. Check the logged response for more information.", (long)status);
    }
}

convertData メソッドを追加して、応答データを JSON に変換します。

// Get the OneNote entity data from the response.
- (NSDictionary *)convertData {

    // Convert the message body to JSON.
    NSError *parseError;
    NSDictionary *data = [NSJSONSerialization JSONObjectWithData:self.returnData options:kNilOptions error:&parseError];

    if (!parseError) {
        return data;
    }
    else {
        NSLog(@"Error parsing response: %@", [parseError localizedDescription]);
        return nil;
    }
}

getSectionNamesAndIds メソッドを追加して、セクション名と ID を保存し、ピッカーに表示させます。

// Store the section names and IDs, and populate the section picker.
- (void)getSectionNamesAndIds {

    // Get the "value" array that contains the returned sections.
    NSDictionary *results = [self convertData];

    // Add the name-id pairs to sectionNamesAndIds, which is used to map section names to IDs.
    if ([results objectForKey:@"value"] != nil) {
        NSDictionary *sections =[results objectForKey:@"value"];
        sectionNamesAndIds = [[NSMutableDictionary alloc] init];
        for (NSMutableDictionary *dict in sections) {
            NSString *sectionName = [dict objectForKey:@"name"];
            NSString *sectionId = [dict objectForKey:@"id"];
            sectionNamesAndIds[sectionName] = sectionId;
        }
    }

    // Populate the picker with the section names.
    sectionNamesForPicker = [sectionNamesAndIds allKeys];
    dispatch_async(dispatch_get_main_queue(), ^{[_sectionPicker reloadComponent:0];});

    _createPageButton.enabled = true;
}

ボタンアクションを追加したときに作成した createPage メソッドを編集します。このコードは、シンプルな HTML ページを作成します。

// Create a simple page.
- (IBAction)createPage:(id)sender {

    // Get the ID of the section that's selected in the picker.
    NSInteger row = [self.sectionPicker selectedRowInComponent:0];
    NSString *selectedSectionName = sectionNamesForPicker[row];
    NSString *selectedSectionId = sectionNamesAndIds[selectedSectionName];

    // Construct the request URI and the request.
    NSString *pagesEndpoint = [NSString stringWithFormat:@"sections/%@/pages", selectedSectionId];
    NSString *fullEndpoint = [serviceRootUrl stringByAppendingString:pagesEndpoint];
    NSString *date = [self formatDate];
    NSString *simpleHtml = [NSString stringWithFormat:@"<html>"
                            "<head>"
                            "<title>A page created from simple HTML from iOS</title>"
                            "<meta name=\"created\" content=\"%@\" />"
                            "</head>"
                            "<body>"
                            "<p>This is some <b>simple</b> <i>formatted</i> text.</p>"
                            "</body>"
                            "</html>", date];

    NSData *presentation = [simpleHtml dataUsingEncoding:NSUTF8StringEncoding];
    NSMutableURLRequest * request = [[NSMutableURLRequest alloc] initWithURL:[[NSURL alloc] initWithString:fullEndpoint]];
    request.HTTPMethod = @"POST";
    request.HTTPBody = presentation;
    [request addValue:@"text/html" forHTTPHeaderField:@"Content-Type"];
    if (self.client)
    {

        // Send the HTTP request.
        [self sendRequest:request];
    }
}

formatDate メソッドを追加して、メタタグのタイムスタンプ用に ISO 8601 形式の日付を取得します。

// Format the "created" date. OneNote requires the ISO 8601 format.
- (NSString *)formatDate {
    NSDate *now = [NSDate date];
    NSDateFormatter *dateFormatter = [[NSDateFormatter alloc] init];
    NSLocale *enUSPOSIXLocale = [NSLocale localeWithLocaleIdentifier:@"en_US_POSIX"];
    [dateFormatter setLocale:enUSPOSIXLocale];
    [dateFormatter setDateFormat:@"yyyy-MM-dd'T'HH:mm:ssZZZZZ"];
    return [dateFormatter stringFromDate:now];
}

アプリを作成後、iPhone または iPhone エミュレーターでそのアプリを実行してテストします。Microsoft アカウント、職場または学校アカウントを使用してサインインします。

アプリが開いているときに、ページを作成したいセクションを選択し、Create page を選択します。Xcode の出力ウィンドウでログメッセージを確認します。呼び出しが動作すると、出力ウィンドウには、新しいページのリソースの URI と OneNote でページを開くためのリンクが表示されます。

次の手順

機能、入力の検証、エラー処理を追加します。

たとえば、このメソッドを呼び出すサインアウトボタンを追加します。

- (IBAction)signOut:(UIButton *)sender  {
    [self.client signOutWithCompletion:^(NSError *signOutError) {
        self.client = nil;
        NSLog(@"Logged out.");
    }];
}

OneNote API で実現可能な事柄については、「OneNote API で開発する」という記事をご覧ください。

IOS の完全なコード例

AppDelegate.m

#import "AppDelegate.h"
#import <OneDriveSDK/OneDriveSDK.h>

@interface AppDelegate ()

@end

@implementation AppDelegate


- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {

    // Set the client ID and permission scopes of your app registered on the Microsoft account Developer Center.
    static NSString *const msaClientId = @"000000001A123456";
    static NSString *const msaScopesString = @"wl.signin,wl.offline_access,office.onenote_update";

    // Set the client ID and redirect URI of your app registered on the Azure Management Portal.
    static NSString *const aadClientId = @"0b18d05c-386d-4133-b481-az1234567890";
    static NSString *const aadRedirectUri = @"https://localhost/";

    // Set properties on the ODClient.
    NSArray *const msaScopes = [msaScopesString componentsSeparatedByString:@","];
    [ODClient setMicrosoftAccountAppId:msaClientId
                                scopes:msaScopes];

    [ODClient setActiveDirectoryAppId:aadClientId
                           capability:@"Notes"
                          redirectURL:aadRedirectUri];
    return YES;
}

- (void)applicationWillResignActive:(UIApplication *)application {
    // Sent when the application is about to move from active to inactive state. This can occur for certain types of temporary interruptions (such as an incoming phone call or SMS message) or when the user quits the application and it begins the transition to the background state.
    // Use this method to pause ongoing tasks, disable timers, and throttle down OpenGL ES frame rates. Games should use this method to pause the game.
}

- (void)applicationDidEnterBackground:(UIApplication *)application {
    // Use this method to release shared resources, save user data, invalidate timers, and store enough application state information to restore your application to its current state in case it is terminated later.
    // If your application supports background execution, this method is called instead of applicationWillTerminate: when the user quits.
}

- (void)applicationWillEnterForeground:(UIApplication *)application {
    // Called as part of the transition from the background to the inactive state; here you can undo many of the changes made on entering the background.
}

- (void)applicationDidBecomeActive:(UIApplication *)application {
    // Restart any tasks that were paused (or not yet started) while the application was inactive. If the application was previously in the background, optionally refresh the user interface.
}

- (void)applicationWillTerminate:(UIApplication *)application {
    // Called when the application is about to terminate. Save data if appropriate. See also applicationDidEnterBackground:.
}

@end

ViewController.h

#import <UIKit/UIKit.h>
#import <OneDriveSDK/OneDriveSDK.h>

@interface ViewController : UIViewController<UIPickerViewDelegate, UIPickerViewDataSource>

@property (strong, nonatomic) ODClient *client;

// Variables to store the response data.
@property (strong, nonatomic) NSHTTPURLResponse *returnResponse;
@property (strong, nonatomic) NSMutableData *returnData;

// Outlet connections for controls.
@property (weak, nonatomic) IBOutlet UIPickerView *sectionPicker;
@property (weak, nonatomic) IBOutlet UIButton *createPageButton;

@end

ViewController.m

#import "ViewController.h"

@interface ViewController ()

@end

@implementation ViewController

static NSString const *serviceRootUrl = @"https://www.onenote.com/api/v1.0/me/notes/";
NSMutableDictionary *sectionNamesAndIds;
NSArray *sectionNamesForPicker;

- (void)viewDidLoad {
    [super viewDidLoad];

    self.sectionPicker.delegate = self;
    self.sectionPicker.dataSource = self;

    [ODClient clientWithCompletion:^(ODClient *odClient, NSError *error) {
        if (!error){
            self.client = odClient;
            [self getSections];
        }
        else {
            NSLog(@"Error with auth: %@", [error localizedDescription]);
        }
    }];
}

// Build the "GET sections" request.
- (void)getSections {

    // Construct the request URI and the request.
    NSString *sectionsEndpoint =
            [serviceRootUrl stringByAppendingString:@"sections?select=name,id&top=10&orderby=lastModifiedTime%20desc"];
    NSMutableURLRequest *request =
            [[NSMutableURLRequest alloc] initWithURL:[[NSURL alloc] initWithString:sectionsEndpoint]];
    request.HTTPMethod = @"GET";
    if (self.client)
    {

        // Send the HTTP request.
        [self sendRequest:request];
    }
    _createPageButton.enabled = false;
}

// Send the request.
- (void)sendRequest:(NSMutableURLRequest *)request {

    // Add the required Authorization header with access token.
    [self.client.authProvider appendAuthHeaders:request completion:^(NSMutableURLRequest *requests, NSError *error) {

        // This app also uses the OneDrive SDK to send HTTP requests.
        [[self.client.httpProvider dataTaskWithRequest:(request)
                completionHandler:^(NSData *data,
                NSURLResponse *response,
                NSError *error) {
                    [self handleResponse:data response:response error:error];
        }] resume];
    }];
}

// Store the section names and IDs, and populate the section picker.
- (void)getSectionNamesAndIds {

    // Get the "value" array that contains the returned sections.
    NSDictionary *results = [self convertData];

    // Add the name-id pairs to sectionNamesAndIds, which is used to map section names to IDs.
    if ([results objectForKey:@"value"] != nil) {
        NSDictionary *sections =[results objectForKey:@"value"];
        sectionNamesAndIds = [[NSMutableDictionary alloc] init];
        for (NSMutableDictionary *dict in sections) {
            NSString *sectionName = [dict objectForKey:@"name"];
            NSString *sectionId = [dict objectForKey:@"id"];
            sectionNamesAndIds[sectionName] = sectionId;
        }
    }

    // Populate the picker with the section names.
    sectionNamesForPicker = [sectionNamesAndIds allKeys];
    dispatch_async(dispatch_get_main_queue(), ^{[_sectionPicker reloadComponent:0];});

    _createPageButton.enabled = true;
}

// Get the OneNote entity data from the response.
- (NSDictionary *)convertData {

    // Convert the message body to JSON.
    NSError *parseError;
    NSDictionary *data = [NSJSONSerialization JSONObjectWithData:self.returnData options:kNilOptions error:&parseError];

    if (!parseError) {
        return data;
    }
    else {
        NSLog(@"Error parsing response: %@", [parseError localizedDescription]);
        return nil;
    }
}

// Handle the response.
- (void)handleResponse:(NSData *)data response:(NSURLResponse *)response error:(NSError *) error {

    // Log the response.
    NSLog(@"Response %@ with error %@.\n", response, error);
    NSString *stringData = [[NSString alloc] initWithData:data encoding:NSUTF8StringEncoding];
    NSLog(@"Body: %@.\n", stringData);

    // Store the response.
    self.returnData = [[NSMutableData alloc] init];
    NSMutableData *convertedData = [data mutableCopy];
    [self.returnData appendData:convertedData];
    self.returnResponse = (NSHTTPURLResponse *)response;

    NSInteger status = [self.returnResponse statusCode];

    // Check for "GET sections" success.
    if (status == 200) {
        NSLog(@"Sections retrieved!\n");

        // Get the section data and populate the picker.
        [self getSectionNamesAndIds];
    }

    // Check for "POST pages" success.
    else if (status == 201) {
        NSLog(@"Page created!\n");

        // Get the page object and parse out some properties.
        NSDictionary *pageProperties = [self convertData];
        NSString *selfLink = [pageProperties objectForKey:@"self"];
        NSDictionary *links = [pageProperties objectForKey:@"links"];
        NSString *clientUrl = [[links objectForKey:@"oneNoteClientUrl"] objectForKey:@"href"];
        NSString *webUrl = [[links objectForKey:@"oneNoteWebUrl"] objectForKey:@"href"];
        NSLog(@"Link to new page endpoint: %@\n", selfLink);
        NSLog(@"Link open page in the installed client: %@\n", clientUrl);
        NSLog(@"Link to open page in OneNote Online: %@\n", webUrl);
    }
    else {
        NSLog(@"Status code: %ld. Check the logged response for more information.", (long)status);
    }
}

// Create a simple page.
- (IBAction)createPage:(id)sender {

    // Get the ID of the section that's selected in the picker.
    NSInteger row = [self.sectionPicker selectedRowInComponent:0];
    NSString *selectedSectionName = sectionNamesForPicker[row];
    NSString *selectedSectionId = sectionNamesAndIds[selectedSectionName];

    // Construct the request URI and the request.
    NSString *pagesEndpoint = [NSString stringWithFormat:@"sections/%@/pages", selectedSectionId];
    NSString *fullEndpoint = [serviceRootUrl stringByAppendingString:pagesEndpoint];
    NSString *date = [self formatDate];
    NSString *simpleHtml = [NSString stringWithFormat:@"<html>"
                            "<head>"
                            "<title>A page created from simple HTML from iOS</title>"
                            "<meta name=\"created\" content=\"%@\" />"
                            "</head>"
                            "<body>"
                            "<p>This is some <b>simple</b> <i>formatted</i> text.</p>"
                            "</body>"
                            "</html>", date];

    NSData *presentation = [simpleHtml dataUsingEncoding:NSUTF8StringEncoding];
    NSMutableURLRequest * request = [[NSMutableURLRequest alloc] initWithURL:[[NSURL alloc] initWithString:fullEndpoint]];
    request.HTTPMethod = @"POST";
    request.HTTPBody = presentation;
    [request addValue:@"text/html" forHTTPHeaderField:@"Content-Type"];
    if (self.client)
    {

        // Send the HTTP request.
        [self sendRequest:request];
    }
}

// Format the "created" date. OneNote requires the ISO 8601 format.
- (NSString *)formatDate {
    NSDate *now = [NSDate date];
    NSDateFormatter *dateFormatter = [[NSDateFormatter alloc] init];
    NSLocale *enUSPOSIXLocale = [NSLocale localeWithLocaleIdentifier:@"en_US_POSIX"];
    [dateFormatter setLocale:enUSPOSIXLocale];
    [dateFormatter setDateFormat:@"yyyy-MM-dd'T'HH:mm:ssZZZZZ"];
    return [dateFormatter stringFromDate:now];
}

- (void)didReceiveMemoryWarning {
    [super didReceiveMemoryWarning];
    // Dispose of any resources that can be recreated.
}

#pragma mark - Delegate Methods
-(NSInteger)numberOfComponentsInPickerView:(UIPickerView *)pickerView {
    return 1;
}

-(NSInteger)pickerView:(UIPickerView *)pickerView numberOfRowsInComponent:(NSInteger)component {
    return sectionNamesForPicker.count;
}

-(NSString *)pickerView:(UIPickerView*)pickerView titleForRow:(NSInteger)row forComponent:(NSInteger)component {
    return [sectionNamesForPicker objectAtIndex:row];
}
@end

ASP.NET MVC 向けの OneNote アプリを作成する

この Web アプリケーションは、Azure Active Directory Authentication Library (ADAL) for .NET を使用して、複数のテナントから職場や学校のアカウントを認証します。

前提条件

以下に、このチュートリアルを使用するために必要なものを示します。

Visual Studio 2015。無償の Visual Studio Community エディションを使用できます。
Azure の管理ポータルに登録されている Web アプリケーションで、デリゲートされた次のアクセス許可があるもの。
- Windows Azure Active Directory のサインインとユーザープロファイルの読み込み
- OneNote の OneNote ノートブックの表示と変更

注意

アプリ作成時に、Visual Studio はWeb アプリを登録しますが、再度 OneNote のアクセス許可を追加し、アプリキーを生成する必要があります。(詳細については、「アプリの登録」をご覧ください。)

ASP.NET MVC を使用して OneNote アプリを作成するには、以下を行います。

プロジェクトを作成する
.NET ライブラリに ADAL を追加する
UI を構築する
認証サポートを追加する
OneNote API を呼び出す

キーサンプルファイルの「完全なコード例」は、このチュートリアルの末尾にあります。

Visual Studio でプロジェクトを作成する

Visual Studio で、OneNote-WebApp という名前の ASP.NET Web アプリケーション プロジェクトを作成します。
MVC テンプレートを選択し、以下にフォルダーおよびコア参照を追加 オプションに、MVC が選択されていることを確認します。
認証の変更 を選択し、職場および学校のアカウント を選択します。
[クラウド - 複数の組織] を選択し、開発者のテナントのドメイン名 (たとえば、contoso.onmicrosoft.com) を入力します。

必要に応じて、Microsoft Azure の クラウドにホストする の設定を残しても消去しても構いません。この設定は、このチュートリアルでは必須ではありません。それ以外はすべて既定の設定にしてください。

Visual Studio は Web アプリを Azure に登録しますが、Azure 管理ポータルで、そのアプリの構成を完了する必要があります。

ポータルのテナントディレクトリで、アプリケーション を選択し、OneNote-Web アプリをクリックして、構成ページを開きます。
[キー] セクションで、新しいキーの継続期間を選択します。
他のアプリケーションに対するアクセス許可 セクションで、OneNote アプリケーションを追加し、OneNote ノートブックの表示および変更 代理アクセス許可を追加します。(詳細を見る)
アプリに対する変更を保存し、ポータルを閉じる前に新しいキーのコピーを作成します。あとでそれを使用します。

.NET に ADAL を追加する

このアプリは、Azure AD への認証および承認に Active Directory Authentication Library (ADAL) を使用します。このアプリは、バージョン 2.19.208020213 を使用して作成されました。

Visual Studio で、ツール、NuGet パッケージマネージャー、パッケージマネージャーコンソール の順に選択し、コンソールで次のコマンドを実行します。
```
Install-Package Microsoft.IdentityModel.Clients.ActiveDirectory
```

UI を構築する

このアプリは、HomeController のために、次の 2 つのビューを使用します。Index.cshtml と Page.cshtml です。

Views/Home/Index.cshtml の内容を以下のコードに置き換えます。これにより、親セクションを選択するためのドロップダウンリスト、ページ名を入力するためのテキストボックス、ボタンを追加します。

@model OneNote_WebApp.Models.SectionsViewModel

@{
    ViewBag.Title = "Index";
}

<h2>OneNote ASP.NET MVC web application</h2>

@Html.Label("Choose a section to create the page in.")

@using (Html.BeginForm("CreatePageAsync", "Home", new AjaxOptions { UpdateTargetId = "create-page" }))
{
    <div id="create-page">
        @Html.DropDownListFor(
            m => m.SectionId,
            new SelectList(Model.Sections, "Id", "Name", Model.SectionId))
        @Html.ValidationMessageFor(m => m.SectionId)
        <br />
        <br />
        <table>
            <tr>
                <td>
                    @Html.Label("Enter a name for the new page.")
                    <br />
                    @Html.TextBox("page-name", null, new { @style = "width=80" })
                </td>
            </tr>
        </table>
        <button>Create page</button>
    </div>
}

Views/Home フォルダーで、Page という名前のビューを作成し、次のコードを追加します。このビューでは、新しく作成したページのプロパティが表示されます。

@model OneNote_WebApp.Models.PageViewModel

@{
     ViewBag.Title = "Page";
}

<h2>Page: @Model.Title</h2>

<table>
    <tr>
        <td>@Html.Label("Self link: ")</td>
        <td>@Model.Self</td>
    </tr>
    <tr>
        <td>@Html.Label("Native client link: ")</td>
        <td><a href="@Model.PageLinks.ClientUrl">@Model.PageLinks.ClientUrl</a></td>
    </tr>
    <tr>
        <td>@Html.Label("Web client link: ")</td>
        <td><a href="@Model.PageLinks.WebUrl">@Model.PageLinks.WebUrl</a></td>
    </tr>
</table>

認証サポートを追加する

.NET クライアントライブラリの ADAL は、認証と承認のプロセスを処理します。必要なのは、アプリケーションの ID を提供し、ペアになっている呼び出しを追加することだけです。

ルートの Web.config ファイルで、appSettings ノードに以下のキーと値のペアを追加します。ClientId と AADInstance は、Visual Studio によってすでに追加済みであることにご注意ください。
```
<add key="ida:AppKey" value="ENTER-your-app-key-here" />
<add key="ida:OneNoteResourceId" value="https://onenote.com/" />
```
アプリキー用のプレースホルダー値を以前に作成したキーに置き換えます。
App_Start/Start.Auth.cs で、次の using ステートメントを追加します。
```
using Microsoft.IdentityModel.Clients.ActiveDirectory;
```

Startup クラスのグローバル変数を次のコードに置き換えます。HomeController の GetAuthorizedClient メソッドは、4 つのパブリック変数も使用します。

public static string ClientId = ConfigurationManager.AppSettings["ida:ClientId"];
public static string AppKey = ConfigurationManager.AppSettings["ida:AppKey"];
public static string AADInstance = ConfigurationManager.AppSettings["ida:AADInstance"];
public static string OneNoteResourceId = ConfigurationManager.AppSettings["ida:OneNoteResourceId"];
private string Authority = AADInstance + "common";

ConfigureAuth メソッドで、app.UseOpenIdConnectAuthentication メソッドを次のコードに置き換えます。ADAL は、トークンと他の情報をトークンキャッシュに保存します。(キャッシュされる内容を表示するには、タスクを戻す前にこの行を追加します: var cache = context.TokenCache.ReadItems();)。

app.UseOpenIdConnectAuthentication(
   new OpenIdConnectAuthenticationOptions
   {
       ClientId = ClientId,
       Authority = Authority,
       TokenValidationParameters = new System.IdentityModel.Tokens.TokenValidationParameters
       {
           ValidateIssuer = false
       },
       Notifications = new OpenIdConnectAuthenticationNotifications()
       {
            AuthorizationCodeReceived = (context) =>
            {
                var code = context.Code;
                ClientCredential credential = new ClientCredential(ClientId, AppKey);
                Microsoft.IdentityModel.Clients.ActiveDirectory.AuthenticationContext authContext =
                   new Microsoft.IdentityModel.Clients.ActiveDirectory.AuthenticationContext(Authority);
                AuthenticationResult result = authContext.AcquireTokenByAuthorizationCode(
                    code,
                    new Uri(HttpContext.Current.Request.Url.GetLeftPart(UriPartial.Path)),
                    credential,
                    OneNoteResourceId
                );
                return Task.FromResult(0);
            },
            AuthenticationFailed = (context) =>
            {
                context.HandleResponse();
                if (context.Exception.HResult == -2146233088) //IDX10311: Nonce is null
                {
                    context.OwinContext.Response.Redirect("Home/Index");
                }
                return Task.FromResult(0);
            }
        }
    });

Controllers/HomeController.cs に次の using ステートメントを追加します。

using Microsoft.IdentityModel.Clients.ActiveDirectory;
using Microsoft.Owin.Security;
using Microsoft.Owin.Security.OpenIdConnect;
using Newtonsoft.Json;
using System.IO;
using System.Net.Http;
using System.Net.Http.Headers;
using System.Security.Claims;
using System.Text;
using System.Threading.Tasks;
using OneNote_WebApp.Models;

HomeController クラスで、GetAuthorizedClient メソッドを追加します。このメソッドは、OneNote サービスに REST 要求を行うのに使用される HttpClient を作成し、構成します。このメソッドは、アクセストークンも取得し、それをクライアントに追加します。

private HttpClient GetAuthorizedClient()
{
    HttpClient client = new HttpClient();

    string userObjectId = ClaimsPrincipal.Current.FindFirst("https://schemas.microsoft.com/identity/claims/objectidentifier").Value;
    string tenantId = ClaimsPrincipal.Current.FindFirst("https://schemas.microsoft.com/identity/claims/tenantid").Value;
    ClientCredential credential = new ClientCredential(Startup.ClientId, Startup.AppKey);
    AuthenticationContext authContext = new AuthenticationContext(Startup.AADInstance + tenantId);

    try
    {
        // Call AcquireTokenSilent to get the access token. This first tries to get the token from cache.
        AuthenticationResult authResult = authContext.AcquireTokenSilent(
            Startup.OneNoteResourceId,
            credential,
            new UserIdentifier(userObjectId, UserIdentifierType.UniqueId));
        client.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue("Bearer", authResult.AccessToken);
        client.DefaultRequestHeaders.Accept.Add(new MediaTypeWithQualityHeaderValue("application/json"));
    }
    catch (AdalSilentTokenAcquisitionException)
    {
        HttpContext.GetOwinContext().Authentication.Challenge(
            new AuthenticationProperties() { RedirectUri = "/" },
            OpenIdConnectAuthenticationDefaults.AuthenticationType);
        return null;
    }

    return client;
}

これで、OneNote サービスに呼び出しを行い、応答を解析する準備が整いました。

OneNote API を呼び出す

アプリが読み込まれると、直近に変更された 10 のセクションの名前と ID が取得され、セクション名をドロップダウンリストに表示させます。選択したセクションで、新しい OneNote ページが作成されます。

HomeController クラスで、OneNote のエンドポイントのグローバル変数、新しいページに追加するイメージファイルのパスを追加します。

public static string OneNoteRoot = "https://www.onenote.com/api/v1.0/me/notes/";
public static string SectionsEndpoint = "sections?select=name,id&top=10&orderby=lastModifiedTime%20desc";
public static string PagesEndpoint = "sections/{0}/pages";
public static string PathToImageFile = @"C:\<local-path>\logo.png";

PathToImageFile 変数のプレースホルダーのパスとファイル名を、ローカルの PNG イメージを指すように変更します。

Index メソッドを次のコードに置き換えます。これで、セクションが取得され、Index ビューのために SectionsViewModel が準備され、ビューが読み込まれます。

public async Task<ActionResult> Index()
{
    SectionsViewModel viewModel = new SectionsViewModel();
    try
    {
        viewModel.Sections = await GetSectionsAsync();
    }
    catch (Exception ex)
    {
        return View("Error", new HandleErrorInfo(new Exception(ex.Message), "Home", "GetSectionsAsync"));
    }
    return View(viewModel);
}

GET sections 要求を構築して送信し、応答を解析するために、GetSectionsAsync メソッドを追加します。

[Authorize]
[HttpGet]   
public async Task<IEnumerable<Section>> GetSectionsAsync()
{
    List<Section> sections = new List<Section>();

    HttpClient client = GetAuthorizedClient();
    HttpRequestMessage request = new HttpRequestMessage(HttpMethod.Get, OneNoteRoot + SectionsEndpoint);
    HttpResponseMessage response = await client.SendAsync(request);
    if (response.IsSuccessStatusCode)
    {

        // Parse the JSON response.
        string stringResult = await response.Content.ReadAsStringAsync();
        Dictionary<string, dynamic> result = JsonConvert.DeserializeObject<Dictionary<string, dynamic>>(stringResult);
        foreach (var item in result["value"])
        {
            var current = item.ToObject<Dictionary<string, string>>();
            Section section = new Section
            {
                Name = current["name"],
                Id = current["id"]
            };
            sections.Add(section);
        }
    }
    else
    {
        throw new Exception("Error getting sections: " + response.StatusCode.ToString());
    }
    return sections;
}

POST pages マルチパート要求を構築し送信し、応答を解析するために、CreatePageAsync メソッドを追加します。この要求は、シンプルな HTML ページを作成します。

[Authorize]
[HttpPost]
public async Task<ActionResult> CreatePageAsync()
{
    HttpClient client = GetAuthorizedClient();

    // Get user input.
    string selectedSectionId = Request.Form["SectionId"];
    string pageName = Request.Form["page-name"];
    string pagesEndpoint = string.Format("sections/{0}/pages", selectedSectionId);

    // Define the page content, which includes an uploaded image.
    const string imagePartName = "imageBlock1";
    string iso8601Date = DateTime.Now.ToString("o");
    string pageHtml = "<html>" +
                      "<head>" +
                      "<title>" + pageName + "</title>" +
                      "<meta name=\"created\" content=\"" + iso8601Date + "\" />" +
                      "</head>" +
                      "<body>" +
                      "<h1>This is a page with an image</h1>" +
                      "<img src=\"name:" + imagePartName +
                      "\" alt=\"No mis monos\" width=\"250\" height=\"200\" />" +
                      "</body>" +
                      "</html>";

    HttpResponseMessage response;

    // Build the 'POST pages' request.
    var stream = new FileStream(PathToImageFile, FileMode.Open);
    using (var imageContent = new StreamContent(stream))
    {
        try
        {
            imageContent.Headers.ContentType = new MediaTypeHeaderValue("image/png");
            MultipartFormDataContent pageContent = new MultipartFormDataContent
            {
                {new StringContent(pageHtml, Encoding.UTF8, "text/html"), "Presentation"},
                {imageContent, imagePartName}
            };

            response = await client.PostAsync(OneNoteRoot + pagesEndpoint, pageContent);
            if (!response.IsSuccessStatusCode)
            {
                throw new Exception(response.StatusCode + ": " + response.ReasonPhrase);
            }
            else
            {

                // Parse the JSON response.
                string stringResult = await response.Content.ReadAsStringAsync();
                Dictionary<string, dynamic> pageData = JsonConvert.DeserializeObject<Dictionary<string, dynamic>>(stringResult);
                Dictionary<string, dynamic> linksData = JsonConvert.DeserializeObject<Dictionary<string, dynamic>>(pageData["links"].ToString());
                Links pageLinks = new Links
                {
                    ClientUrl = new Uri(linksData["oneNoteClientUrl"]["href"].ToString()),
                    WebUrl = new Uri(linksData["oneNoteWebUrl"]["href"].ToString())
                };
                PageViewModel pageViewModel = new PageViewModel
                {
                    Title = pageData["title"],
                    Self = new Uri(pageData["self"]),
                    PageLinks = pageLinks
                };
                return View("../home/page", pageViewModel);
            }
        }
        catch (Exception ex)
        {
            return View("Error", new HandleErrorInfo(new Exception(ex.Message), "Home", "CreatePageAsync"));
        }
    }
}

Models フォルダーで、Resource.cs という名前の新しいクラスを追加し、次のコードを使用します。このコードでは、ドメインモデルを定義します。このドメインモデルは、OneNote のセクション、ページ、および、Index ビューまた Page ビューで OneNote データを表すビューモデルを表します。

using System;
using System.Collections.Generic;
using System.IO;

namespace OneNote_WebApp.Models
{

    // Common properties of OneNote entities.
    public class Resource
    {
        public string Id { get; set; }
        public string CreatedBy { get; set; }
        public DateTimeOffset CreatedTime { get; set; }
        public string LastModifiedBy { get; set; }
        public DateTimeOffset LastModifiedTime { get; set; }
        public Uri Self { get; set; }
    }

    // A OneNote section with some key properties. 
    public class Section : Resource
    {
        public bool IsDefault { get; set; }
        public string Name { get; set; }
        public ICollection<Page> Pages { get; set; }
        public Uri PagesUrl { get; set; }
    }

    // A OneNote page with some key properties.
    // This app doesn't use the Page model.
    public class Page : Resource
    {
        public Stream Content { get; set; }
        public Uri ContentUrl { get; set; }
        public Links PageLinks { get; set; }
        public string Title { get; set; }
    }

    // The links that open a OneNote page in the installed client or in OneNote Online.
    public class Links
    {
        public Uri ClientUrl { get; set; }
        public Uri WebUrl { get; set; }
    }

    // The view model used to populate the section drop-down list.
    public class SectionsViewModel
    {
        public string SectionId { get; set; }
        public IEnumerable<Section> Sections { get; set; }
    }

    // The view model used to display properties of the new page.
    public class PageViewModel
    {
        public string Title { get; set; }
        public Uri Self { get; set; }
        public Links PageLinks { get; set; }
    }
}

アプリを作成した後、F5 キー押下によるデバッグでそのアプリを実行できます。

OwinStartupAttribute を含むアセンブリが見つかりませんでした... エラーを受け取った場合、ルートディレクトリの Startup.cs class の using ステートメントの後に、次の属性を追加します ( このエラーの詳細をご覧ください)

[assembly: OwinStartup(typeof(OneNote_WebApp.Startup))]

職場または学校のアカウントを使用してアプリにサインインします。アカウントには、少なくとも 1 つのセクションを含む、少なくとも 1 つのノートブックが必要です。アプリで、ページを作成したいセクションを選択し、Create page を選択します。正常に実行できた場合、アプリには、タイトルとそれ自体、および新しいページのリンクが表示されます。

ASP.NET MVC の完全なコード例

Startup.Auth.cs

using System;
using System.Configuration;
using System.Threading.Tasks;
using System.Web;
using Microsoft.Owin.Security;
using Microsoft.Owin.Security.Cookies;
using Microsoft.Owin.Security.OpenIdConnect;
using Owin;
using Microsoft.IdentityModel.Clients.ActiveDirectory;

namespace OneNote_WebApp
{
    public partial class Startup
    {

        // Properties used for authorization.
        public static string ClientId = ConfigurationManager.AppSettings["ida:ClientId"];
        public static string AppKey = ConfigurationManager.AppSettings["ida:AppKey"];
        public static string AADInstance = ConfigurationManager.AppSettings["ida:AADInstance"];
        public static string OneNoteResourceId = ConfigurationManager.AppSettings["ida:OneNoteResourceId"];
        private string Authority = AADInstance + "common";

        public void ConfigureAuth(IAppBuilder app)
        {
            app.SetDefaultSignInAsAuthenticationType(CookieAuthenticationDefaults.AuthenticationType);

            app.UseCookieAuthentication(new CookieAuthenticationOptions { });

            app.UseOpenIdConnectAuthentication(
                new OpenIdConnectAuthenticationOptions
                {
                    ClientId = ClientId,
                    Authority = Authority,
                    TokenValidationParameters = new System.IdentityModel.Tokens.TokenValidationParameters
                    {
                        ValidateIssuer = false
                    },
                    Notifications = new OpenIdConnectAuthenticationNotifications()
                    {
                        AuthorizationCodeReceived = (context) =>
                        {
                            var code = context.Code;
                            ClientCredential credential = new ClientCredential(ClientId, AppKey);
                            Microsoft.IdentityModel.Clients.ActiveDirectory.AuthenticationContext authContext =
                                new Microsoft.IdentityModel.Clients.ActiveDirectory.AuthenticationContext(Authority);
                            AuthenticationResult result = authContext.AcquireTokenByAuthorizationCode(
                                code,
                                new Uri(HttpContext.Current.Request.Url.GetLeftPart(UriPartial.Path)),
                                credential,
                                OneNoteResourceId
                            );
                            return Task.FromResult(0);
                        },
                        AuthenticationFailed = (context) =>
                        {
                            context.HandleResponse();
                            if (context.Exception.HResult == -2146233088) //IDX10311: Nonce is null
                            {
                                context.OwinContext.Response.Redirect("Home/Index");
                            }
                            return Task.FromResult(0);
                        }
                    }
                });
        }
    }
}

HomeController

using System;
using System.Collections.Generic;
using System.Web.Mvc;
using Microsoft.IdentityModel.Clients.ActiveDirectory;
using Microsoft.Owin.Security;
using Microsoft.Owin.Security.OpenIdConnect;
using Newtonsoft.Json;
using System.IO;
using System.Net.Http;
using System.Net.Http.Headers;
using System.Security.Claims;
using System.Text;
using System.Threading.Tasks;
using OneNote_WebApp.Models;

namespace OneNote_WebApp.Controllers
{
    [Authorize]
    public class HomeController : Controller
    {

        // Route segments to OneNote resource endpoints.
        public static string OneNoteRoot = "https://www.onenote.com/api/v1.0/me/notes/";
        public static string SectionsEndpoint = "sections?select=name,id&top=10&orderby=lastModifiedTime%20desc";
        public static string PagesEndpoint = "sections/{0}/pages";

        // Path to the image file to add to the page. 
        // Change this to point to a local PNG file before running the app.
        public static string PathToImageFile = @"C:\<local-path>\logo.png";

        // Get sections, add them to SectionsViewModel, and load the view. 
        public async Task<ActionResult> Index()
        {
            SectionsViewModel viewModel = new SectionsViewModel();
            try
            {
                viewModel.Sections = await GetSectionsAsync();
            }
            catch (Exception ex)
            {
                return View("Error", new HandleErrorInfo(new Exception(ex.Message), "Home", "GetSectionsAsync"));
            }
            return View(viewModel);
        }

        // Create and configure the HttpClient used for requests to the OneNote API. 
        private HttpClient GetAuthorizedClient()
        {
            HttpClient client = new HttpClient();

            string userObjectId = ClaimsPrincipal.Current.FindFirst("https://schemas.microsoft.com/identity/claims/objectidentifier").Value;
            string tenantId = ClaimsPrincipal.Current.FindFirst("https://schemas.microsoft.com/identity/claims/tenantid").Value;
            ClientCredential credential = new ClientCredential(Startup.ClientId, Startup.AppKey);
            AuthenticationContext authContext = new AuthenticationContext(Startup.AADInstance + tenantId);

            try
            {
                // Call AcquireTokenSilent to get the access token. This first tries to get the token from cache.
                AuthenticationResult authResult = authContext.AcquireTokenSilent(
                    Startup.OneNoteResourceId,
                    credential,
                    new UserIdentifier(userObjectId, UserIdentifierType.UniqueId));
                client.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue("Bearer", authResult.AccessToken);
                client.DefaultRequestHeaders.Accept.Add(new MediaTypeWithQualityHeaderValue("application/json"));
            }
            catch (AdalSilentTokenAcquisitionException)
            {
                HttpContext.GetOwinContext().Authentication.Challenge(
                    new AuthenticationProperties() { RedirectUri = "/" },
                    OpenIdConnectAuthenticationDefaults.AuthenticationType);
                return null;
            }
            return client;
        }

        [Authorize]
        [HttpGet]
        // Build the 'GET sections' request and parse the response. The request gets the 10 most recently modified sections.
        public async Task<IEnumerable<Section>> GetSectionsAsync()
        {
            List<Section> sections = new List<Section>();

            HttpClient client = GetAuthorizedClient();
            HttpRequestMessage request = new HttpRequestMessage(HttpMethod.Get, OneNoteRoot + SectionsEndpoint);
            HttpResponseMessage response = await client.SendAsync(request);
            if (response.IsSuccessStatusCode)
            {

                // Parse the JSON response.
                string stringResult = await response.Content.ReadAsStringAsync();
                Dictionary<string, dynamic> result = JsonConvert.DeserializeObject<Dictionary<string, dynamic>>(stringResult);
                foreach (var item in result["value"])
                {
                    var current = item.ToObject<Dictionary<string, string>>();
                    Section section = new Section
                    {
                        Name = current["name"],
                        Id = current["id"]
                    };
                    sections.Add(section);
                }
            }
            else
            {
                throw new Exception("Error getting sections: " + response.StatusCode.ToString());
            }
            return sections;
        }

        [Authorize]
        [HttpPost]
        // Build the multipart POST request and parse the response. The request creates a page in the selected section.
        public async Task<ActionResult> CreatePageAsync()
        {
            HttpClient client = GetAuthorizedClient();

            // Get user input.
            string selectedSectionId = Request.Form["SectionId"];
            string pageName = Request.Form["page-name"];
            string pagesEndpoint = string.Format("sections/{0}/pages", selectedSectionId);

            // Define the page content, which includes an uploaded image.
            const string imagePartName = "imageBlock1";
            string iso8601Date = DateTime.Now.ToString("o");
            string pageHtml = "<html>" +
                                "<head>" +
                                "<title>" + pageName + "</title>" +
                                "<meta name=\"created\" content=\"" + iso8601Date + "\" />" +
                                "</head>" +
                                "<body>" +
                                "<h1>This is a page with an image</h1>" +
                                "<img src=\"name:" + imagePartName +
                                "\" alt=\"No mis monos\" width=\"250\" height=\"200\" />" +
                                "</body>" +
                                "</html>";

            HttpResponseMessage response;

            // Build the 'POST pages' request.
            var stream = new FileStream(PathToImageFile, FileMode.Open);
            using (var imageContent = new StreamContent(stream))
            {
                try
                {
                    imageContent.Headers.ContentType = new MediaTypeHeaderValue("image/png");
                    MultipartFormDataContent pageContent = new MultipartFormDataContent
                    {
                        {new StringContent(pageHtml, Encoding.UTF8, "text/html"), "Presentation"},
                        {imageContent, imagePartName}
                    };

                    response = await client.PostAsync(OneNoteRoot + pagesEndpoint, pageContent);
                    if (!response.IsSuccessStatusCode)
                    {
                        throw new Exception(response.StatusCode + ": " + response.ReasonPhrase);
                    }
                    else
                    {

                        // Parse the JSON response.
                        string stringResult = await response.Content.ReadAsStringAsync();
                        Dictionary<string, dynamic> pageData = JsonConvert.DeserializeObject<Dictionary<string, dynamic>>(stringResult);
                        Dictionary<string, dynamic> linksData = JsonConvert.DeserializeObject<Dictionary<string, dynamic>>(pageData["links"].ToString());
                        Links pageLinks = new Links
                        {
                            ClientUrl = new Uri(linksData["oneNoteClientUrl"]["href"].ToString()),
                            WebUrl = new Uri(linksData["oneNoteWebUrl"]["href"].ToString())
                        };
                        PageViewModel pageViewModel = new PageViewModel
                        {
                            Title = pageData["title"],
                            Self = new Uri(pageData["self"]),
                            PageLinks = pageLinks
                        };
                        return View("../home/page", pageViewModel);
                    }
                }
                catch (Exception ex)
                {
                    return View("Error", new HandleErrorInfo(new Exception(ex.Message), "Home", "CreatePageAsync"));
                }
            }
        }

        public ActionResult About()
        {
            ViewBag.Message = "Your application description page.";

            return View();
        }

        public ActionResult Contact()
        {
            ViewBag.Message = "Your contact page.";

            return View();
        }
    }
}

手順には、Index.cshtml、Page.cshtml、Resource.cs 全体が示されています。

チュートリアル: OneNote アプリを作成する

iOS 向け OneNote アプリを作成する

前提条件

iOS 向け OneNote アプリを作成するには、以下を行います。

Xcode でプロジェクトを作成する

OneDrive SDK 依存関係を追加する

iOS 9.0 を対象とする Xcode 7 アプリ

UI を構築する

認証サポートを追加する

OneNote API を呼び出す

次の手順

IOS の完全なコード例

AppDelegate.m

ViewController.h

ViewController.m

ASP.NET MVC 向けの OneNote アプリを作成する

前提条件

ASP.NET MVC を使用して OneNote アプリを作成するには、以下を行います。

Visual Studio でプロジェクトを作成する

.NET に ADAL を追加する

UI を構築する

認証サポートを追加する

OneNote API を呼び出す

ASP.NET MVC の完全なコード例

Startup.Auth.cs

HomeController

関連項目

その他のリソース