plannerTask のリソースの種類

名前空間: microsoft.graph

重要

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

Microsoft 365 のPlanner タスクを表します。 Planner タスクはプランに含まれており、プラン内のバケットに割り当てることができます。 各タスク オブジェクトには、タスクに関する詳細情報を含めることができる details オブジェクトがあります。 グループ、プラン、タスク間のリレーションシップの詳細については、「Planner REST API を使用する」を参照してください。

メソッド

メソッド	戻り値の型	説明
タスクを取得する	plannerTask	plannerTask オブジェクトのプロパティとリレーションシップを読み取ります。
タスクを更新する	plannerTask	plannerTask オブジェクトを更新します。
タスクを削除する	なし	plannerTask オブジェクトを削除します。
Get delta	plannerTask コレクション	plannerPlan で新しく作成、更新、または削除された plannerTask オブジェクトを取得するか、リソース コレクション全体の完全な読み取りを実行することなく、サインインユーザーに割り当てます。

プロパティ

プロパティ	種類	説明
activeChecklistItemCount	Int32	値が に false設定されているチェックリスト項目の数。不完全な項目を表します。
appliedCategories	plannerAppliedCategories	タスクが適用されるカテゴリ。 使用可能な値については、「 plannerAppliedCategories リソースの種類 」を参照してください。
assigneePriority	String	リスト ビューでこの種類のアイテムを注文するために使用されるヒント。 詳細については、「Plannerでの注文ヒントの使用」を参照してください。
assignments	plannerAssignments	タスクが割り当てられている一連の担当者。
bucketId	String	タスクが属しているバケット ID。 バケットは、タスクと同じプランに存在する必要があります。 bucketId プロパティの値は 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 です。
creationSource	plannerTaskCreation	タスクの配信元に関する情報。
dueDateTime	DateTimeOffset	タスクの期限となる日付と時刻。 Timestamp 型は、ISO 8601 形式を使用して日付と時刻の情報を表し、常に UTC 時間です。 たとえば、2014 年 1 月 1 日午前 0 時 (UTC) は、2014-01-01T00:00:00Z です。
hasDescription	Boolean	読み取り専用です。 この値は、 true タスクの details オブジェクトに説明がない場合です。 それ以外の場合は 、false。
id	String	読み取り専用。 タスクの一意識別子。 このプロパティの値は 28 文字で、大文字と小文字が区別されます。 書式検証はサービスによって行われます。
isOnMyDay	ブール型	MyDay ビューにこのタスクを表示するかどうかを示すブール値。 true をクリックしてタスクを表示します。 それ以外の場合は 。 false
isOnMyDayLastModifiedDate	Date	読み取り専用です。 MyDay にタスクを追加または削除する日付。
orderHint	String	リスト ビューでこの種類の項目を注文するために使用されるヒント。 詳細については、「Planner n での注文ヒントの使用」を参照してください。
percentComplete	Int32	タスク完了の割合。 に 100設定すると、タスクが完了します。
priority	Int32	タスクの優先順位。 有効な値は、 と 10の間0です。 値が大きいほど、優先度が低いことを示します。 たとえば、 0 優先度が最も高く、 10 優先度が最も低い場合などです。 現在、Plannerでは、値0と1を "緊急" として解釈し34、"重要"、2、 765を "medium"、89および 10 "low" として解釈します。 現在、Plannerは"緊急"、"重要"、3"medium"、5および 9 "low" の値1を設定します。
planId	String	タスクが属している計画 ID。
previewType	String	タスクに表示されるプレビューの種類。 可能な値は、automatic、noPreview、checklist、description、reference です。
recurrence	plannerTaskRecurrence	タスクのアクティブまたは非アクティブな繰り返しを定義します。 null タスクに対して繰り返しが定義されていない場合。
referenceCount	Int32	タスクに上に存在している外部への参照の数。
specifiedCompletionRequirements	plannerTaskCompletionRequirements	plannerTask で指定されたすべての要件を示します。 可能な値は、none、checklistCompletion、unknownFutureValue、formCompletion、approvalCompletion です。 読み取り専用です。 要求ヘッダーを使用して、Prefer: include-unknown-enum-membersこの進化可能な列挙型の次の値を取得する必要があります。 formCompletionapprovalCompletion plannerTaskDetails の plannerTaskCompletionRequirementDetails には、指定された要件の詳細 (存在する場合) があります。
startDateTime	DateTimeOffset	タスクが開始される日時。 Timestamp 型は、ISO 8601 形式を使用して日付と時刻の情報を表し、常に UTC 時間です。 たとえば、2014 年 1 月 1 日午前 0 時 (UTC) は、2014-01-01T00:00:00Z です。
title	String	タスクのタイトル。

plannerTaskCompletionRequirements 値

メンバー	説明
none	要件なし。
checklistCompletion	チェックリスト項目の一部または全部をチェックする必要があります。
unknownFutureValue	進化可能な列挙センチネル値。 使用しないでください。
formCompletion	プランナー タスクを完了するには、フォームの一部またはすべてを送信する必要があります。
approvalCompletion	承認が必要です。

リレーションシップ

リレーションシップ	型	説明
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)",
  "isOnMyDay": "Boolean",
  "isOnMyDayLastModifiedDate": "Date",
  "orderHint": "String",
  "percentComplete": "Int32",
  "planId": "String",
  "previewType": "String",
  "priority": "Int32",
  "recurrence": {"@odata.type": "microsoft.graph.plannerTaskRecurrence"},
  "referenceCount": "Int32",
  "specifiedCompletionRequirements": "String",
  "startDateTime": "String (timestamp)",
  "title": "String"
}