Microsoft To Do API を使用する

Microsoft Graph API を使用して、Microsoft To Do クライアント間でタスクに接続するアプリを作成できます。 次のようなタスクを含むさまざまな操作環境を構築します。

• メールや通知などのアプリのワークフローからタスクを作成し、それらを To Do に保存します。 linkedResource エンティティを使用して、アプリに再びリンクして保存します。
• アプリの既存のタスクを To Do に同期して、単一のタスクビューを作成して優先順位や管理性を向上させます。
• To Do タスクをユーザー設定のビジネス アプリケーションで管理します。

API では、委任されたアクセス許可とアプリケーションアクセス許可の両方がサポートされています。

To Do API を開始する前に、リソースと別のリソースとの関係を確認してください。

タスク リスト

todoTaskList は、todoTask リソースの論理的なコンテナーを表します。 現在、タスク リスト内でのみタスクを作成できます。 すべてのタスク リストを取得するには、次の HTTP 要求を行います。

GET /me/todo/lists

タスク

todoTask は、タスクを表します。たとえば、進捗管理されたり完了したりした作業や個人アイテムなどの一部です。 タスク リストからタスクを取得するには、次の HTTP 要求を行います。

GET /me/todo/lists/{todoTaskListId}/tasks

チェックリスト項目

checklistItem は、より大きな todoTask のサブタスクを表します。 ChecklistItem を使用すると、複雑なタスクをより実用的で小さなタスクに分割できます。 タスクから checklistItem を取得するには、次の HTTP 要求を行います。

GET /me/todo/lists/{todoTaskListId}/tasks/{todoTaskId}/checklistItems/{checklistItems}

リンクされたリソース

linkedResource は、タスクに関連付けられている任意のパートナー アプリケーションのアイテムを表します。たとえば、タスクが作成された場所からのメールなどのアイテムです。 この情報を使用して、アプリの関連アイテムに再びリンクを返し保存します。 タスクからリンクされたリソースを取得するには、次の HTTP 要求を行います。

GET /me/todo/lists/{todoTaskListId}/tasks/{todoTaskId}/linkedresources/{linkedResourceId}

デルタ クエリを使用して変更を追跡する

パフォーマンス上の理由から、オブジェクトのローカル キャッシュを保持し、ローカル キャッシュを定期的にサーバーと同期するには、デルタ クエリを使用します。

デルタ クエリをサポートする To Do API リソースには、次のようなものがあります。

• タスク リスト内の todoTask コレクション
• todoTaskList