名前空間: microsoft.graph
重要
Microsoft Graph の /beta バージョンの API は変更される可能性があります。 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。 v1.0 で API を使用できるかどうかを確認するには、Version セレクターを使用します。
Planner プラン内の一連のタスクに関連付けられている目標を表します。
サード パーティ製のアプリケーションは、目標を読み取ることはできますが、目標を作成、更新、または削除することはできません。
plannerDelta から継承します。
メソッド
| メソッド | 戻り値の種類 | 説明 |
|---|---|---|
| ゴールを決める | plannerGoal | plannerGoal オブジェクトのプロパティと関係を読み取ります。 |
| 目標を一覧表示する | plannerGoal コレクション | plannerPlan オブジェクトに関連付けられている目標を取得します。 |
プロパティ
| プロパティ | 型 | 説明 |
|---|---|---|
| displayName | String | 必須です。 目標の表示名。 |
| finishDate | Date | Null 許容型。 目標の終了がスケジュールされている日付。 |
| id | String | 読み取り専用です。 目標の一意識別子。 plannerDelta から継承されます。 |
| notes | itemBody | Null 許容型。 目標に関連付けられているメモ。 |
| planId | String | 必須です。 目標を含むプランの ID。 |
| priority | Int32 | 省略可能。 目標の相対的な優先順位。 有効な値の範囲は 0 から 10 です。 既定値は 5 です。 |
| startDate | Date | Null 許容型。 目標の開始がスケジュールされている日付。 |
| status | plannerGoalStatus | 必須です。 目標の現在の状態。 既定値は notStarted です。 使用可能な値: notStarted、onTrack、behind、atRisk、closed、unknownFutureValue。 |
リレーションシップ
| リレーションシップ | 型 | 説明 |
|---|---|---|
| tasks | plannerTask コレクション | 読み取り専用です。 Null 許容型。 目標に関連付けられているタスク。 このリレーションシップでは、直接取得や $expandはサポートされていません。 タスクに関連付けられている目標を特定するには、plannerTask リソースの goalIds プロパティを読み取ります。 |
JSON 表記
次の JSON 表現は、リソースの種類を示しています。
{
"@odata.type": "#microsoft.graph.plannerGoal",
"displayName": "String",
"finishDate": "Date",
"id": "String (identifier)",
"notes": {
"@odata.type": "microsoft.graph.itemBody"
},
"planId": "String",
"priority": "Int32",
"startDate": "Date",
"status": "String"
}