名前空間: 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"
}
}