名前空間: microsoft.graph
重要
Microsoft Graph の /beta バージョンの API は変更される可能性があります。 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。 v1.0 で API を使用できるかどうかを確認するには、Version セレクターを使用します。
Planner V4 タスク。
planId タスクを親 プランにルーティングします。 V3 の plannerTask/plannerTaskDetails 分割とは異なり、V4 タスクには個別の詳細オブジェクトはありません。説明、メモ、チェックリスト、割り当て、およびリンクは、タスクに直接配置されるプロパティとサブコレクションです。
plannerDelta から継承します。
メソッド
| メソッド | 戻り値の種類 | 説明 |
|---|---|---|
| List | task コレクション | タスク オブジェクトとそのプロパティの一覧を取得します。 |
| Create | task | 新しいタスク オブジェクトを作成します。 |
| Get | task | タスク オブジェクトのプロパティと関係を読み取ります。 |
| Update | task | タスク オブジェクトのプロパティを更新します。 |
| Delete | なし | タスク オブジェクトを削除します。 |
| リストのチェックリスト | checklistItemV4 コレクション | checklistItemV4 オブジェクトとそのプロパティの一覧を取得します。 |
| checklistItemV4 の作成 | checklistItemV4 | 新しい checklistItemV4 オブジェクトを作成します。 |
| customFieldValues の一覧表示 | customFieldValue コレクション | customFieldValue オブジェクトとそのプロパティの一覧を取得します。 |
| customFieldValue の作成 | customFieldValue | 新しい customFieldValue オブジェクトを作成します。 |
| リストのリンク | contentLink コレクション | contentLink オブジェクトとそのプロパティのリストを取得します。 |
| コンテンツリンクの作成 | contentLink | 新しい contentLink オブジェクトを作成します。 |
| List messages | plannerChatMessage コレクション | plannerChatMessage オブジェクトとそのプロパティの一覧を取得します。 |
| plannerChatMessage を作成する | plannerChatMessage | 新しい plannerChatMessage オブジェクトを作成します。 |
| userAssignments の一覧表示 | userAssignment コレクション | userAssignment オブジェクトとそのプロパティのリストを取得します。 |
| userAssignment の作成 | userAssignment | 新しい userAssignment オブジェクトを作成します。 |
プロパティ
| プロパティ | 型 | 説明 |
|---|---|---|
| archivalInfo | plannerArchivalInfo | エンティティがアーカイブされているかどうか、アーカイブされた時期に関する情報。 |
| bucketId | String | タスクが属するバケットの ID。 |
| capabilities | taskCapability | エンティティに対して有効になっているオプション機能を示す、サーバーが計算した読み取り専用機能フラグ。 |
| completedBy | identitySet | タスクを完了としてマークしたユーザーの ID。 |
| CompletedDateTime | DateTimeOffset | タスクが完了した日付と時刻。 |
| creationInfo | creationInfo | エンティティの読み取り専用作成メタデータ。 |
| displayName | String | タスクのタイトル。 |
| dueDateTime | dateWithOptionalTime | タスクの期限の日付と時刻 (オプション)。 |
| extensions | extensionFieldCollection | エンティティに設定されたカスタム表示オプション フィールドの値。 $selectをサポートします。 |
| finishDateTime | dateWithOptionalTime | タスクが完了した日付と時刻 (オプション)。 |
| goalIds | String collection | タスクが関連付けられている目標の ID。 |
| hasChat | ブール型 | タスクに関連付けられているチャットがあるかどうかを示します。 |
| hasChildren | ブール型 | タスクにサブタスクがあるかどうかを示します。 |
| id | 文字列 | エンティティの一意識別子。 読み取り専用です。 エンティティから継承 |
| isCritical | ブール型 | タスクの依存関係から計算されたクリティカル パス上にあるかどうかを示します。 |
| lastModifiedBy | identitySet | エンティティを最後に変更したユーザー (またはアプリケーション) の ID。 読み取り専用です。 |
| lastModifiedDateTime | DateTimeOffset | エンティティが最後に変更された日時。 値は ISO 8601 形式で表され、常に UTC 時刻になります。 読み取り専用です。 |
| notes | itemBody | タスクに関するその他の詳細またはメモ。 |
| parentTaskId | 文字列 | 親タスクの ID (このタスクがサブタスクである場合)。 |
| percentComplete | Int32 | タスクの完了率 (0 から 100 の範囲)。 |
| personalView | taskPersonalView | タスクのユーザーごとの個人用ビュー設定 (今日の予定のメンバーシップなど)。 |
| planId | String | タスクを含むプランの ID。 作成後は不変。 |
| planView | taskPlanView | 適用されたカテゴリ ID など、プランを対象とするタスク ビュー設定。 |
| priority | Int32 | タスクの優先度。 サポートされている値の範囲は 0 (緊急) から 10 (低) です。 |
| recurrence | plannerTaskRecurrence | タスクの繰り返しパターン (繰り返される場合)。 |
| startDateTime | dateWithOptionalTime | タスクの開始がスケジュールされている日付と時刻 (オプション)。 |
| status | plannerTaskStatus | タスクの進行状況を示します。 使用可能な値: notStarted、inProgress、completed、blocked、unknownFutureValue。 |
リレーションシップ
| リレーションシップ | 型 | 説明 |
|---|---|---|
| checklist | checklistItemV4 コレクション | タスク上のチェックリスト項目のコレクション。 読み取り専用です。 Null 許容型。 |
| customFieldValues | customFieldValue コレクション | タスクに設定されたカスタム フィールド値のコレクション。 読み取り専用です。 Null 許容型。 |
| リンク | contentLink コレクション | タスクに添付されたコンテンツ リンクのコレクション。 読み取り専用です。 Null 許容型。 |
| messages | plannerChatMessage コレクション | タスクに関連付けられているチャット メッセージのコレクション。 読み取り専用です。 Null 許容型。 |
| userAssignments | userAssignment コレクション | タスクに対するユーザー割り当てのコレクション。 読み取り専用です。 Null 許容型。 |
JSON 表記
次の JSON 表現は、リソースの種類を示しています。
{
"@odata.type": "#microsoft.graph.task",
"id": "String (identifier)",
"displayName": "String",
"planId": "String",
"bucketId": "String",
"goalIds": [
"String"
],
"status": "String",
"priority": "Int32",
"percentComplete": "Int32",
"startDateTime": {
"@odata.type": "microsoft.graph.dateWithOptionalTime"
},
"dueDateTime": {
"@odata.type": "microsoft.graph.dateWithOptionalTime"
},
"finishDateTime": {
"@odata.type": "microsoft.graph.dateWithOptionalTime"
},
"notes": {
"@odata.type": "microsoft.graph.itemBody"
},
"creationInfo": {
"@odata.type": "microsoft.graph.creationInfo"
},
"lastModifiedBy": {
"@odata.type": "microsoft.graph.identitySet"
},
"lastModifiedDateTime": "String (timestamp)",
"completedBy": {
"@odata.type": "microsoft.graph.identitySet"
},
"completedDateTime": "String (timestamp)",
"recurrence": {
"@odata.type": "microsoft.graph.plannerTaskRecurrence"
},
"archivalInfo": {
"@odata.type": "microsoft.graph.plannerArchivalInfo"
},
"planView": {
"@odata.type": "microsoft.graph.taskPlanView"
},
"personalView": {
"@odata.type": "microsoft.graph.taskPersonalView"
},
"parentTaskId": "String",
"hasChildren": "Boolean",
"isCritical": "Boolean",
"hasChat": "Boolean",
"capabilities": {
"@odata.type": "microsoft.graph.taskCapability"
},
"extensions": {
"@odata.type": "microsoft.graph.extensionFieldCollection"
}
}