Community-Ressourcentyp
Namespace: microsoft.graph
Wichtig
Die APIs unter der /beta Version in Microsoft Graph können sich ändern. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt. Um festzustellen, ob eine API in v1.0 verfügbar ist, verwenden Sie die Version Selektor.
Stellt eine Community in Viva Engage dar, die ein zentraler Ort für Unterhaltungen, Dateien, Ereignisse und Updates für Personen ist, die ein gemeinsames Interesse oder Ziel teilen.
Jede Community ist einer Microsoft 365-Gruppe zugeordnet, aber die Gruppe hat nicht die gleiche ID wie die Community. Weitere Informationen zum Verwalten von Communitys in Viva Engage finden Sie unter Verwenden der Microsoft Graph-API für die Zusammenarbeit mit Viva Engage.
Diese Ressource ist ein offener Typ, mit dem andere Eigenschaften übergeben werden können.
Erbt von entity.
Methoden
| Methode | Rückgabetyp | Beschreibung |
|---|---|---|
| List | Community-Sammlung | Rufen Sie eine Liste der Viva Engage-Communityobjekte und deren Eigenschaften ab. |
| Create | engagementAsyncOperation | Erstellen Sie eine neue Community in Viva Engage. |
| Get | Gemeinschaft | Lesen der Eigenschaften und Beziehungen eines Communityobjekts . |
| Update | Keine | Aktualisieren Sie die Eigenschaften einer vorhandenen Viva Engage-Community. |
| Delete | Keine | Löschen Sie eine Viva Engage-Community zusammen mit allen zugehörigen Microsoft 365-Inhalten, einschließlich der verbundenen Microsoft 365-Gruppe, oneNote-Notizbuch und Planner-Plänen. |
Eigenschaften
| Eigenschaft | Typ | Beschreibung |
|---|---|---|
| description | Zeichenfolge | Die Beschreibung der Community. Die maximale Länge beträgt 1.024 Zeichen. |
| displayName | Zeichenfolge | Der Name der Community. Die maximale Länge ist 255 Zeichen. |
| groupId | Zeichenfolge | Die ID der Microsoft 365-Gruppe , die die Mitgliedschaft dieser Community verwaltet. |
| id | Zeichenfolge | Der eindeutige Bezeichner der Community. Schreibgeschützt. Geerbt von entity. |
| Privatsphäre | communityDatenschutz | Definiert die Datenschutzebene der Community. Die möglichen Werte sind: public, private, unknownFutureValue. |
communityDatenschutzwerte
| Member | Beschreibung |
|---|---|
| Öffentlich | Jeder Benutzer aus dem Mandanten kann der Community beitreten und daran teilnehmen. |
| privat | Ein Communityadministrator muss der Community Mandantenbenutzer hinzufügen, bevor er teilnehmen kann. |
| unknownFutureValue | Wert des Sentinelwerts für die vervolvbare Enumeration. Nicht verwenden. |
Beziehungen
| Beziehung | Typ | Beschreibung |
|---|---|---|
| Gruppe | Gruppe | Die Microsoft 365-Gruppe , die die Mitgliedschaft dieser Community verwaltet. |
| owners | Benutzersammlung | Die Administratoren der Community. Auf 100 Benutzer beschränkt. Wenn diese Eigenschaft beim Erstellen der Community nicht angegeben wird, wird der aufrufende Benutzer automatisch als Communitybesitzer zugewiesen. |
JSON-Darstellung
Die folgende JSON-Darstellung zeigt den Ressourcentyp.
{
"@odata.type": "#microsoft.graph.community",
"description": "String",
"displayName": "String",
"groupId": "String",
"id": "String (identifier)",
"privacy": "String"
}