Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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. |
| List channel messages | 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. |
| Alle beibehaltenen Kanalnachrichten abrufen | chatMessage-Auflistung | Abrufen aller beibehaltenen 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 | Ruft eine Liste der Mitglieder in einem Kanal ab, einschließlich direkter Mitglieder von Standard-, privaten und freigegebenen Kanälen. |
| Alle Mitglieder auflisten | conversationMember-Sammlung | Ruft eine Liste aller Mitglieder in einem Kanal ab. |
| Abrufen eines Mitglieds aus der Sammlung "channel allMembers" | conversationMember | Rufen Sie mithilfe der Mitgliedschafts-ID eine einzelne conversationMember (direkt oder indirekt) aus der allMembers-Auflistung ab. |
| 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. |
| Kanal archivieren | Keine | Archiv einen Kanal. |
| Kanalarchivieren aufheben | 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. |
| Starten der Migration | channel | Starten Sie die Migration externer Nachrichten, indem Sie den Migrationsmodus in einem vorhandenen Kanal aktivieren. |
| Migration abschließen | Kanal | Schließen Sie die Migration auf vorhandenen oder neuen Kanälen ab. |
| 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. |
| Planner | ||
| Pläne auflisten | plannerPlan-Sammlung | Rufen Sie eine Liste der plannerPlan-Objekte ab, die sich im Besitz eines freigegebenen Kanals in Teams befinden. |
Eigenschaften
| Eigenschaft | Typ | Beschreibung |
|---|---|---|
| description | Zeichenfolge | Optionale Textbeschreibung für den Kanal. |
| displayName | Zeichenfolge | 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 als empfohlen markiert werden soll, damit alle Mitglieder des Teams in ihrer Kanalliste angezeigt werden.
Hinweis: Alle empfohlenen Kanäle werden automatisch in der Kanalliste für Bildungseinrichtungen und Mitarbeiter in Service und Produktion angezeigt. Die -Eigenschaft kann nur programmgesteuert über die Methode Team erstellen festgelegt werden. Der Standardwert ist false. |
| migrationMode | migrationMode | Gibt an, ob sich ein Kanal im Migrationsmodus befindet. Dieser Wert gilt null für Kanäle, die nie in den Migrationsmodus gewechselt sind. Die möglichen Werte sind: inProgress, completed, unknownFutureValue. |
| String | Die E-Mail-Adresse zum Senden von Nachrichten an den Kanal. Schreibgeschützt. | |
| webUrl | Zeichenfolge | 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. Verwenden Sie den Anforderungsheader Prefer: include-unknown-enum-members , um die folgenden Member in dieser verteilbaren Enumeration abzurufen: shared. |
| layoutType | channelLayoutType | Der Layouttyp des Kanals. Kann während der Erstellung festgelegt und aktualisiert werden. Die möglichen Werte sind: post, chat, unknownFutureValue. Der Standardwert ist post. Kanäle mit post Layout verwenden das herkömmliche Post-Antwort-Unterhaltungsformat, während Kanäle mit chat Layout eine Chat-ähnliche Threadingerfahrung wie Gruppenchats bieten. |
| 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. |
| originalCreatedDateTime | dateTimeOffset | Zeitstempel der ursprünglichen Erstellungszeit für den Kanal. Der Wert ist null , wenn der Kanal nie in den Migrationsmodus gewechselt ist. |
| 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. |
migrationMode-Werte
| Member | Beschreibung |
|---|---|
| inProgress | Der Kanal oder Chat hat den Migrationsmodus aktiviert. |
| Abgeschlossen | Der Kanal oder Chat befindet sich außerhalb des Migrationsmodus. |
| unknownFutureValue | Wert des Sentinelwerts für die vervolvbare Enumeration. Nicht verwenden. |
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:
channelCreationModeist eine Enumeration, die den Wertmigrationannimmt.
Ein Beispiel für eine POST-Anforderung finden Sie unter Anforderung (Kanal im Migrationszustand erstellen).
Beziehungen
| Beziehung | Typ | Beschreibung |
|---|---|---|
| alleMembers | conversationMember-Sammlung | Eine Sammlung von Mitgliedschafts-Einträgen, die dem Kanal zugeordnet sind. Sie umfasst sowohl direkte als auch indirekte Mitglieder von freigegebenen Kanälen. |
| 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. Lässt Nullwerte zu. |
| operations | teamsAsyncOperation-Auflistung | Die asynchronen Vorgänge, die ausgeführt wurden oder in diesem Team ausgeführt werden. |
| planner | teamsChannelPlanner | Selektive Planner-Dienste, die für diesen Kanal verfügbar sind. Derzeit werden nur freigegebene Kanäle unterstützt. Schreibgeschützt. Nullwerte zulassend. |
| sharedWithTeams | sharedWithChannelTeamInfo-Sammlung | Eine Sammlung von Teams, mit denen ein Kanal geteilt wird. |
| Registerkarten | teamsTab-Auflistung | Eine Auflistung aller Registerkarten im Kanal. |
JSON-Darstellung
Die folgende JSON-Darstellung veranschaulicht den Ressourcentyp.
{
"description": "string",
"displayName": "string",
"id": "string (identifier)",
"isFavoriteByDefault": true,
"email": "string",
"webUrl": "string",
"membershipType": "String",
"migrationMode": "String",
"layoutType": "string",
"isArchived": false,
"createdDateTime": "string (timestamp)",
"originalCreatedDateTime": "String (timestamp)",
"moderationSettings": { "@odata.type": "microsoft.graph.channelModerationSettings" }
}