タスク リソースの種類 (非推奨)

  • [アーティクル]

名前空間: microsoft.graph

重要

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

注意

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

追跡および完了できる作業項目や個人用アイテムなどのタスクを表します。 タスクは常に基本タスク リストに含まれます。

このリソースは、次をサポートします。

baseTask から継承します。

メソッド

メソッド 戻り値の種類 説明
List tasks task コレクション タスク オブジェクトとそのプロパティの一覧を取得します。
タスクを取得する task タスク オブジェクトのプロパティとリレーションシップを読み取ります。
タスクを更新する task タスク オブジェクトのプロパティを更新します。
タスクを削除する なし タスク オブジェクトを削除します。
move baseTask メッセージを別のリストに移動します。
list checklistItems checklistItem コレクション checklistItems ナビゲーション プロパティから checklistItem リソースを取得します。
checklistItem を作成する checklistItem 新しい checklistItem オブジェクトを作成します。
linkedResources を一覧表示する コレクションlinkedResource_v2 linkedResources ナビゲーション プロパティからlinkedResource_v2 リソースを取得します。
linkedResource を作成する linkedResource_v2 新しいlinkedResource_v2 オブジェクトを作成します。

プロパティ

プロパティ 型 説明
textbody itemBody 通常、タスクに関する情報を含むテキスト形式のタスク本文。 baseTask から継承されます。
bodyLastModifiedDateTime DateTimeOffset タスクが最後に変更された日時。 既定では、UTC 時間です。 要求ヘッダーでカスタム タイム ゾーンを使用できます。 プロパティの値は、ISO 8601 形式を使って表され、常に UTC 時間です。 たとえば、2020 年 1 月 1 日の午前 0 時 UTC は、'2020-01-01T00:00:00Z' のようになります。 baseTask から継承されます。
CompletedDateTime DateTimeOffset タスクが完了した日付。 baseTask から継承されます。
createdDateTime DateTimeOffset タスクが作成された日時。 既定では、UTC 時間です。 要求ヘッダーでカスタム タイム ゾーンを使用できます。 プロパティの値は、ISO 8601 形式を使用します。 たとえば、2020 年 1 月 1 日の午前 0 時 UTC は、'2020-01-01T00:00:00Z' のようになります。 baseTask から継承されます。
displayName String タスクの名前を指定します。 baseTask から継承されます。
dueDateTime dateTimeTimeZone タスクが終了する予定の日時 (指定のタイム ゾーン)。 baseTask から継承されます。
id String タスクの一意識別子。 既定では、タスクがリスト間で移動された場合、この値は変更されません。 baseTask から継承されます。
importance importance タスクの重要性。 可能な値は low、normal、high です。 baseTask から継承されます。 使用可能な値: low、normal、high。
lastModifiedDateTime DateTimeOffset タスクが最後に変更された日時。 既定では、UTC 時間です。 要求ヘッダーでカスタム タイム ゾーンを使用できます。 プロパティの値は、ISO 8601 形式を使って表され、常に UTC 時間です。 たとえば、2020 年 1 月 1 日の午前 0 時 UTC は、'2020-01-01T00:00:00Z' のようになります。 baseTask から継承されます。
視点 taskViewpoint reminderDateTime やカテゴリなど、ユーザーに個人用のプロパティ。 baseTask から継承されます。
recurrence patternedRecurrence タスクの繰り返しパターン。 baseTask から継承されます。
startDateTime dateTimeTimeZone タスクを開始する日付 (指定のタイム ゾーン)。 baseTask から継承されます。
status taskStatus_v2 タスクの状態または進行状況を示します。 使用可能な値は、 notStarted、 inProgress、、 completedですunknownFutureValue。 baseTask から継承されます。

リレーションシップ

リレーションシップ 型 説明
checklistItems checklistItem コレクション タスクにリンクされている checklistItems のコレクション。 baseTask から継承
extensions extension コレクション タスクに対して定義されている開いている拡張機能のコレクション。 baseTask から継承
linkedResources コレクションlinkedResource_v2 タスクにリンクされているリソースのコレクション。 baseTask から継承
parentList baseTaskList タスクを含むリスト。 baseTask から継承

JSON 表記

リソースの JSON 表記を次に示します。

{
  "@odata.type": "#microsoft.graph.task",
  "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)"
}