名前空間: microsoft.graph
重要
Microsoft Graph の /beta バージョンの API は変更される可能性があります。 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。 v1.0 で API を使用できるかどうかを確認するには、Version セレクターを使用します。
Microsoft 365 のプランを表します。 グループまたはユーザーがプランを所有しています。 プランには、 plannerTasks のコレクションが含まれています。 プランには、 plannerBuckets のコレクションを含めることもできます。 各計画オブジェクトには details オブジェクトがあり、計画に関する詳細情報が含まれていることがあります。 グループ、計画、タスク間のリレーションシップの詳細については、「Planner」を参照してください。
メソッド
| メソッド | 戻り値の型 | 説明 |
|---|---|---|
| Create | plannerPlan | plannerPlan オブジェクトを作成します。 |
| Get | plannerPlan | plannerPlan オブジェクトのプロパティとリレーションシップを読み取ります。 |
| Update | plannerPlan | plannerPlan オブジェクトを更新します。 |
| Delete | なし | plannerPlan オブジェクトを削除します。 |
| アーカイブプラン | plannerPlan | plannerPlan オブジェクトをアーカイブします。 |
| 計画の整理解除 | plannerPlan | アーカイブされた plannerPlan オブジェクトのアーカイブ解除。 |
| コンテナーに移動する | plannerPlan | plannerPlan オブジェクトをある plannerPlanContainer から別の plannerPlanContainer に移動します。 |
| 計画バケットを一覧表示する | plannerBucket コレクション | plannerBucket オブジェクト コレクションを取得します。 |
| 計画タスクを一覧表示する | plannerTask コレクション | plannerTask オブジェクト コレクションを取得します。 |
| Get delta | plannerPlan コレクション | リソース コレクション全体の完全な読み取りを実行することなく、グループまたは plannerRoster 型コンテナーで新しく作成、更新、または削除された plannerPlan オブジェクトを取得します。 |
| 使用権限を取得する | planUsageRight | 秘密度ラベルの割り当てと要求するユーザーのアクセス許可に基づいて、特定の プラン の使用権限を取得します。 |
プロパティ
| プロパティ | 型 | 説明 |
|---|---|---|
| archivalInfo | plannerArchivalInfo | 読み取り専用です。 Null 許容型。 プランをアーカイブまたはアーカイブ解除したユーザーとその理由に関する情報が含まれます。 |
| コンテナー | plannerPlanContainer | プランのコンテナーを識別します。 すべてのプロパティを指定するか、 URL、 containerId、 および type のみを指定します。 設定後、このプロパティは更新できません。 プランからコンテナーへの移動を使用して、あるコンテナーから別のコンテナーに プランを移動すると、プランが変更されます。 必須です。 |
| contentSensitivityLabelAssignment | contentSensitivityLabelAssignment | プランの秘密度ラベルの割り当て。 組織のポリシーに基づいてプラン コンテンツを分類および保護するために使用されます。 このプロパティは、秘密度ラベルが割り当てられていない場合に null されます。 省略可能。 |
| コンテキスト | plannerPlanContextCollection | 読み取り専用です。 このプランが使用されるその他のユーザー エクスペリエンス。 plannerPlanContext エントリとして表されます。 |
| createdBy | identitySet | 読み取り専用です。 計画を作成したユーザー。 |
| createdDateTime | DateTimeOffset | 読み取り専用。 計画の作成日時。 Timestamp 型は、ISO 8601 形式を使用して日付と時刻の情報を表し、常に UTC 時間です。 たとえば、2014 年 1 月 1 日午前 0 時 (UTC) は、2014-01-01T00:00:00Z です。 |
| creationSource | plannerPlanCreation | プランの配信元に関する情報が含まれます。 |
| id | String | 読み取り専用です。 計画の ID。 28 文字の長さと大文字と小文字が区別されます。 書式検証はサービスによって行われます。 |
| isArchived | Boolean | 読み取り専用です。
trueに設定すると、プランがアーカイブされます。 アーカイブされたプランは読み取り専用です。 |
| title | String | 必須。 計画のタイトル。 |
| sharedWithContainers | plannerSharedWithContainer コレクション | プランが共有されているコンテナーの一覧。 |
| owner (非推奨) | String | 代わりに コンテナー プロパティを使用します。 計画を所有している Group の ID。 設定後、このプロパティは更新できません。 プランのコンテナーがグループでない場合、このプロパティは有効なグループ ID を返しません。 |
リレーションシップ
| リレーションシップ | 型 | 説明 |
|---|---|---|
| buckets | plannerBucket コレクション | 計画に含まれるバケットのコレクション。 読み取り専用です。 Null 許容型。 |
| 詳細 | plannerPlanDetails | プランの詳細。 読み取り専用です。 Null 許容型。 |
| tasks | plannerTask コレクション | 計画に含まれるタスクのコレクション。 読み取り専用です。 Null 許容型。 |
JSON 表記
次の JSON 表現は、リソースの種類を示しています。
{
"archivalInfo": {"@odata.type": "microsoft.graph.plannerArchivalInfo"},
"container": {"@odata.type": "microsoft.graph.plannerPlanContainer"},
"contentSensitivityLabelAssignment": {"@odata.type": "microsoft.graph.contentSensitivityLabelAssignment"},
"contexts": {"@odata.type": "microsoft.graph.plannerPlanContextCollection"},
"createdBy": {"@odata.type": "microsoft.graph.identitySet"},
"createdDateTime": "String (timestamp)",
"creationSource": {"@odata.type": "#microsoft.graph.plannerPlanCreation"},
"id": "String (identifier)",
"isArchived": "Boolean",
"owner": "String",
"sharedWithContainers": [{"@odata.type": "microsoft.graph.plannerSharedWithContainer"}],
"title": "String"
}