channel-Ressourcentypchannel resource type

Namespace: microsoft.graphNamespace: microsoft.graph

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. Um zu ermitteln, ob eine API in v 1.0 verfügbar ist, verwenden Sie die Versions Auswahl.To determine whether an API is available in v1.0, use the Version selector.

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 incremental 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 channel. 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 chatMessage 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.
Dateiordner abrufenGet files folder driveItemdriveItem Ruft die Details des SharePoint-Ordners ab, in dem die Dateien des Kanals gespeichert sind.Retrieves the details of the SharePoint folder where the files for the channel are stored.
Migration abschließenComplete migration channelchannel Entfernt den Migrationsmodus aus dem Kanal und macht den Kanal für die Benutzer verfügbar, um Nachrichten zu posten und zu lesen.Removes thee migration mode from the channel and makes the channel available to users to post and read messages.

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 channel'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.Indicates whether the channel should automatically be marked 'favorite' for all members of the team. Kann nur programmgesteuert mit Team erstelleneingestellt werden.Can only be set programmatically with Create 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 go 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 type 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.
createdDateTimecreatedDateTime dateTimeOffsetdateTimeOffset Schreibgeschützt.Read only. Zeitstempel für den Zeitpunkt, an dem der Kanal erstellt wurde.Timestamp at which the channel was created.

InstanzenattributeInstance attributes

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.Instance attributes are properties with special behaviors. These properties are temporary and either a) define behavior the service should perform or b) provide short-term property values, like a download URL for an item that expires.

EigenschaftennameProperty name TypType BeschreibungDescription
@microsoft.graph.channelCreationMode@microsoft.graph.channelCreationMode Zeichenfolgestring Gibt an, dass sich der Kanal im Migrationszustand befindet und zurzeit für Migrationszwecke verwendet wird.Indicates that the channel is in migration state and is currently being used for migration purposes. Akzeptiert einen Wert: migration.It accepts one value: migration.

Hinweis : channelCreationMode ist eine Aufzählung, die den Wert migration annimmt.Note : channelCreationMode is an enum that takes the value migration.

Ein Beispiel für eine POST-Anforderung finden Sie unter Anforderung (Kanal im Migrationszustand erstellen).For a POST request example, see Request (create channel in migration state).

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.
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.
filesFolderfilesFolder driveItemdriveItem Metadaten für den Ort, wo die Dateien des Kanals gespeichert sind.Metadata for the location where the channel's files are stored.
operationsoperations teamsAsyncOperation-AuflistungteamsAsyncOperation collection Die asynchronen Vorgänge, die ausgeführt wurden oder in diesem Team ausgeführt werden.The async operations that ran or are running on this team.

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",
  "createdDateTime": "string (timestamp)"
}