次の方法で共有

Microsoft To Do API を使用する

  • [アーティクル]

重要

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

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

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

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

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

To Do API エンティティを強調表示したスクリーンショット。スクリーンショットには、左側のタスク リストの一覧、中央の特定のタスク リスト内のタスク、右側のチェックリスト 項目とリンクされたリソース、その他のタスク プロパティが表示されます。

タスク リスト

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

GET /me/todo/lists

タスク

この API セットでは、タスクは 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 リソースには、次のようなものがあります。