conversationMember-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 einen Benutzer in einem Team , einem Kanal oder einem Chat dar.
Basistyp für die folgenden unterstützten Unterhaltungsmembertypen:
- aadUserConversationMember
- anonymousGuestConversationMember
- azureCommunicationServicesUserConversationMember
- microsoftAccountUserConversationMember
- skypeForBusinessUserConversationMember
- skypeUserConversationMember
Methoden
Methode | Rückgabetyp | Beschreibung |
---|---|---|
Teammitglieder auflisten | conversationMember-Sammlung | Mitgliederliste des Teams abrufen. |
Teammitglied hinzufügen | conversationMember | Neues Mitglied zum Team hinzufügen. |
Teammitglieder in Massen hinzufügen | actionResultPart-Sammlung | Hinzufügen von mehreren Mitgliedern zu dem Team im Rahmen einer einzigen Anforderung. |
Teammitglied abrufen | conversationMember-Sammlung | Mitglied des Teams abrufen. |
Rolle des Teammitglieds aktualisieren | conversationMember | Ändern einer Rolle zu „Besitzer“ oder zurück zu „reguläres Mitglied“. |
Teammitglied entfernen | Keine | Vorhandenes Mitglied aus dem Team entfernen. |
Entfernen von Teammitgliedern in einem Massenvorgang | actionResultPart-Sammlung | Entfernen mehrerer Mitglieder aus einem Team in einer einzigen Anforderung. |
List channel members | conversationMember-Sammlung | Liste aller Mitglieder in einem Kanal abrufen. |
Add channel member | conversationMember | Hinzufügen eines Mitglieds zu einem Kanal. Nur für channel mit membershipType von private unterstützt. |
Kanalmitglied abrufen | conversationMember-Sammlung | Abrufen eines Mitglieds in einem Kanal. |
Rolle eines Kanalmitglieds aktualisieren | conversationMember | Eigenschaften eines Mitglieds des Kanals aktualisieren. Nur für Kanal mit membershipType von private unterstützt. |
Kanalmitglied entfernen | Keine | Mitglied eines Kanals löschen. Wird nur für channelType von private unterstützt. |
Chatmitglieder auflisten | conversationMember-Sammlung | Liste aller Mitglieder in einem Chat abrufen. |
Chatmitglied hinzufügen | Header „Standort“ | Mitglied zum Chat hinzufügen. |
Chatmitglied abrufen | conversationMember | Mitglied in einen Chat abrufen. |
Chatmitglied entfernen | Keine | Mitglied aus einem Chat entfernen. |
Eigenschaften
Eigenschaft | Typ | Beschreibung |
---|---|---|
displayName | Zeichenfolge | Der Anzeigename des Benutzers. |
id | Zeichenfolge | Schreibgeschützt. Eindeutige ID des Benutzers. |
roles | Zeichenfolgenauflistung | Die Rollen für diesen Benutzer. Diese Eigenschaft enthält zusätzliche Qualifizierer nur, wenn sie relevant sind. Wenn der Member z. B. über Berechtigungen verfügtowner , enthält owner die roles-Eigenschaft als einen der Werte. Wenn es sich bei dem Mitglied um einen mandanteninternen Gast handelt, enthält guest die Eigenschaft roles als einen der -Werte. Für ein einfaches Mitglied dürfen keine Werte in der Rollen-Eigenschaft angegeben werden. Einem externen externen Mitglied außerhalb des Mandanten wird die owner Rolle zugewiesen. |
visibleHistoryStartDateTime | DateTimeOffset | Der Zeitstempel gibt an, wie weit zurück der Verlauf einer Unterhaltung mit dem jeweiligen Teilnehmer geteilt wird. Diese Eigenschaft ist nur für Mitglieder eines Chats einstellbar. |
JSON-Darstellung
Die folgende JSON-Darstellung veranschaulicht den Ressourcentyp.
{
"@odata.type": "#microsoft.graph.conversationMember",
"displayName": "String",
"id": "String (identifier)",
"roles": ["String"],
"visibleHistoryStartDateTime": "String (timestamp)"
}