Partager via


Type de ressource channel

Espace de noms: microsoft.graph

Les équipes sont constituées de canaux qui sont les conversations que vous avez avec vos collègues. Chaque canal est dédié à un sujet, département ou projet spécifiques. Les canaux sont l’endroit où le travail est réellement effectué, où se déroulent les conversation à l’aide de texte, d’audio et de vidéo ouvertes à toute l’équipe, où les fichiers sont partagés et où des onglets sont ajoutés.

Méthodes

Méthode Type renvoyé Description
Répertorier les canaux collection channel Obtenez la liste des canaux d’une équipe.
Répertorier les canaux entrants collection channel Obtenir la liste des canaux entrants (canaux partagés avec une équipe).
Répertorier tous les canaux collection channel Obtenez la liste des canaux dans une équipe ou partagés avec une équipe (canaux entrants).
Créer un canal channel Créer un canal en incluant le nom d’affichage et la description.
Obtenir le canal channel Lit les propriétés et relations de l’objet channel.
Obtenir le canal principal channel Canal général de l’équipe.
Mettre à jour le canal channel Mettre à jour les propriétés du canal.
Supprimer un canal Aucun Supprimer un canal.
Obtenir la fonction message delta chatMessage Recevez des messages incrémentiels dans un canal.
Lister les messages du canal chatMessage Récupérer les messages d’un canal
Ajout de l’API de recherche de tous les messages de canal collection channel Obtenir tous les messages de tous les canaux auxquels un utilisateur participe.
Créer une publication de message de canal chatMessage Envoyer un message à un canal.
Créer une réponse à une publication de message de canal chatMessage Répondre à un message dans un canal.
Récupérer le dossier de fichiers driveItem Récupère les détails du dossier SharePoint dans lequel sont stockés les fichiers pour le canal.
Répertorier les onglets teamsTab Répertorie les onglets épinglé à un canal.
Lister les membres du canal Collection conversationMember Obtenir la liste des membres d’un canal.
Ajouter un membre au canal conversationMember Ajouter un membre à un canal. Uniquement pris en charge pour les canaux avec un membershipType de private ou shared.
Récupérer un membre du canal Collection conversationMember Récupérer un membre d’un canal.
Canal d’archivage Aucun Archiver un canal dans une équipe.
Canal d’annulation de l’archivage Aucun Restaurer un canal archivé dans une équipe.
Mise à jour du rôle d’un membre de canal conversationMember Mise à jour des propriétés d’un membre de canal. Uniquement pris en charge pour les canaux avec un membershipType de private ou shared.
Supprimer un membre d’un canal Aucune Supprimer un membre d’un canal. Uniquement pris en charge pour les canaux avec un membershipType de private ou shared.
Finaliser la migration canal Supprime le mode migration du canal, puis met le canal à la disposition des utilisateurs pour leur permettre de publier et de lire les messages.
Répertorier des onglets dans un canal teamsTab Répertorier les onglets épinglés à un canal.
Ajouter l’onglet au canal teamsTab Ajouter (épingler) un onglet à un canal.
Obtenir un onglet dans un canal teamsTab Obtenir un onglet spécifique épinglé à un canal.
Mettre à jour un onglet dans le canal teamsTab Met à jour les propriétés d’un onglet dans un canal.
Supprimer un onglet du canal Aucune Supprimer (désépingler) un onglet d’un canal.
Provisionner l’adresse e-mail du canal provisionChannelEmailResult Approvisionnement d’une adresse de messagerie pour le canal.
Supprimer l’adresse e-mail du canal Aucun Supprimez l’adresse e-mail du canal.
Supprimer un canal entrant Aucun Supprimez un canal entrant ( canal partagé avec une équipe) d’une équipe.
Répertorier les équipes partageant un canal Collection sharedWithChannelTeamInfo Obtenez la liste des équipes qui ont été partagées sur le canalspécifié.
Obtenir le partage d’équipe d’un canal sharedWithChannelTeamInfo Obtenez une équipe à qui a été partagé un canal spécifié.
Annuler le partage du canal avec l’équipe Aucun Annule le partage d'un canal avec une équipe en supprimant la ressource sharedWithChannelTeamInfo correspondante..
Répertorier les membres autorisés Collection conversationMember Obtenez la liste des conversationMembers qui peuvent accéder à un canal partagé.
Vérifier l’accès des utilisateurs Boolean Déterminez si un utilisateur a accès à un canal partagé.

