目標リソースの種類

名前空間: microsoft.graph

重要

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

プラン内の一連のタスクに関連付けられている Planner V4 目標。 status (on-track、at-risk、off-track) が既定で返されます。説明、メトリック、説明の更新には$selectが必要です。

plannerDelta から継承します。

メソッド

メソッド 戻り値の種類 説明
List 目標 コレクション 目標オブジェクトとそのプロパティのリストを取得します。
Create 目標 新しい目標オブジェクトを作成します。
Get 目標 目標オブジェクトのプロパティと関係を読み取ります。
Update 目標 目標オブジェクトのプロパティを更新します。
Delete なし 目標オブジェクトを削除します。
List tasks task コレクション タスク オブジェクトとそのプロパティの一覧を取得します。
タスクの追加 task タスク コレクションに投稿してタスクを追加します。
タスクを削除する なし タスク オブジェクトを削除します。

プロパティ

プロパティ 型 説明
archivalInfo plannerArchivalInfo エンティティがアーカイブされているかどうか、アーカイブされた時期に関する情報。
capabilities goalCapability エンティティに対して有効になっているオプション機能を示す、サーバーが計算した読み取り専用機能フラグ。
createdBy identitySet エンティティを作成したユーザー (またはアプリケーション) の ID。 読み取り専用です。
createdDateTime DateTimeOffset エンティティが作成された日時。 値は ISO 8601 形式で表され、常に UTC 時刻になります。 読み取り専用です。
displayName 文字列 目標のタイトル。
extensions extensionFieldCollection エンティティに設定されたカスタム表示オプション フィールドの値。 $selectをサポートします。
finishDate Date 目標の終了予定日。
id 文字列 エンティティの一意識別子。 読み取り専用です。 エンティティから継承
lastModifiedBy identitySet エンティティを最後に変更したユーザー (またはアプリケーション) の ID。 読み取り専用です。
lastModifiedDateTime DateTimeOffset エンティティが最後に変更された日時。 値は ISO 8601 形式で表され、常に UTC 時刻になります。 読み取り専用です。
notes itemBody 目標に関するその他の詳細またはメモ。
planId String 目標を含むプランの ID。 必須であり、作成後は変更できません。
priority Int32 目標の優先順位。
startDate Date 目標の開始日。
status plannerGoalStatus 目標の進行状況。 使用可能な値: notStarted、onTrack、behind、atRisk、closed、unknownFutureValue。

リレーションシップ

リレーションシップ 型 説明
tasks task コレクション 目標に関連付けられているタスクのコレクション。 読み取り専用です。 Null 許容型。

JSON 表記

次の JSON 表現は、リソースの種類を示しています。

{
  "@odata.type": "#microsoft.graph.goal",
  "id": "String (identifier)",
  "displayName": "String",
  "planId": "String",
  "status": "String",
  "priority": "Int32",
  "startDate": "Date",
  "finishDate": "Date",
  "notes": {
    "@odata.type": "microsoft.graph.itemBody"
  },
  "archivalInfo": {
    "@odata.type": "microsoft.graph.plannerArchivalInfo"
  },
  "createdBy": {
    "@odata.type": "microsoft.graph.identitySet"
  },
  "createdDateTime": "String (timestamp)",
  "lastModifiedBy": {
    "@odata.type": "microsoft.graph.identitySet"
  },
  "lastModifiedDateTime": "String (timestamp)",
  "capabilities": {
    "@odata.type": "microsoft.graph.goalCapability"
  },
  "extensions": {
    "@odata.type": "microsoft.graph.extensionFieldCollection"
  }
}