Type de ressource channel

Espace de noms: microsoft.graph

Important

Les API sous /beta la version dans Microsoft Graph sont sujettes à modification. L’utilisation de ces API dans des applications de production n’est pas prise en charge. Pour déterminer si une API est disponible dans la version 1.0, utilisez le sélecteur de version.

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 Récupérez la liste des objets channels de cette équipe.
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.
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 channel avec le type d’adhésion de private.
Récupérer un membre du canal Collection conversationMember Récupérer un membre d’un canal.
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 un canal avec le type d’adhésion de private.
Supprimer un membre d’un canal Aucune Supprimer un membre d’un canal. Uniquement pris en charge pour un channelType private.
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.

Propriétés

Propriété Type Description
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.
id String Identificateur unique du canal. En lecture seule.
isFavoriteByDefault Valeur booléenne Indique si le canal doit être automatiquement marqué comme « favori » pour tous les membres de l’équipe. Ne peut être fixé de manière programmatique qu'avec Créer une équipe. La valeur par défaut est false.
email String Adresse e-mail pour l’envoi de messages au canal. En lecture seule.
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.
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.
createdDateTime dateTimeOffset En lecture seule. Timestamp auquel le canal a été créé.
moderationSettings channelModerationSettings Paramètres de configuration de modération des canaux afin de contrôler qui peut lancer de nouvelles publications et répondre aux publications de ce canal.

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 une énumération 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
messages collectionchatMessage Collection de tous les messages du canal. Propriété de navigation. Pouvant accepter la valeur Null.
onglets Collection teamsTab Collection de tous les onglets du canal. Propriété de navigation.
membres Collection conversationMember Collection des enregistrements d’appartenance associés au canal.
filesFolder driveItem Métadonnées de l’emplacement de stockage des fichiers du canal.
opérations Collection teamsAsyncOperation Opérations asynchrone ayant été exécutées ou en cours d’exécution sur cette équipe.

Représentation JSON

Voici une représentation JSON de la ressource.

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