Propriétés

Propriété Type Description
createdDateTime dateTimeOffset En lecture seule. Horodateur auquel le canal a été créé.
description Chaîne Description textuelle facultative pour le canal.
displayName Chaîne Le nom du canal tel qu’il apparaîtra à l’utilisateur dans Microsoft Teams. La longueur maximale est de 50 caractères.
email Chaîne L’adresse de messagerie pour l’envoi de messages au canal. En lecture seule.
id Chaîne Identificateur unique du canal. En lecture seule.
isArchived Boolean Indique si le canal est archivé. En lecture seule.
isFavoriteByDefault Valeur booléenne Indique si le canal doit être marqué comme recommandé pour que tous les membres de l’équipe s’affichent dans leur liste de canaux. Note: Tous les canaux recommandés s’affichent automatiquement dans la liste des canaux pour les utilisateurs de l’éducation et des employés de première ligne. La propriété ne peut être définie que par programmation via la méthode Create team . La valeur par défaut est false.
membershipType channelMembershipType Type du canal. Peut être défini lors de la création et ne peut pas être modifié. Les valeurs possibles sont : standard, private, unknownFutureValue, shared. La valeur par défaut est standard. Notez que vous devez utiliser l’en-tête de requête Prefer: include-unknown-enum-members pour obtenir la valeur suivante dans cette evolvable enum : shared.
tenantId chaîne ID du locataire Microsoft Entra.
webUrl String Un lien hypertexte qui vous redirige vers le canal dans Microsoft Teams. Il s’agit de l’URL que vous obtenez quand vous cliquez sur un canal dans le client Microsoft Teams et sélectionnez Récupérer le lien du canal. Cette URL doit être traitée comme un blob opaque et ne doit pas être analysée. En lecture seule.
résumé channelSummary Contient des informations récapitulatives sur le canal, notamment le nombre de propriétaires, de membres, d’invités et un indicateur pour les membres d’autres locataires. La propriété summary est retournée uniquement si elle est spécifiée dans la $select clause de la méthode de canal Get .

Valeurs channelMembershipType

Member Description
standard Channel hérite de la liste des membres de l’équipe parente.
privé Le canal peut avoir des membres qui sont un sous-ensemble de tous les membres de l’équipe parente.
unknownFutureValue Valeur sentinel de l’énumération évolutive. Ne pas utiliser.
partagé Les membres peuvent être ajoutés directement au canal sans les ajouter à l’équipe.

Attributs d’instance

Les attributs d’instance sont des propriétés avec des comportements spéciaux. Ces propriétés sont provisoires et, a) définissent le comportement que le service doit adopter, ou b) fournissent des valeurs à court terme, comme une URL de téléchargement pour un élément qui arrive à expiration.

Nom de la propriété Type Description
@microsoft.graph.channelCreationMode string Indique que le canal est à l’état de la migration et est actuellement utilisé à des fins de migration. Elle accepte une valeur : migration.

Remarque : channelCreationMode est un enum qui prend la valeur migration.

Pour consulter un exemple de demande POST, voir Demande (Créer canal en état de migration).

Relations

Relation Type Description
filesFolder driveItem Métadonnées de l’emplacement de stockage des fichiers du canal.
membres Collection conversationMember Collection des enregistrements d’appartenance associés au canal.
messages collectionchatMessage Une collection de tous les messages dans le canal. Propriété de navigation. Pouvant accepter la valeur Null.
operations Collection teamsAsyncOperation Opérations asynchrone ayant été exécutées ou en cours d’exécution sur cette équipe.
sharedWithTeams Collection sharedWithChannelTeamInfo Collection d’équipes avec lesquelles un canal est partagé.
onglets Collection teamsTab Une collection de tous les onglets dans le canal. Propriété de navigation.

Représentation JSON

Voici une représentation JSON de la ressource.

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