OneNote API を使用して開発する
この部分には、Microsoft OneNote API を使用する方法に関する記事とコーディングに関する各種ヒントが記されています。
**適用対象:**OneNote service
注意
コンシューマーおよびエンタープライズ OneNote API については、Microsoft の新しいドキュメントサイトをご利用ください。
ここに表示されていないことを行いたい場合は、コミュニティで、遠慮なくその考えを共有してください。「Hello World」アプリケーションをステップ バイ ステップで実行する場合は、OneNote API を初めて使用するセクションのチュートリアルをチェックしてください。
ヒント
方法に関する多くの情報では、各種プラットフォームに関する情報が一緒に示されています。マルチ プラットフォーム アプリを作成している場合に対象コードを並べて簡単に比較できるようにするために、そのようにしてきました。ご使用のプラットフォームが、コード例の示されているもの以外の場合には、お知らせください。その一方で、対話式の REST ドキュメントを確認してください。
準備
以下の方法に関する情報は、この API の使用を開始する前に必要となる可能性がある事柄の詳細を示しています。
OneNote API で使用するクライアント ID を取得する
使用しているアプリを OneNote サービスに対して識別するクライアント ID を取得するために Microsoft アカウントを使用する方法の詳細が記されています。OneNote API で使用するツールおよびライブラリを取得する
この API を素早く簡単にコーディングするために使用してきた不可欠かつ優れたライブラリがリストされています。OneNote API のサンプル アプリケーションを取得する
GitHub でのサンプル アプリへのリンクと説明が記されています。多くの場合、これらを開始点として使用するのがこの API の使用を開始する最も速く簡単な方法です。
不可欠なステップ
方法に関する以下の情報では、ほとんどのアプリで実行する事柄について取り上げています。
OneNote API のユーザーを認証する
Windows Live Connect SDK を使用して、アプリが OneNote データにアクセスするためにユーザーのアクセス権限と結び付ける OAuth トークンの取得方法が示されています。OneNote API を使用して OneNote クライアントを開く
ユーザーの OneNote ノートブック内の特定の場所を指す、この API が返すリンクを使用するためのプラットフォーム固有のコードが提供されています。
実行すると役立つ事柄
以下の方法に関する情報では、OneNote を扱うためにアプリでどのようにこの API を使用するかについて説明されています。
OneNote のコンテンツと構造の取得
OneNote のページ、セクション、セクション グループ、およびノートブックを、OData のクエリ文字列オプションを使用して取得する方法が示されています。簡単なキャプチャを作成する
要求本文で HTML を送信して簡単な OneNote ページを作成する方法が示されています。特定セクション内のページを取り込む
取り込まれたページを配置する名前付きの OneNote ノートブック セクションを指定する方法が示されています。HTML を使用した構造の作成
より複雑なマルチパートの POST 要求と HTML を使用して OneNote ページを作成する方法が示されています。写真およびイメージのキャプチャ
機器からイメージ データを直接送信する必要があるアプリで、POST 要求にイメージ データを直接含める方法が示されています。Web ページ スナップショットのキャプチャ
API により、公開されている Web ページをスナップショット イメージとして表示し、それらのイメージを OneNote ページに保存するようにする方法が示されています。埋め込みファイルのキャプチャ
OneNote において、バイナリ ファイル データをページ上の組み込みファイルとして格納する方法が示されています。PDF ファイルの取り込みと埋め込み
両方の埋め込みファイルとして表示されるように PDF ファイルをインクルードし、PDF ドキュメントのページを画像として表示する方法が示されています。絶対位置の要素を作成
互いに独立してページに配置できる div、イメージ、および添付ファイルを作成する方法が示されています。取り込んだコンテンツの拡張
この API を使用して、名刺、オンライン レシピ、オンラインの製品リストのコンテンツを拡張して表示する方法が示されています。ノート シールの使用
data-tag 属性を使用して OneNote ページにチェック ボックス、星、その他のノート シールを追加したり、それらを更新したりする方法が示されています。ページのコンテンツ更新
PATCH 要求を作成する方法について説明し、サポートされているページの要素とアクションを定義します。OneNote ページの入出力 HTML
OneNote ページを作成するために使用できる入力 HTML の要素、属性、およびプロパティとともに、ページのコンテンツを取得する際に返される出力 HTML が示されています。OneNote API のエラー コードと警告コード
エラーと警告の JSON 応答例が示されていて、エラー コードと警告コードについて説明されています。
開発チームとのコミュニケーション
皆さんのご意見をお聞かせください。同時に、皆さんが内容を理解して、必要な支援が得られるように願っています。以下のサイトにアクセスすれば、理解を深めることができます。
Dev.OneNote.com Web サイトは、この OneNote API 環境への主な入口となります。
OneNote 開発者センターおすすめのアプリで、正常に動作するアプリを紹介しています。
OneNote API ブログには、お知らせ、更新についての情報、およびこの API についての理解を深めたりより多くのことを行えるようにしたりするために役立つ記事が掲載されています。
StackOverflow Q&A には、OneNote API を使用した開発に関係するやり取りが記されています。
API フィードバック サイトでは、API に関するご意見をお聞かせいただくことができます。