名前空間: microsoft.graph
重要
Microsoft Graph の /beta バージョンの API は変更される可能性があります。 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。 v1.0 で API を使用できるかどうかを確認するには、Version セレクターを使用します。
注意
baseTask 上に構築された To Do API セットは 2022 年 5 月 31 日に非推奨となり、2022 年 8 月 31 日にデータの返しを停止しました。 代わりに todoTask API を使用してください。
作業や個人用アイテムなど、追跡して完了できるタスクを表す抽象型。
これは、 タスク リソースによって継承される基本型です。
メソッド
| メソッド | 戻り値の種類 | 説明 |
|---|---|---|
| baseTasks の一覧表示 | baseTask コレクション | baseTask オブジェクトとそのプロパティのリストを取得します。 |
| baseTask の作成 | baseTask | 新しい baseTask オブジェクトを作成します。 |
| baseTask を取得 | baseTask | baseTask オブジェクトのプロパティとリレーションシップを読み取ります。 |
| BaseTask の更新 | baseTask | baseTask オブジェクトのプロパティを更新します。 |
| baseTask の削除 | なし | baseTask オブジェクトを削除します。 |
| move | baseTask | メッセージを別のリストに移動します。 |
| 差分 | baseTask コレクション | 指定した一覧で追加、削除、または更新された一連の baseTask オブジェクトを取得します。 |
| checklistItems を一覧表示する | チェックリストアイテム コレクション | checklistItems ナビゲーション プロパティから checklistItem リソースを取得します。 |
| checklistItem を作成する | checklistItem | 新しい checklistItem オブジェクトを作成します。 |
| linkedResources を一覧表示する | コレクションlinkedResource_v2 | linkedResources ナビゲーション プロパティから linkedResource_v2 リソースを取得します。 |
| linkedResource_v2を作成する | linkedResource_v2 | 新しい linkedResource_v2 オブジェクトを作成します。 |
プロパティ
| プロパティ | 型 | 説明 |
|---|---|---|
| textBody | 文字列 | 通常、タスクに関する情報を含むテキスト形式のタスク本文。 |
| bodyLastModifiedDateTime | DateTimeOffset | タスクが最後に変更された日時。 既定では、UTC 時間です。 要求ヘッダーでカスタム タイム ゾーンを使用できます。 プロパティの値は、ISO 8601 形式を使って表され、常に UTC 時間です。 たとえば、2020 年 1 月 1 日の午前 0 時の UTC は、'2020-01-01T00:00:00Z' のようになります。 |
| CompletedDateTime | DateTimeOffset | タスクが完了した日付。 |
| createdDateTime | DateTimeOffset | タスクが作成された日時。 既定では、UTC 時間です。 要求ヘッダーでカスタム タイム ゾーンを使用できます。 プロパティの値は、ISO 8601 形式を使用します。 たとえば、2020 年 1 月 1 日の午前 0 時の UTC は、'2020-01-01T00:00:00Z' のようになります。 |
| displayName | 文字列 | タスクの名前を指定します。 |
| dueDateTime | dateTimeTimeZone | タスクが終了する予定の日時 (指定のタイム ゾーン)。 |
| id | String | タスクの一意識別子。 既定では、タスクがリストから別のリストに移動されても、この値は変更されません。 |
| importance | importance | タスクの重要性。 使用可能な値: low、normal、high。 使用可能な値: low、normal、high。 |
| lastModifiedDateTime | DateTimeOffset | タスクが最後に変更された日時。 既定では、UTC 時間です。 要求ヘッダーでカスタム タイム ゾーンを使用できます。 プロパティの値は、ISO 8601 形式を使って表され、常に UTC 時間です。 たとえば、2020 年 1 月 1 日の午前 0 時の UTC は、'2020-01-01T00:00:00Z' のようになります。 |
| viewpoint | taskViewpoint | reminderDateTime やカテゴリなど、ユーザー個人用のプロパティ。 |
| recurrence | patternedRecurrence | タスクの繰り返しパターン。 |
| startDateTime | dateTimeTimeZone | タスクを開始する日付 (指定のタイム ゾーン)。 |
| status | taskStatus_v2 | タスクの状態または進行状況を示します。 指定できる値は、 notStarted、 inProgress、 completed、unknownFutureValue です。 |
リレーションシップ
| リレーションシップ | 型 | 説明 |
|---|---|---|
| checklistItems | チェックリストアイテム コレクション | より複雑な親タスクにリンクされた小さなサブタスクのコレクション。 |
| extensions | extension コレクション | タスクに定義されているオープン拡張機能のコレクション。 |
| linkedResources | コレクションlinkedResource_v2 | タスクにリンクされたリソースのコレクション。 |
| parentList | baseTaskList | タスクを含むリスト。 |
JSON 表記
次の JSON 表現は、リソースの種類を示しています。
{
"@odata.type": "#microsoft.graph.baseTask",
"textBody": "String",
"createdDateTime": "String (timestamp)",
"lastModifiedDateTime": "String (timestamp)",
"bodyLastModifiedDateTime": "String (timestamp)",
"completedDateTime": "String (timestamp)",
"dueDateTime": {
"@odata.type": "microsoft.graph.dateTimeTimeZone"
},
"startDateTime": {
"@odata.type": "microsoft.graph.dateTimeTimeZone"
},
"importance": "String",
"recurrence": {
"@odata.type": "microsoft.graph.patternedRecurrence"
},
"displayName": "String",
"status": "String",
"viewpoint": {
"@odata.type": "microsoft.graph.taskViewpoint"
},
"id": "String (identifier)"
}