Auflisten allerMembers
Namespace: microsoft.graph
Ruft eine Liste aller Mitglieder in einem Kanal ab. Es unterstützt alle Arten von Kanälen. Bei freigegebenen Kanälen sind alle mandanten- und teamübergreifenden Mitglieder in einem Kanal enthalten.
Hinweis
Die vom Server zurückgegebenen Mitgliedschafts-IDs müssen als nicht transparente Zeichenfolgen behandelt werden. Benutzer sollten nicht versuchen, diese Ressourcen-IDs zu analysieren oder annahmen.
Diese API ist in den folgenden nationalen Cloudbereitstellungen verfügbar.
Weltweiter Service | US Government L4 | US Government L5 (DOD) | China, betrieben von 21Vianet |
---|---|---|---|
✅ | ✅ | ✅ | ✅ |
Berechtigungen
Wählen Sie die Berechtigungen aus, die für diese API als am wenigsten privilegiert markiert sind. Verwenden Sie eine höhere Berechtigung oder Berechtigungen nur, wenn Ihre App dies erfordert. Ausführliche Informationen zu delegierten Berechtigungen und Anwendungsberechtigungen finden Sie unter Berechtigungstypen. Weitere Informationen zu diesen Berechtigungen finden Sie in der Berechtigungsreferenz.
Berechtigungstyp | Berechtigungen mit den geringsten Berechtigungen | Berechtigungen mit höheren Berechtigungen |
---|---|---|
Delegiert (Geschäfts-, Schul- oder Unikonto) | ChannelMember.Read.All | ChannelMember.ReadWrite.All |
Delegiert (persönliches Microsoft-Konto) | Nicht unterstützt | Nicht unterstützt |
Anwendung | ChannelMember.Read.Group | ChannelMember.Read.All, ChannelMember.ReadWrite.All |
Hinweis
Die ChannelMember.Read.Group
Berechtigungen und ChannelMember.ReadWrite.Group
verwenden ressourcenspezifische Zustimmung. Derzeit funktionieren diese Berechtigungen nicht für freigegebene Kanäle.
HTTP-Anforderung
GET /teams/{team-id}/channels/{channel-id}/allMembers
Optionale Abfrageparameter
Diese Methode unterstützt die $filter
- und $select
OData-Abfrageparameter , um die Antwort anzupassen.
Anforderungsheader
Kopfzeile | Wert |
---|---|
Authorization | Bearer {token}. Erforderlich. Erfahren Sie mehr über Authentifizierung und Autorisierung. |
Anforderungstext
Geben Sie keinen Anforderungstext für diese Methode an.
Antwort
Im Erfolgsfall erzeugt diese Methode einen 200 OK
Antwortcode sowie eine Auflistung aller conversationMember-Objekte im Antworttext.
Beispiele
Anforderung
Das folgende Beispiel zeigt eine Anfrage.
GET https://graph.microsoft.com/v1.0/teams/2ab9c796-2902-45f8-b712-7c5a63cf41c4/channels/19%3A20bc1df46b1148e9b22539b83bc66809%40thread.skype/allMembers
Antwort
Das folgende Beispiel zeigt die Antwort.
Hinweis: Das hier gezeigte Antwortobjekt kann zur besseren Lesbarkeit gekürzt werden.
HTTP/1.1 200 OK
Content-type: application/json
{
"@odata.context": "https://graph.microsoft.com/v1.0/$metadata#teams('2ab9c796-2902-45f8-b712-7c5a63cf41c4')/channels('19%3A20bc1df46b1148e9b22539b83bc66809%40thread.skype')/allMembers",
"@odata.count": 2,
"value": [
{
"@odata.type": "#microsoft.graph.aadUserConversationMember",
"id": "MmFiOWM3OTYtMjkwMi00NWY4LWI3MTItN2M1YTYzY2Y0MWM0IyNlZWY5Y2IzNi0wNmRlLTQ2OWItODdjZC03MGY0Y2JlMzJkMTQ=",
"roles": [
"Member"
],
"displayName": "Caleb Foster",
"userId": "eef9cb36-06de-469b-87cd-70f4cbe32d14",
"email": "calfos@contoso.com",
"tenantId": "ar8133445-c7e2-418a-8803-0e68d4b88607"
},
{
"@odata.type": "#microsoft.graph.aadUserConversationMember",
"id": "MmFiOWM3OTYtMjkwMi00NWY4LWI3MTItN2M1YTYzY2Y0MWM0IyNiMzI0NmY0NC1jMDkxLTQ2MjctOTZjNi0yNWIxOGZhMmM5MTA=",
"roles": [
"Owner"
],
"displayName": "Eric Solomon",
"userId": "b3246f44-c091-4627-96c6-25b18fa2c910",
"email": "ericsol@contoso.com",
"tenantId": "df81db53-c7e2-418a-8803-0e68d4b88607"
}
]
}