plannerTask のリソースの種類
名前空間: microsoft.graph
Microsoft 365 の Planner タスクを表します。 Planner タスクはプランに含まれており、 プラン 内の バケット に割り当てることができます。 各タスク オブジェクトには、タスクに関する詳細情報を含めることができる details オブジェクトがあります。 グループ、プラン、タスク間のリレーションシップの詳細については、「 Planner REST API を使用する」を参照してください。
メソッド
メソッド | 戻り値の型 | 説明 |
---|---|---|
Create | plannerTask | plannerTask オブジェクトを作成します。 |
Get | plannerTask | plannerTask オブジェクトのプロパティとリレーションシップを読み取ります。 |
Update | plannerTask | plannerTask オブジェクトを更新します。 |
Delete | なし | plannerTask オブジェクトを削除します。 |
プロパティ
プロパティ | 型 | 説明 |
---|---|---|
activeChecklistItemCount | Int32 | チェックリストの項目数。値が false である場合は、不完全な項目があることを示します。 |
appliedCategories | plannerAppliedCategories | タスクが適用されているカテゴリ。 使用可能な値については、「 適用されたカテゴリ 」を参照してください。 |
assigneePriority | String | リスト ビューでこの種類の項目を注文するために使用されるヒント。 この形式は、 ここで説明するように定義されています。 |
assignments | plannerAssignments | タスクが割り当てられている一連の担当者。 |
bucketId | String | タスクが属しているバケット ID。 バケットは、タスクが存在している計画に含まれている必要があります。 28 文字の長さと大文字と小文字が区別されます。 書式検証はサービスによって行われます。 |
checklistItemCount | Int32 | タスクに存在するチェックリストの項目の数です。 |
completedBy | identitySet | タスクを完了したユーザーの ID。 |
CompletedDateTime | DateTimeOffset | 読み取り専用。 タスクの 'percentComplete' が '100' にセットされる日時。 Timestamp 型は、ISO 8601 形式を使用して日付と時刻の情報を表し、常に UTC 時間です。 たとえば、2014 年 1 月 1 日午前 0 時 (UTC) は、2014-01-01T00:00:00Z です。 |
conversationThreadId | String | タスク上の会話のスレッド ID。 これは、グループ内に作成された会話スレッド オブジェクトの ID です。 |
createdBy | identitySet | タスクを作成したユーザーの ID。 |
createdDateTime | DateTimeOffset | 読み取り専用。 タスクが作成された日時。 Timestamp 型は、ISO 8601 形式を使用して日付と時刻の情報を表し、常に UTC 時間です。 たとえば、2014 年 1 月 1 日午前 0 時 (UTC) は、2014-01-01T00:00:00Z です。 |
dueDateTime | DateTimeOffset | タスクが期限切れになる日時。 Timestamp 型は、ISO 8601 形式を使用して日付と時刻の情報を表し、常に UTC 時間です。 たとえば、2014 年 1 月 1 日午前 0 時 (UTC) は、2014-01-01T00:00:00Z です。 |
hasDescription | Boolean | 読み取り専用です。 タスクの details オブジェクトに説明がない場合は値が true され、それ以外の場合は false されます。 |
id | String | 読み取り専用。 タスクの ID。 28 文字の長さと大文字と小文字が区別されます。 書式検証はサービスによって行われます。 |
orderHint | String | リスト ビューでこの種類の項目を注文するために使用されるヒント。 この形式は、 ここで説明するように定義されています。 |
percentComplete | Int32 | タスク完了の割合。
100 に設定すると、タスクは完了と見なされます。 |
planId | String | タスクが属している計画 ID。 |
previewType | String | タスクに表示されるプレビューの種類を設定します。 使用可能な値: automatic 、noPreview 、checklist 、description 、reference 。 |
priority | Int32 | タスクの優先度。 有効な値の範囲は、値が大きくなると優先順位0 10 が低くなります (0 の優先度が最も高く、10 の優先度が最も低くなります)。 現在、Plannerは、値 0 および1 を「緊急」、2 、3 、および4 を「重要」、5 、6 、および7 を「中」と解釈します。 8 、9 、および10 は「低」です。 さらに、Planner は、値 1 を「緊急」、3 を「重要」、5 を「中」、9 を「低」に設定します。 |
referenceCount | Int32 | タスクに上に存在している外部への参照の数。 |
startDateTime | DateTimeOffset | タスクが開始される日時。 Timestamp 型は、ISO 8601 形式を使用して日付と時刻の情報を表し、常に UTC 時間です。 たとえば、2014 年 1 月 1 日午前 0 時 (UTC) は、2014-01-01T00:00:00Z です。 |
title | String | タスクのタイトル。 |
リレーションシップ
リレーションシップ | 型 | 説明 |
---|---|---|
assignedToTaskBoardFormat | plannerAssignedToTaskBoardTaskFormat | 読み取り専用です。 Null 許容型です。 assignedTo でグループ化されたときに、タスク ボード ビューでタスクを正しくレンダリングするために使用されます。 |
bucketTaskBoardFormat | plannerBucketTaskBoardTaskFormat | 読み取り専用です。 Null 許容型。 バケット別にグループ化されたときにタスク ボード ビューでタスクを正しくレンダリングするために使用されます。 |
詳細 | plannerTaskDetails | 読み取り専用です。 Null 許容型。 タスクの詳細。 |
progressTaskBoardFormat | plannerProgressTaskBoardTaskFormat | 読み取り専用です。 Null 許容型です。 進行状況別にグループ化されたときにタスク ボード ビューでタスクを正しくレンダリングするために使用されます。 |
JSON 表記
次の JSON 表現は、リソースの種類を示しています。
{
"activeChecklistItemCount": "Int32",
"appliedCategories": {"@odata.type": "microsoft.graph.plannerAppliedCategories"},
"assigneePriority": "String",
"assignments": {"@odata.type": "microsoft.graph.plannerAssignments"},
"bucketId": "String",
"checklistItemCount": "Int32",
"completedBy": {"@odata.type": "microsoft.graph.identitySet"},
"completedDateTime": "String (timestamp)",
"conversationThreadId": "String",
"createdBy": {"@odata.type": "microsoft.graph.identitySet"},
"createdDateTime": "String (timestamp)",
"dueDateTime": "String (timestamp)",
"hasDescription": "Boolean",
"id": "String (identifier)",
"orderHint": "String",
"percentComplete": "Int32",
"priority": "Int32",
"planId": "String",
"previewType": "String",
"referenceCount": "Int32",
"startDateTime": "String (timestamp)",
"title": "String"
}