channel-Ressourcentyp

Namespace: microsoft.graph

Wichtig

APIs unter der /beta Version in Microsoft Graph können geändert werden. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt. Um festzustellen, ob eine API in Version 1.0 verfügbar ist, verwenden Sie die Versionsauswahl .

Teams bestehen aus Kanälen, die sich aus den Gesprächen mit Ihren Teamkollegen zusammensetzen. Jeder Kanal ist einem bestimmten Thema, einer Abteilung oder einem Projekt gewidmet. Kanäle sind der Ort, an dem die Arbeit tatsächlich erledigt wird: wo Text-, Audio- und Videogespräche stattfinden, die für das gesamte Team zugänglich sind, wo Dateien freigegeben und Registerkarten hinzugefügt werden.

Methoden

Methode	Rückgabetyp	Beschreibung
List channels	channel-Auflistung	Rufen Sie die Liste von Kanälen in diesem Team ab.
Eingehende Kanäle auflisten	channel-Sammlung	Rufen Sie die Liste der Kanäle ab, die mit einem Team geteilt werden.
Auflisten aller Kanäle	channel-Sammlung	Rufen Sie die Liste der Kanäle ab, die entweder in einem Team sind oder mit einem Team geteilt werden (eingehende Kanäle).
Create channel	channel	Erstellen eines neuen Kanals durch Einschließen des Anzeigenamen und der Beschreibung.
Get channel	channel	Lesen von Eigenschaften und Beziehungen des Kanals.
Updatekanal	channel	Aktualisieren der Eigenschaften des Kanals.
Delete channel	Keine	Löschen eines Kanals.
Nachricht-Delta abrufen	chatMessage	Abrufen von inkrementellen Nachrichten in einem Kanal.
Kanalnachrichten auflisten	chatMessage	Abrufen von Nachrichten in einem Kanal.
Alle Kanalnachrichten abrufen	Kanal-Sammlung	Abrufen aller Nachrichten aus allen Kanälen, an denen ein Benutzer beteiligt ist.
Kanalnachricht-Beitrag erstellen	chatMessage	Eine Nachricht an einen Kanal senden.
Antwort auf Kanalnachricht-Beitrag erstellen	chatMessage	Auf eine Nachricht in einem Kanal antworten.
Dateiordner abrufen	driveItem	Ruft die Details des SharePoint-Ordners ab, in dem die Dateien des Kanals gespeichert sind.
Registerkarten auflisten	teamsTab	Auflistung der Registerkarten, die an einen Kanal angeheftet sind.
List channel members	conversationMember-Sammlung	Die Liste von Mitgliedern in einem Kanal abrufen.
Add channel member	conversationMember	Hinzufügen eines Mitglieds zu einem Kanal. Wird nur für Kanäle mit einem membershipType von private oder sharedunterstützt.
Kanalmitglied abrufen	conversationMember-Sammlung	Abrufen eines Mitglieds in einem Kanal.
Rolle eines Kanalmitglieds aktualisieren	conversationMember	Eigenschaften eines Mitglieds des Kanals aktualisieren. Wird nur für Kanäle mit einem membershipType von private oder sharedunterstützt.
Kanalmitglied entfernen	Keine	Mitglied eines Kanals löschen. Wird nur für Kanäle mit einem membershipType von private oder shared unterstützt.
Migration abschließen	Kanal	Entfernt den Migrationsmodus aus dem Kanal und macht den Kanal für Benutzer verfügbar, um Nachrichten zu posten und zu lesen.
Registerkarten im Kanal auflisten	teamsTab	Registerkarten auflisten, die an einen Kanal angeheftet sind.
Registerkarte zu Kanal hinzufügen	teamsTab	Eine Registerkarte einem Kanal hinzufügen (anpinnen).
Registerkarte im Kanal abrufen	teamsTab	Abrufen einer bestimmten Registerkarte, die an einen Kanal angeheftet ist.
Registerkarte im Kanal aktualisieren	teamsTab	Aktualisiert die Eigenschaften einer Registerkarte in einem Kanal.
Registerkarte aus Kanal entfernen	Keine	Eine Registerkarte aus einem Kanal entfernen (loslösen).
E-Mail-Adresse des Bereitstellungskanals	Email-Resultate des Bereitstellungskanals	Bereitstellen einer E-Mail-Adresse für den Kanal.
Entfernen der Kanal E-Mail-Adresse	Keiner	Entfernen der E-Mail-Adresse des Kanals.
Entfernen eines eingehenden Kanals	Keines	Entfernen eines eingehenden Kanals.
Auflisten von Teams, die einen Kanal teilen	sharedWithChannelTeamInfo-Sammlung	Rufen Sie die Liste der Teams ab, die für den angegebenen Kanal freigegeben wurden.
Abrufen der Teamfreigabe eines Kanals	sharedWithChannelTeamInfo	Ruft ein Team ab, das für den angegebenen Kanal freigegeben wurde.
Aufheben der Freigabe des Kanals für das Team	Keines	Heben Sie die Freigabe eines Kanals für ein Team auf.
Liste zulässiger Mitglieder	conversationMember-Sammlung	Rufen Sie die Liste der Teammitglieder ab, die Zugriff auf den freigegebenen Kanal haben.
Überprüfen des Benutzerzugriffs	Boolesch	Überprüfen Sie, ob ein Benutzer Zugriff auf einen freigegebenen Kanal hat oder nicht.

