channel-Ressourcentyp

  • Artikel

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 Rufen Sie die Liste von Kanälen in diesem Team ab.
Eingehende Kanäle auflisten channel-Sammlung Rufen Sie die Liste der eingehenden Kanäle ab (Kanäle, 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.
Abrufen des primären Kanals channel Der allgemeine Kanal für das Team.
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 (eines Kanals, der für ein Team freigegeben wurde) aus einem Team.
Auflisten von Teams, die einen Kanal teilen sharedWithChannelTeamInfo-Sammlung Rufen Sie die Liste der Teams ab, die für einen bestimmten Kanal freigegeben wurden.
Abrufen der Teamfreigabe eines Kanals sharedWithChannelTeamInfo Holen Sie sich ein Team, dem ein angegebener Kanalfreigegeben wurde.
Aufheben der Freigabe des Kanals für das Team Keines Heben Sie die Freigabe eines Kanals für ein Team auf, indem Sie die entsprechende SharedWithChannelTeamInfo-Ressource löschen.
Liste zulässiger Mitglieder conversationMember-Sammlung Rufen Sie die Liste der conversationMembers ab, die auf einen geteilten Kanal zugreifen können.
Überprüfen des Benutzerzugriffs Boolesch Bestimmen Sie, ob ein Benutzer Zugriff auf einen freigegebenen Kanal hat.

Eigenschaften

Eigenschaft Typ Beschreibung
createdDateTime dateTimeOffset Schreibgeschützt. Zeitstempel für den Zeitpunkt, an dem der Kanal erstellt wurde.
description String Optionale Textbeschreibung für den Kanal.
displayName Zeichenfolge Kanalname wie er in Microsoft Teams für den Benutzer angezeigt wird. Die maximale Länge beträgt 50 Zeichen.
email String Die E-Mail-Adresse zum Senden von Nachrichten an den Kanal. Schreibgeschützt.
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.
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.
tenantId string Die ID des Microsoft Entra Mandanten.
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.
Zusammenfassung channelSummary Enthält Zusammenfassungsinformationen zum Kanal, einschließlich der Anzahl von Besitzern, Mitgliedern, Gästen und einem Indikator für Mitglieder anderer Mandanten. Die summary-Eigenschaft wird nur zurückgegeben, wenn sie in der $select -Klausel der Get-Kanalmethode angegeben ist.

channelMembershipType-Werte

Member Beschreibung
standard Channel erbt die Liste der Elemente des übergeordnetes Team.
privat Der Kanal kann Member enthalten, die eine Teilmenge aller Elemente auf dem übergeordnetes Team sind.
unknownFutureValue Wert des Sentinelwerts für die vervolvbare Enumeration. Nicht verwenden.
freigegeben Mitglieder können direkt zum Kanal hinzugefügt werden, ohne sie dem Team hinzuzufügen.

Instanzenattribute

Instanzattribute sind Eigenschaften mit besonderem Verhalten. Diese Eigenschaften sind temporär und definieren entweder a) das Verhalten, das der Dienst ausführen soll, oder b) stellen kurzfristige Eigenschaftswerte bereit, z. B. eine Download-URL für ein Element, das abläuft.

Eigenschaftenname Typ Beschreibung
@microsoft.graph.channelCreationMode Zeichenfolge Gibt an, dass sich der Kanal im Migrationszustand befindet und zurzeit für Migrationszwecke verwendet wird. Akzeptiert einen Wert: migration.

Hinweis: channelCreationMode ist eine Enumeration, die den Wert migrationannimmt.

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

Beziehungen

Beziehung Typ Beschreibung
filesFolder driveItem Metadaten für den Ort, wo die Dateien des Kanals gespeichert sind.
members conversationMember-Sammlung Eine Sammlung von Mitgliedschafts-Einträgen, die dem Kanal zugeordnet sind.
messages chatMessage-Auflistung Eine Auflistung aller Nachrichten im Kanal. Eine Navigationseigenschaft. Nullwerte zulassend.
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.
Registerkarten teamsTab-Auflistung Eine Auflistung aller Registerkarten im Kanal. Eine Navigationseigenschaft.

JSON-Darstellung

Es folgt eine JSON-Darstellung der Ressource.

{
  "createdDateTime": "string (timestamp)",
  "description": "string",
  "displayName": "string",
  "email": "string",
  "id": "string (identifier)",
  "isFavoriteByDefault": true,
  "membershipType": "String",
  "webUrl": "string"
}

Verwandte Inhalte