channel-Ressourcentypchannel resource type

Wichtig

APIs unter der /beta Version in Microsoft Graph können Änderungen unterworfen werden.APIs under the /beta version in Microsoft Graph are subject to change. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt.Use of these APIs in production applications is not supported.

Teams bestehen aus Kanälen, die sich aus den Gesprächen mit Ihren Teamkollegen zusammensetzen.Teams are made up of channels, which are the conversations you have with your teammates. Jeder Kanal ist einem bestimmten Thema, einer Abteilung oder einem Projekt gewidmet.Each channel is dedicated to a specific topic, department, or project. 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.Channels are where the work actually gets done - where text, audio, and video conversations open to the whole team happen, where files are shared, and where tabs are added.

MethodenMethods

MethodeMethod RückgabetypReturn Type BeschreibungDescription
List channelsList channels channel-Auflistungchannel collection Abrufen der Liste von Kanälen in diesem Team.Get the list of channels in this team.
Create channelCreate channel channelchannel Erstellen eines neuen Kanals durch Einschließen des Anzeigenamen und der Beschreibung.Create a new channel by including the display name and description.
Get channelGet channel channelchannel Lesen von Eigenschaften und Beziehungen des Kanals.Read properties and relationships of the channel.
UpdatekanalUpdate channel channelchannel Aktualisieren der Eigenschaften des Kanals.Update properties of the channel.
Delete channelDelete channel KeineNone Löschen eines Kanals.Delete a channel.
Nachricht-Delta abrufenGet message delta chatMessagechatMessage Abrufen von inkrementellen Nachrichten in einem Kanal.Get messages in a channel
Kanalnachrichten auflistenList channel messages chatMessagechatMessage Abrufen von Nachrichten in einem Kanal.Get messages in a channel
List channel membersList channel members conversationMember-SammlungconversationMember collection Listet die Mitglieder eines Kanals auf.List the members of a channel.
Get channel memberGet channel member conversationMemberconversationMember Abrufen eines Mitglieds eines Kanals.Get a member of a channel.
Add channel memberAdd channel member conversationMemberconversationMember Hinzufügen eines Mitglieds zu einem Kanal.Add a member to a class. Wird nur für channelType von privateunterstützt.Only supported for channelType of private.
Update channel memberUpdate channel member conversationMemberconversationMember Aktualisieren eines Mitglieds eines Kanals.Update a member of a channel. Wird nur für channelType von privateunterstützt.Only supported for channelType of private.
Delete channel memberDelete channel member conversationMemberconversationMember Löschen eines Mitglieds eines Kanals.Delete a member of a channel. Wird nur für channelType von privateunterstützt.Only supported for channelType of private.
Eine chatMessage in einem Kanal erstellenCreate a message in a channel chatMessagechatMessage Eine Nachricht an einen Kanal senden.Send a message to a channel
Antwort auf chatMessage in einem Kanal erstellenCreate chatMessage reply in a channel chatMessagechatMessage Auf eine Nachricht in einem Kanal antworten.Reply to a message in a channel
Registerkarten auflistenList tabs teamsTabteamsTab Auflistung der Registerkarten, die an einen Kanal angeheftet sind.Lists tabs pinned to a channel.
Registerkarte abrufenGet tab teamsTabteamsTab Lesen einer Registerkarte, die an einen Kanal angeheftet ist.Reads a tab pinned to a channel.
Registerkarte hinzufügenAdd tab teamsTabteamsTab Fügt einem Kanal eine Registerkarte hinzu.Adds (pins) a tab to a channel.
Registerkarte entfernenRemove tab KeineNone Entfernt eine Registerkarte aus einem Kanal.Removes (unpins) a tab from a channel.
Registerkarte aktualisierenUpdate tab teamsTabteamsTab Aktualisiert die Eigenschaften der Registerkarte.Updates the tab properties.

EigenschaftenProperties

EigenschaftProperty TypType BeschreibungDescription
descriptiondescription ZeichenfolgeString Optionale Textbeschreibung für den Kanal.Optional textual description for the channel.
displayNamedisplayName ZeichenfolgeString Kanalname wie er in Microsoft Teams für den Benutzer angezeigt wird.Channel name as it will appear to the user in Microsoft Teams.
idid StringString Eindeutiger Bezeichner des Kanals.The channels's unique identifier. Schreibgeschützt.Read-only.
isFavoriteByDefaultisFavoriteByDefault BooleanBoolean Gibt an, ob der Kanal automatisch für alle Mitglieder des Teams als „Favorit“ gekennzeichnet werden soll.Whether the channel should automatically be marked 'favorite' for all members of the team. Standard: false.Default: false.
emailemail StringString Die E-Mail-Adresse zum Senden von Nachrichten an den Kanal.The email address for sending messages to the channel. Schreibgeschützt.Read-only.
webUrlwebUrl StringString Ein Link, der in Microsoft Teams zum Kanal führt.A hyperlink that will navigate to the channel in Microsoft Teams. 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.This is the URL that you get when you right-click a channel in Microsoft Teams and select Get link to channel. Diese URL sollte als nicht transparenter Blob behandelt und nicht analysiert werden.This URL should be treated as an opaque blob, and not parsed. Schreibgeschützt.Read-only.
membershipTypemembershipType channelMembershipTypechannelMembershipType Der Kanaltyp.The ID of the channel. Kann während der Erstellung festgelegt und nicht geändert werden.Can be set during creation and cannot be changed. Standardwert: Standard.Default: standard.

BeziehungenRelationships

BeziehungRelationship TypType BeschreibungDescription
messagesmessages chatMessage-AuflistungchatMessage collection Eine Auflistung aller Nachrichten im Kanal.A collection of all the messages in the channel. Eine Navigationseigenschaft.A navigation property. Nullwerte zulassend.Nullable. Diese API unterstützt derzeit nur das Lesen von Nachrichten, das Schreiben wird aber auch bald unterstützt.Currently this API only supports reading but will eventually support writing messages too.
Registerkartentabs teamsTab-AuflistungteamsTab collection Eine Auflistung aller Registerkarten im Kanal.A collection of all the tabs in the channel. Eine Navigationseigenschaft.A navigation property.
membersmembers conversationMember-SammlungconversationMember collection Eine Sammlung von Mitgliedschafts-Einträgen, die dem Kanal zugeordnet sind.A collection of membership records associated with the channel.

JSON-DarstellungJSON representation

Es folgt eine JSON-Darstellung der Ressource.The following is a JSON representation of the resource.

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