Eigenschaften

Eigenschaft	Typ	Beschreibung
description	Zeichenfolge	Optionale Textbeschreibung für den Kanal.
displayName	Zeichenfolge	Kanalname wie er in Microsoft Teams für den Benutzer angezeigt wird.
id	String	Eindeutiger Bezeichner des Kanals. Schreibgeschützt.
isFavoriteByDefault	Boolean	Gibt an, ob der Kanal automatisch für alle Mitglieder des Teams als „Favorit“ gekennzeichnet werden soll. Kann nur programmgesteuert mit Team erstelleneingestellt werden. Standard: false.
email	String	Die E-Mail-Adresse zum Senden von Nachrichten an den Kanal. Schreibgeschützt.
webUrl	String	Ein Link, der in Microsoft Teams zum Kanal führt. Dies ist die URL, die Sie erhalten, wenn Sie mit der rechten Maustaste in Microsoft Teams auf einen Kanal klicken, und auf die Option zum Abrufen des Links zum Kanal klicken. Diese URL sollte als nicht transparenter Blob behandelt und nicht analysiert werden. Schreibgeschützt.
membershipType	channelMembershipType	Der Kanaltyp. Kann während der Erstellung festgelegt und nicht geändert werden. Mögliche Werte sind: standard, private, unknownFutureValue, shared. Der Standardwert ist standard. Beachten Sie, dass Sie den Prefer: include-unknown-enum-members Anforderungsheader verwenden müssen, um den folgenden Wert in dieser optionierbaren Enumerationabzurufen: shared.
createdDateTime	dateTimeOffset	Schreibgeschützt. Zeitstempel für den Zeitpunkt, an dem der Kanal erstellt wurde.
moderationSettings	channelModerationSettings	Einstellungen zur Konfiguration der Kanalmoderation, um zu steuern, wer neue Beiträge starten und auf Beiträge in diesem Kanal antworten darf.
tenantId	string	Besteht aus der Azure Active Directory-Mandanten-ID.

Instanzenattribute

Instanzenattribute sind Eigenschaften mit speziellem Verhalten. Diese Eigenschaften sind temporär. Sie definieren entweder, wie sich der Dienst verhalten soll, oder geben kurzfristige Eigenschaftswerte an, beispielsweise URLs zum Elementdownload, die ablaufen.

Eigenschaftenname	Typ	Beschreibung
@microsoft.graph.channelCreationMode	Zeichenfolge	Gibt an, dass sich der Kanal im Migrationsstatus befindet und zurzeit zu Migrationszwecken verwendet wird. Akzeptiert wird ein Wert: migration.

Hinweis: channelCreationMode ist eine Aufzählung, die den Wert migration annimmt.

Ein Beispiel für eine POST-Anforderung finden Sie unter Anforderung (Kanal im Migrationszustand erstellen).

Beziehungen

Beziehung	Typ	Beschreibung
messages	chatMessage-Auflistung	Eine Sammlung aller Nachrichten in dem Kanal. Eine Navigationseigenschaft. Lässt Nullwerte zu.
Registerkarten	teamsTab-Auflistung	Eine Auflistung aller Registerkarten im Kanal. Eine Navigationseigenschaft.
members	conversationMember-Sammlung	Eine Sammlung von Mitgliedschafts-Einträgen, die dem Kanal zugeordnet sind.
filesFolder	driveItem	Metadaten für den Ort, wo die Dateien des Kanals gespeichert sind.
operations	teamsAsyncOperation-Auflistung	Die asynchronen Vorgänge, die ausgeführt wurden oder in diesem Team ausgeführt werden.
sharedWithTeams	sharedWithChannelTeamInfo-Sammlung	Eine Sammlung von Teams, mit denen ein Kanal geteilt wird.

JSON-Darstellung

Es folgt eine JSON-Darstellung der Ressource.

{
  "description": "string",
  "displayName": "string",
  "id": "string (identifier)",
  "isFavoriteByDefault": true,
  "email": "string",
  "webUrl": "string",
  "membershipType": "channelMembershipType",
  "createdDateTime": "string (timestamp)",
  "moderationSettings": { "@odata.type": "microsoft.graph.channelModerationSettings" }
}