channel-Ressourcentyp

  • Artikel

Namespace: microsoft.graph

Wichtig

Die APIs unter der /beta Version in Microsoft Graph können sich ändern. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt. Um festzustellen, ob eine API in v1.0 verfügbar ist, verwenden Sie die Version Selektor.

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.
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.
Abrufen aller beibehaltenen Kanalnachrichten chatMessage-Auflistung Erhalten Sie beibehaltene Nachrichten über alle Kanäle in einem Team.
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.
Archivkanal Keine Archivieren sie einen Kanal.
Kanal zum Aufheben der Archivierung Keine Heben Sie die Archivierung eines Kanals auf.
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 den angegebenen Kanal gemeinsam nutzen.
Abrufen der Teamfreigabe eines Kanals sharedWithChannelTeamInfo Rufen Sie ein Team ab, das den angegebenen Kanal gemeinsam verwendet.
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 String Optionale Textbeschreibung für den Kanal.
displayName String Kanalname, wie er dem Benutzer in Microsoft Teams angezeigt wird. Die maximale Länge beträgt 50 Zeichen.
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 zum Kanal in Microsoft Teams. Diese URL wird angegeben, wenn Sie in Microsoft Teams mit der rechten Maustaste auf einen Kanal klicken und Link zum Kanal abrufen auswählen. 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. Sie müssen den Anforderungsheader Prefer: include-unknown-enum-members verwenden, um den folgenden Wert in dieser verteilbaren Enumeration abzurufen: 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.
Zusammenfassung channelSummary Enthält Zusammenfassungsinformationen zum Kanal, einschließlich der Anzahl von Gästen, Mitgliedern, Besitzern und einem Indikator für Mitglieder aus anderen Mandanten. Die summary-Eigenschaft wird nur zurückgegeben, wenn sie in der $select -Klausel der Get-Kanalmethode angezeigt wird.
tenantId string Die ID des Microsoft Entra Mandanten.
isArchived Boolesch Gibt an, ob der Kanal archiviert wird. Schreibgeschützt.

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. Sie definieren entweder das Verhalten, das der Dienst ausführen soll, oder 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
messages chatMessage-Auflistung Eine Auflistung aller Nachrichten im Kanal. Eine Navigationseigenschaft. Nullwerte zulassend.
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

Die folgende JSON-Darstellung zeigt den Ressourcentyp.

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

Verwandte Inhalte