incomingChannels auflisten
Namespace: microsoft.graph
Rufen Sie die Liste der eingehenden Kanäle ab (Kanäle, die mit einem Team geteilt werden).
Diese API ist in den folgenden nationalen Cloudbereitstellungen verfügbar.
Globaler Dienst | US Government L4 | US Government L5 (DOD) | China, betrieben von 21Vianet |
---|---|---|---|
✅ | ✅ | ✅ | ❌ |
Berechtigungen
Wählen Sie für diese API die Als am wenigsten privilegierten Berechtigungen gekennzeichneten Berechtigungen aus. Verwenden Sie nur dann eine Berechtigung mit höheren Berechtigungen , wenn dies für Ihre App erforderlich ist. 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) | Channel.ReadBasic.All | ChannelSettings.Read.All, ChannelSettings.ReadWrite.All |
Delegiert (persönliches Microsoft-Konto) | Nicht unterstützt | Nicht unterstützt |
Anwendung | Channel.ReadBasic.All | ChannelSettings.Read.All, ChannelSettings.ReadWrite.All |
Hinweis: Diese API unterstützt Administratorberechtigungen. Microsoft Teams-Dienstadministratoren können auf Teams zugreifen, in denen sie kein Mitglied sind.
HTTP-Anforderung
GET /teams/{team-id}/incomingChannels
Optionale Abfrageparameter
Diese Methode unterstützt die $filter
- und $select
OData-Abfrageparameter , um die Antwort anzupassen.
Anforderungsheader
Name | Beschreibung |
---|---|
Authorization | Bearer {token}. Erforderlich. Erfahren Sie mehr über die Authentifizierung und Autorisierung. |
Anforderungstext
Geben Sie keinen Anforderungstext für diese Methode an.
Antwort
Bei erfolgreicher Ausführung gibt die Methode einen Antwortcode 200 OK
und eine Sammlung von Kanal-Objekten im Antworttext zurück. Die Antwort enthält auch die Eigenschaft @odata.id, die verwendet werden kann, um auf den Kanal zuzugreifen und andere Vorgänge für das Kanal-Objekt auszuführen.
Hinweis
Derzeit schlägt das Aufrufen der URL, die von der Eigenschaft @odata.id zurückgegeben wird, für mandantenübergreifende geteilte Kanäle fehl. Sie können dieses Problem beheben, wenn Sie den Teil /tenants/{tenant-id}
aus der URL entfernen, bevor Sie diese API aufrufen. Weitere Informationen finden Sie unter Bei Microsoft Graph bekannte Probleme.
Beispiele
Anforderung
Das folgende Beispiel zeigt eine Anfrage.
GET https://graph.microsoft.com/v1.0/teams/893075dd-2487-4122-925f-022c42e20265/incomingChannels
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
{
"value": [
{
"@odata.id": "https://graph.microsoft.com/v1.0/tenants/b3246f44-b4gb-4627-96c6-25b18fa2c910/teams/893075dd-5678-4122-925f-022c42e20265/channels/19:561fbdbbfca848a484f0a6f00ce9dbbd@thread.tacv2",
"id": "19:561fbdbbfca848a484f0a6f00ce9dbbd@thread.tacv2",
"createdDateTime": "2020-05-27T19:22:25.692Z",
"displayName": "Contoso Sales channel",
"description": "channel created in Contoso to be shared with other teams/tenants.",
"membershipType": "shared",
"tenantId": "b3246f44-b4gb-4627-96c6-25b18fa2c910"
}
]
}