todoTaskList リソースの種類

[アーティクル]
05/24/2024

名前空間: microsoft.graph

重要

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

1 つ以上の todoTask リソースを含む Microsoft To Do の一覧。

To Do には、フラグ付きメールやタスクなどの組み込みのタスクリストがあり、名前を変更または削除することはできません。ただし、追加のタスクリストを作成することはできます。

このリソースは、

開いている拡張機能としてカスタムプロパティにデータを追加する
差分クエリを使用して増分追加、削除、更新を追跡する。

メソッド

メソッド	戻り値の種類	説明
List task lists	todoTaskList コレクション	ユーザーのメールボックス内のすべての todoTaskList を取得します。
Create task list	todoTaskList	ユーザーのメールボックスに todoTaskList を作成します。
タスクリストを取得する	todoTaskList	指定した todoTaskList のプロパティとリレーションシップを読み取る。
タスクリストを更新する	todoTaskList	指定した todoTaskList の書き込み可能なプロパティを更新します。
タスクリストを削除する	なし	指定した todoTaskList を削除します。
List tasks	todoTask コレクション	指定されたリスト内のすべての todoTask リソースを取得します。
Create task	todoTask	指定したタスクリストに todoTask を作成します。

プロパティ

プロパティ	型	説明
displayName	String	タスクリストの名前。
id	String	ユーザーのメールボックス内で一意のタスクリストの識別子。読み取り専用です。エンティティから継承
isOwner	ブール型	True の場合、ユーザーが指定されたタスクリストの所有者です。
isShared	Boolean	True タスクリストが他のユーザーと共有されている場合
wellknownListName	wellknownListName	指定されたリストが既知のリストの場合は、リスト名を示すプロパティ。使用可能な値: `none`、`defaultList`、`flaggedEmails`、`unknownFutureValue`。

wellknownListName 値

メンバー	説明
none	ユーザーが作成したリスト。
defaultList	組み込みのタスクの一覧。
flaggedEmails	組み込みのフラグ付きメールリスト。この一覧には、フラグが設定されたメールからのタスクが表示されます。
unknownFutureValue	進化可能な列挙センチネル値。使用しないでください。

リレーションシップ

リレーションシップ	型	説明
extensions	extension コレクション	タスクリストに対して定義されている開いている拡張機能のコレクション。 Null 許容型です。
tasks	todoTask コレクション	このタスクの一覧のタスク。読み取り専用です。 Null 許容型。

JSON 表記

次の JSON 表現は、リソースの種類を示しています。

{
  "@odata.type": "#microsoft.graph.todoTaskList",
  "id": "String (identifier)",
  "displayName": "String",
  "isOwner": "Boolean",
  "isShared": "Boolean",
  "wellknownListName": "String"
}

次の方法で共有