名前空間: microsoft.graph
重要
Microsoft Graph の /beta バージョンの API は変更される可能性があります。 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。 v1.0 で API を使用できるかどうかを確認するには、Version セレクターを使用します。
Planner V4 プラン。 プランは、所有する コンテナー (グループ、Teams チャネル、またはユーザー) を通じて検出可能であり、 バケット、 タスク、 目標、 依存関係、およびその他の Planner データが含まれます。 プランは所有するコンテナーがなければ意味がないため、既定では id、displayName、createdBy、createdDateTime、lastModifiedBy、lastModifiedDateTime、archivalInfo/isArchived と共に container が返されます。
plannerDelta から継承します。
メソッド
| メソッド | 戻り値の種類 | 説明 |
|---|---|---|
| List | plan コレクション | プラン オブジェクトとそのプロパティのリストを取得します。 |
| Create | plan | 新しいプラン オブジェクトを作成します。 |
| Get | plan | プラン オブジェクトのプロパティと関係を読み取ります。 |
| Update | plan | プラン オブジェクトのプロパティを更新します。 |
| Delete | なし | プラン オブジェクトを削除します。 |
| List buckets | バケット コレクション | バケット オブジェクトとそのプロパティのリストを取得します。 |
| バケットを作成する | bucket | 新しいバケット オブジェクトを作成します。 |
| リストのコンテキスト | planContextLink コレクション planContextLink コレクション | planContextLink オブジェクトとそのプロパティのリストを取得します。 |
| プランの作成ContextLink | planContextLink | 新しい planContextLink オブジェクトを作成します。 |
| customFieldDefinitions の一覧表示 | customFieldDefinition コレクション | customFieldDefinition オブジェクトとそのプロパティの一覧を取得します。 |
| customFieldDefinition の追加 | customFieldDefinition | customFieldDefinitions コレクションに投稿して、customFieldDefinitions を追加します。 |
| customFieldDefinitions を削除する | なし | customFieldDefinition オブジェクトを削除します。 |
| 依存関係の一覧表示 | 依存関係 コレクション | 依存関係オブジェクトとそのプロパティの一覧を取得します。 |
| 依存関係を追加する | 依存関係 | dependencies コレクションに投稿して、依存関係を追加します。 |
| 依存関係を削除する | なし | 依存関係オブジェクトを削除します。 |
| 目標を一覧表示する | 目標 コレクション | 目標オブジェクトとそのプロパティのリストを取得します。 |
| 目標の追加 | 目標 | 目標コレクションに投稿して目標を追加します。 |
| 目標を削除する | なし | 目標オブジェクトを削除します。 |
| 履歴項目の一覧表示 | historyItem コレクション | historyItem オブジェクトとそのプロパティの一覧を取得します。 |
| 履歴項目の追加 | historyItem | historyItems コレクションに投稿して、historyItems を追加します。 |
| historyItems の削除 | なし | historyItem オブジェクトを削除します。 |
| リストのリンク | contentLink コレクション | contentLink オブジェクトとそのプロパティのリストを取得します。 |
| コンテンツリンクの作成 | contentLink | 新しい contentLink オブジェクトを作成します。 |
| List tasks | task コレクション | タスク オブジェクトとそのプロパティの一覧を取得します。 |
| タスクの追加 | task | タスク コレクションに投稿してタスクを追加します。 |
| タスクを削除する | なし | タスク オブジェクトを削除します。 |
プロパティ
| プロパティ | 型 | 説明 |
|---|---|---|
| archivalInfo | plannerArchivalInfo | エンティティがアーカイブされているかどうか、アーカイブされた時期に関する情報。 |
| calendar | planCalendar | プランの稼働時間カレンダー設定。 |
| capabilities | planCapability | エンティティに対して有効になっているオプション機能を示す、サーバーが計算した読み取り専用機能フラグ。 |
| コンテナー | planContainer | プランを所有するグループ、Teams チャネル、またはユーザーを識別します。 必須であり、作成後は変更できません。 |
| contentSensitivityLabelAssignment | contentSensitivityLabelAssignment | プランに関連付けられているコンテンツに割り当てられた秘密度ラベル。 |
| creationInfo | creationInfo | エンティティの読み取り専用作成メタデータ。 |
| displayName | String | プランのタイトル。 |
| duration | Int32 | プランの期間 (日数)。 |
| extensions | extensionFieldCollection | エンティティに設定されたカスタム表示オプション フィールドの値。 $selectをサポートします。 |
| hasChat | ブール型 | プランに関連付けられているチャットがあるかどうかを示します。 |
| id | 文字列 | エンティティの一意識別子。 読み取り専用です。 エンティティから継承 |
| lastModifiedBy | identitySet | エンティティを最後に変更したユーザー (またはアプリケーション) の ID。 読み取り専用です。 |
| lastModifiedDateTime | DateTimeOffset | エンティティが最後に変更された日時。 値は ISO 8601 形式で表され、常に UTC 時刻になります。 読み取り専用です。 |
| planView | planView | カテゴリ定義を含む、プラン スコープのビュー設定。 |
| sharedWithContainers | plannerSharedWithContainer コレクション | プランが共有されているコンテナー (追加のグループやチャネルなど) のリスト。 |
リレーションシップ
| リレーションシップ | 型 | 説明 |
|---|---|---|
| buckets | バケット コレクション | プラン内のバケットのコレクション。 読み取り専用です。 Null 許容型。 |
| コンテキスト | planContextLink コレクション planContextLink コレクション | プランを表示する場所を記述するコンテキスト リンクのコレクション。 読み取り専用です。 Null 許容型。 |
| customFieldDefinitions | customFieldDefinition コレクション | プラン内のカスタム フィールド定義のコレクション。 読み取り専用です。 Null 許容型。 |
| 依存関係 | 依存関係 コレクション | プラン内の項目間の依存関係のコレクション。 読み取り専用です。 Null 許容型。 |
| 目標 | 目標 コレクション | 計画内の目標のコレクション。 読み取り専用です。 Null 許容型。 |
| historyItems | historyItem コレクション | プランの履歴 (監査) 項目のコレクション。 読み取り専用です。 Null 許容型。 |
| リンク | contentLink コレクション | プランに添付されたコンテンツ リンクのコレクション。 読み取り専用です。 Null 許容型。 |
| tasks | task コレクション | プラン内のタスクのコレクション。 読み取り専用です。 Null 許容型。 |
JSON 表記
次の JSON 表現は、リソースの種類を示しています。
{
"@odata.type": "#microsoft.graph.plan",
"id": "String (identifier)",
"displayName": "String",
"container": {
"@odata.type": "microsoft.graph.planContainer"
},
"calendar": {
"@odata.type": "microsoft.graph.planCalendar"
},
"creationInfo": {
"@odata.type": "microsoft.graph.creationInfo"
},
"lastModifiedBy": {
"@odata.type": "microsoft.graph.identitySet"
},
"lastModifiedDateTime": "String (timestamp)",
"archivalInfo": {
"@odata.type": "microsoft.graph.plannerArchivalInfo"
},
"planView": {
"@odata.type": "microsoft.graph.planView"
},
"contentSensitivityLabelAssignment": {
"@odata.type": "microsoft.graph.contentSensitivityLabelAssignment"
},
"hasChat": "Boolean",
"duration": "Int32",
"sharedWithContainers": [
{
"@odata.type": "microsoft.graph.plannerSharedWithContainer"
}
],
"capabilities": {
"@odata.type": "microsoft.graph.planCapability"
},
"extensions": {
"@odata.type": "microsoft.graph.extensionFieldCollection"
}
}