channel-Ressourcentyp

Namespace: microsoft.graph

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	Abrufen der Liste von Kanälen in diesem Team.
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. 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 privateunterstü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.

Eigenschaften

Eigenschaft	Typ	Beschreibung
description	String	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 Typ des Kanals. Kann während der Erstellung festgelegt und danach nicht mehr geändert werden. Mögliche Werte sind: standard - Kanal erbt die Liste der Mitglieder des übergeordneten Teams; private - Kanal kann Mitglieder enthalten, die eine Teilmenge aller Mitglieder im übergeordneten Team sind.
createdDateTime	dateTimeOffset	Schreibgeschützt. Zeitstempel für den Zeitpunkt, an dem der Kanal erstellt wurde.

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.

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)"
}