plannerTask のリソースの種類plannerTask resource type

plannerTask リソースは、Office 365 の Planner のタスクを表します。Planner のタスクは plan に格納され、また、タスクは計画の中の bucket に割り当てることができます。各タスクオブジェクトには、タスクについてのより詳細な情報を保持するための details オブジェクトがあります。グループ、プラン、タスクの関係についての詳細は「概要」を参照してください。The plannerTask resource represents a Planner task in Office 365. A Planner task is contained in a plan and can be assigned to a bucket in a plan. Each task object has a details object which can contain more information about the task. See overview for more information regarding relationships between group, plan and task.

メソッドMethods

メソッドMethod 戻り値の型Return Type 説明Description
Get plannerTaskGet plannerTask plannerTaskplannerTask plannerTask オブジェクトのプロパティとリレーションシップを読み取ります。Read properties and relationships of plannerTask object.
UpdateUpdate plannerTaskplannerTask plannerTask オブジェクトを更新します。Update plannerTask object.
DeleteDelete なしNone plannerTask オブジェクトを削除します。Delete plannerTask object.

プロパティProperties

プロパティProperty 型Type 説明Description
activeChecklistItemCountactiveChecklistItemCount Int32Int32 チェックリストの項目数。値が false である場合は、不完全な項目があることを示します。Number of checklist items with value set to false, representing incomplete items.
appliedCategoriesappliedCategories plannerAppliedCategoriesplannerAppliedCategories タスクが適用されているカテゴリ。可能な値については、「適用されるカテゴリ」を参照してください。The categories to which the task has been applied. See applied Categories for possible values.
assigneePriorityassigneePriority StringString リスト ビューでこの種類の項目の順序付けに使用するヒント。形式はここの説明に従って定義されます。Hint used to order items of this type in a list view. The format is defined as outlined here.
assignmentsassignments plannerAssignmentsplannerAssignments タスクが割り当てられている一連の担当者。The set of assignees the task is assigned to.
bucketIdbucketId StringString タスクが属しているバケット ID。Bucket ID to which the task belongs. バケットは、タスクが存在している計画に含まれている必要があります。The bucket needs to be in the plan that the task is in. 28 文字長で、大文字と小文字の区別があります。It is 28 characters long and case-sensitive. 書式検証はサービスによって行われます。Format validation is done on the service.
checklistItemCountchecklistItemCount Int32Int32 タスクに存在するチェックリストの項目の数です。Number of checklist items that are present on the task.
completedBycompletedBy identitySetidentitySet タスクを完了したユーザーの ID。Identity of the user that completed the task.
CompletedDateTimecompletedDateTime DateTimeOffsetDateTimeOffset 読み取り専用。タスクの 'percentComplete' が '100' にセットされる日時。Timestamp 型は、ISO 8601 形式を使用して日付と時刻の情報を表し、必ず UTC 時間です。たとえば、2014 年 1 月 1 日午前 0 時 (UTC) は、次のようになります。'2014-01-01T00:00:00Z'Read-only. Date and time at which the 'percentComplete' of the task is set to '100'. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 would look like this: '2014-01-01T00:00:00Z'
conversationThreadIdconversationThreadId StringString タスク内の会話のスレッド ID。これは、グループ内に作成された会話スレッド オブジェクトの ID です。Thread ID of the conversation on the task. This is the ID of the conversation thread object created in the group.
createdBycreatedBy identitySetidentitySet タスクを作成したユーザーの ID。Identity of the user that created the task.
createdDateTimecreatedDateTime DateTimeOffsetDateTimeOffset 読み取り専用。タスクが作成された日時。Timestamp 型は、ISO 8601 形式を使用して日付と時刻の情報を表し、必ず UTC 時間です。たとえば、2014 年 1 月 1 日午前 0 時 (UTC) は、次のようになります。'2014-01-01T00:00:00Z'Read-only. Date and time at which the task is created. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 would look like this: '2014-01-01T00:00:00Z'
dueDateTimedueDateTime DateTimeOffsetDateTimeOffset タスクが期限切れになる日時。Timestamp 型は、ISO 8601 形式を使用して日付と時刻の情報を表し、必ず UTC 時間です。たとえば、2014 年 1 月 1 日午前 0 時 (UTC) は、次のようになります。'2014-01-01T00:00:00Z'Date and time at which the task is due. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 would look like this: '2014-01-01T00:00:00Z'
hasDescriptionhasDescription BooleanBoolean 読み取り専用。タスクの details オブジェクトが保持する説明が空でない場合、値は true になり、そうでない場合は false になります。Read-only. Value is true if the details object of the task has a non-empty description and false otherwise.
idid StringString 読み取り専用。Read-only. タスクの ID。ID of the task. 28 文字長で、大文字と小文字の区別があります。It is 28 characters long and case-sensitive. 書式検証はサービスによって行われます。Format validation is done on the service.
orderHintorderHint StringString リスト ビューでこの種類の項目の順序付けに使用するヒント。形式はここの説明に従って定義されます。Hint used to order items of this type in a list view. The format is defined as outlined here.
percentCompletepercentComplete Int32Int32 タスクの完了の割合。100 に設定すると、タスクが完了したと見なされます。Percentage of task completion. When set to 100, the task is considered completed.
planIdplanId StringString タスクが属している計画 ID。Plan ID to which the task belongs.
previewTypepreviewType StringString タスクに表示されるプレビューの種類を設定します。This sets the type of preview that shows up on the task. 使用可能な値: automatic、noPreview、checklist、description、reference。The possible values are: automatic, noPreview, checklist, description, reference.
referenceCountreferenceCount Int32Int32 タスクに上に存在している外部への参照の数。Number of external references that exist on the task.
startDateTimestartDateTime DateTimeOffsetDateTimeOffset タスクが開始される日時。Timestamp 型は、ISO 8601 形式を使用して日付と時刻の情報を表し、必ず UTC 時間です。たとえば、2014 年 1 月 1 日午前 0 時 (UTC) は、次のようになります。'2014-01-01T00:00:00Z'Date and time at which the task starts. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 would look like this: '2014-01-01T00:00:00Z'
titletitle StringString タスクのタイトル。Title of the task.

