コミュニティ リソースの種類

名前空間: microsoft.graph

重要

Microsoft Graph の /beta バージョンの API は変更される可能性があります。 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。 v1.0 で API を使用できるかどうかを確認するには、Version セレクターを使用します。

共通の関心や目標を共有するユーザーの会話、ファイル、イベント、更新の中心的な場所である 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"
}

関連コンテンツ

• Microsoft Graph API を使用して Viva Engage を操作する
• コミュニティを作成する