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}
単一値の拡張プロパティ
singleValueExtendedProperty は、todoTask または todoTaskList エンティティに作成できるカスタム データ フィールドを表します。 単一値の拡張プロパティを作成するには、「 singleValueLegacyExtendedProperty の作成」を参照してください。 単一値の拡張プロパティを取得するには、「 Get singleValueLegacyExtendedProperty」を参照してください。
デルタ クエリを使用して変更を追跡する
パフォーマンス上の理由から、オブジェクトのローカル キャッシュを保持し、ローカル キャッシュを定期的にサーバーと同期するには、デルタ クエリを使用します。
デルタ クエリをサポートする To Do API リソースには、次のようなものがあります。
- タスク リスト内の todoTask コレクション
- todoTaskList