名前空間: microsoft.graph
共通の関心や目標を共有するユーザーの会話、ファイル、イベント、更新の中心となる、Viva Engageのコミュニティを表します。
すべてのコミュニティは Microsoft 365 グループに関連付けられていますが、グループにはコミュニティと同じ ID がありません。 Viva Engageでのコミュニティの管理の詳細については、「Microsoft Graph APIを使用してViva Engageを操作する」を参照してください。
このリソースは、他のプロパティを渡すことができるオープン型です。
エンティティ から継承します。
メソッド
| メソッド | 戻り値の種類 | 説明 | 
|---|---|---|
| List | コミュニティ コレクション | Viva Engage コミュニティ オブジェクトとそのプロパティの一覧を取得します。 | 
| Create | engagementAsyncOperation | Viva Engageで新しいコミュニティを作成します。 | 
| Get | コミュニティ | コミュニティ オブジェクトのプロパティとリレーションシップを読み取ります。 | 
| Update | なし | 既存のViva Engage コミュニティのプロパティを更新します。 | 
| Delete | なし | 接続されている Microsoft 365 グループ、OneNote ノートブック、Planner プランなど、関連するすべての Microsoft 365 コンテンツと共に、Viva Engage コミュニティを削除します。 | 
プロパティ
| プロパティ | 型 | 説明 | 
|---|---|---|
| description | String | コミュニティの説明。 最大長は 1,024 文字です。 | 
| displayName | String | コミュニティの名前。 最大の長さは、255 文字です。 | 
| groupId | String | このコミュニティのメンバーシップを管理する Microsoft 365 グループ の ID。 | 
| id | String | コミュニティの一意識別子。 読み取り専用です。 エンティティから継承 されます。 | 
| プライバシー | communityPrivacy | コミュニティのプライバシー レベルを定義します。 使用可能な値: public、private、unknownFutureValue。 | 
communityPrivacy の値
| メンバー | 説明 | 
|---|---|
| public | テナントのユーザーは、コミュニティに参加して参加できます。 | 
| プライベート | コミュニティ管理者は、参加する前にテナント ユーザーをコミュニティに追加する必要があります。 | 
| unknownFutureValue | 進化可能な列挙センチネル値。 使用しないでください。 | 
リレーションシップ
| リレーションシップ | 型 | 説明 | 
|---|---|---|
| グループ | group | このコミュニティのメンバーシップを管理する Microsoft 365 グループ 。 | 
| owners | user コレクション | コミュニティの管理者。 ユーザー数は 100 人に制限されています。 コミュニティの作成時にこのプロパティが指定されていない場合、呼び出し元のユーザーはコミュニティ所有者として自動的に割り当てられます。 | 
JSON 表記
次の JSON 表現は、リソースの種類を示しています。
{
  "@odata.type": "#microsoft.graph.community",
  "description": "String",
  "displayName": "String",
  "groupId": "String",
  "id": "String (identifier)",
  "privacy": "String"
}