Microsoft Graph の基本タスクに基づいて構築された To Do API を使用する (非推奨)

重要

Microsoft Graph の /beta バージョンの API は変更される可能性があります。 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。 v1.0 で API を使用できるかどうかを確認するには、Version セレクターを使用します。

注意

baseTask 上に構築された To Do API セットは、2022 年 5 月 31 日より非推奨となり、2022 年 8 月 31 日にデータの返しを停止します。 todoTask 上に構築された API セットを使用してください。

Microsoft Graph To Do API を使用して、メールボックス内のユーザーのタスクに接続するアプリを作成します。 次のようなタスクを含むさまざまな操作環境を構築します。

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

現在、この API は、サインインしているユーザーから委任されたアクセス許可のみをサポートしています。

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

タスク リスト

この API セットでは、タスク リストはtodoTask リソースの論理コンテナーである todoTaskList によって表されます。 現在、タスク リスト内でのみタスクを作成できます。 リストを指定せずに作成されたタスクは、既定のタスク リストに作成されます。 すべてのタスク リストを取得するには、次の HTTP 要求を行います。

GET /me/tasks/lists

タスク

この API セットでは、タスクは 追跡および完了できる作業項目または個人用項目の一部であるtodoTask リソースによって表されます。 タスク リストからタスクを取得するには、次の HTTP 要求を行います。

GET /me/tasks/lists/{taskListId}/tasks

チェックリスト項目

checklistItem は、より小さな手順で複雑なタスクを分割するのに役立つ項目を表します。 タスクから checklistItem を取得するには、次の HTTP 要求を行います。

GET /me/tasks/lists/{taskListId}/tasks/{taskId}/checklistItems/{checklistItems}

リンクされたリソース

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

GET /me/tasks/lists/{taskListId}/tasks/{taskId}/linkedresources/{linkedResourceId}

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

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

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

• タスク リスト内の baseTask コレクション
• baseTaskList