リレーションシップRelationships

リレーションシップRelationship 型Type 説明Description
assignedToTaskBoardFormatassignedToTaskBoardFormat plannerAssignedToTaskBoardTaskFormatplannerAssignedToTaskBoardTaskFormat 読み取り専用。Null 許容型。assignedTo 別にグループ化されるときに、タスク ボード ビューにタスクを正しくレンダリングするために使用されます。Read-only. Nullable. Used to render the task correctly in the task board view when grouped by assignedTo.
bucketTaskBoardFormatbucketTaskBoardFormat plannerBucketTaskBoardTaskFormatplannerBucketTaskBoardTaskFormat 読み取り専用。Null 許容型。バケット別にグループ化されるときに、タスク ボード ビューにタスクを正しくレンダリングするために使用されます。Read-only. Nullable. Used to render the task correctly in the task board view when grouped by bucket.
詳細details plannerTaskDetailsplannerTaskDetails 読み取り専用。Null 許容型。タスクに関する追加の詳細。Read-only. Nullable. Additional details about the task.
progressTaskBoardFormatprogressTaskBoardFormat plannerProgressTaskBoardTaskFormatplannerProgressTaskBoardTaskFormat 読み取り専用。Null 許容型。進捗状態別にグループ化されるときに、タスク ボード ビューにタスクを正しくレンダリングするために使用されます。Read-only. Nullable. Used to render the task correctly in the task board view when grouped by progress.

JSON 表記JSON representation

以下は、リソースの JSON 表記です。Here is a JSON representation of the resource.

{
  "activeChecklistItemCount": 1024,
  "appliedCategories": {"@odata.type": "microsoft.graph.plannerAppliedCategories"},
  "assigneePriority": "String",
  "assignments": {"@odata.type": "microsoft.graph.plannerAssignments"},
  "bucketId": "String",
  "checklistItemCount": 1024,
  "completedBy": {"@odata.type": "microsoft.graph.identitySet"},
  "completedDateTime": "String (timestamp)",
  "conversationThreadId": "String",
  "createdBy": {"@odata.type": "microsoft.graph.identitySet"},
  "createdDateTime": "String (timestamp)",
  "dueDateTime": "String (timestamp)",
  "hasDescription": true,
  "id": "String (identifier)",
  "orderHint": "String",
  "percentComplete": 1024,
  "planId": "String",
  "previewType": "String",
  "referenceCount": 1024,
  "startDateTime": "String (timestamp)",
  "title": "String"
}