Type de ressource de conversation

  • Article

Espace de noms: microsoft.graph

Une conversation est une collection de chatMessages entre un ou plusieurs participants. Les participants peuvent être des utilisateurs ou des applications.

Remarque : si la conversation est associée à un instance onlineMeeting, certaines des méthodes répertoriées ont un impact transitif sur la réunion.

Méthodes

Méthode Type renvoyé Description
Gestion des conversations
Créer une conversation conversation Créez une conversation.
Obtenir une conversation conversation Lit les propriétés et les relations de la conversation.
Mettre à jour la conversation conversation Mettez à jour les propriétés de la conversation.
Supprimer une conversation Aucun Supprimer une conversation.
Répertorier les membres d’une conversation Collection conversationMember Obtenez la liste de tous les utilisateurs de la conversation.
Ajouter un membre d’une conversation En-tête Location Ajoutez un utilisateur à la conversation.
Obtenir un membre d’une conversation conversationMember Obtenez un utilisateur unique de la conversation.
Supprimer un membre de la conversation Aucun Supprimer un utilisateur de la conversation.
Obtenir un chat entre l'utilisateur et l'application conversation Obtenir une conversation en personne entre l’utilisateur et l’application
Messages
Répertorier les messages dans la conversation chatMessage Obtenir des messages dans une conversation.
Obtenir le message dans une conversation chatMessage Obtenez un seul message dans une conversation.
Recevoir des messages dans toutes les conversations pour l’utilisateur collection de conversations Obtenir les messages de toutes les conversations auxquelles un utilisateur participe.
Applications
Répertorier des applications dans la conversation Collection teamsAppInstallation Répertorier les applications installées dans une conversation (et la réunion associée).
Obtenir l’application dans une conversation teamsAppInstallation Obtenir une application spécifique installée dans une conversation (et la réunion associée).
Ajouter une application dans la conversation Ajouter (installer) une application dans une conversation (et la réunion associée).
Mettre à niveau l’application dans la conversation Aucun Mettez à jour vers la dernière version de l’application installée dans la conversation (et la réunion associée).
Désinstaller l’application d’une conversation Aucun Supprimer (désinstaller) l’application d’une conversation (et de la réunion associée).
Répertorier les octrois d’autorisations Collection resourceSpecificPermissionGrant Répertorier les autorisations accordées aux applications dans cette conversation.
Onglets
Lister les onglets dans la conversation teamsTab Répertorier les onglets épinglés à une conversation (et à la réunion associée).
Obtenir l’onglet dans la conversation teamsTab Obtenir un onglet spécifique épinglé à une conversation (et à la réunion associée).
Ajouter un onglet à la conversation teamsTab Ajouter (épingler) un onglet à une conversation (et à la réunion associée).
Onglet Mettre à jour dans la conversation teamsTab Mettez à jour les propriétés d’un onglet dans une conversation (et la réunion associée).
Supprimer l’onglet de la conversation Aucun Supprimer (désépingler) un onglet d’une conversation (et de la réunion associée).
Messages épinglés
Répertorier les messages épinglés collection pinnedChatMessageInfo Obtenez la liste des messages épinglés dans une conversation.
Épingler un message épingléChatMessageInfo Épinglez un message de conversation dans une conversation.
Désépingler un message Aucun Désépingler un message d’une conversation.

Note: Lorsque vous utilisez des autorisations d’application, vérifiez que vous savez comment obtenir l’ID de conversation. Étant donné que la liste des conversations avec des autorisations d’application n’est pas prise en charge, tous les scénarios ne sont pas possibles. Il est possible d’obtenir des ID de conversation avec des autorisations déléguées et des notifications de modification pour /chats/getAllMessages avec des autorisations d’application.

Propriétés

Propriété Type Description
chatType chatType Spécifie le type de conversation. Les valeurs possibles sont les suivantes : group, oneOnOne, meeting, unknownFutureValue.
createdDateTime dateTimeOffset Date et heure de création de la conversation. En lecture seule.
id String Identificateur unique de la conversation. En lecture seule.
lastUpdatedDateTime dateTimeOffset Date et heure auxquelles la conversation a été renommée ou la liste des membres a été modifiée pour la dernière fois. En lecture seule.
onlineMeetingInfo teamworkOnlineMeetingInfo Représente les détails d’une réunion en ligne. Si la conversation n’est pas associée à une réunion en ligne, la propriété est vide. En lecture seule.
tenantId String Identificateur du locataire dans lequel la conversation a été créée. En lecture seule.
topic String (Facultatif) Objet ou rubrique de la conversation. Disponible uniquement pour les conversations de groupe.
Vue chatViewpoint Représente des informations spécifiques à l’appelant sur la conversation, telles que la date et l’heure du dernier message lu. Cette propriété est renseignée uniquement lorsque la demande est effectuée dans un contexte délégué.
webUrl String URL de la conversation dans Microsoft Teams. L’URL doit être traitée comme un objet blob opaque et non analysée. En lecture seule.

Valeurs chatType

Membre Valeur Description
oneOnOne 0 Indique que la conversation est une conversation 1 :1. La taille de la liste est fixe pour ce type de conversation ; les membres ne peuvent pas être supprimés/ajoutés.
group 1 Indique que la conversation est une conversation de groupe. La taille de la liste (d’au moins deux personnes) peut être mise à jour pour ce type de conversation. Les membres peuvent être supprimés/ajoutés ultérieurement.
Réunion 2 Indique que la conversation est associée à une réunion en ligne. Ce type de conversation est créé uniquement dans le cadre de la création d’une réunion en ligne.
unknownFutureValue 3 Valeur sentinel de l’énumération évolutive. Ne pas utiliser.

Relations

Relation Type Description
installedApps collection teamsAppInstallation Collection de toutes les applications de la conversation. Pouvant accepter la valeur Null.
lastMessagePreview chatMessageInfo Aperçu du dernier message envoyé dans la conversation. Null si aucun message n’a été envoyé dans la conversation. Actuellement, seule l’opération de liste des conversations prend en charge cette propriété.
membres Collection conversationMember Collection de tous les membres de la conversation. Peut avoir la valeur Null.
messages collectionchatMessage Collection de tous les messages de la conversation. Pouvant accepter la valeur Null.
permissionGrants Collection resourceSpecificPermissionGrant Collection d’autorisations accordées aux applications pour la conversation.
pinnedMessages collection pinnedChatMessageInfo Collection de tous les messages épinglés dans la conversation. Pouvant accepter la valeur Null.
onglets Collection teamsTab Collection de tous les onglets de la conversation. Pouvant accepter la valeur Null.

Représentation JSON

Voici une représentation JSON de la ressource.

{
  "createdDateTime": "dateTimeOffset",
  "chatType": "string",
  "id": "string (identifier)",
  "lastUpdatedDateTime": "dateTimeOffset",
  "onlineMeetingInfo": {
    "@odata.type": "microsoft.graph.teamworkOnlineMeetingInfo"
  },
  "tenantId": "string",
  "topic": "string",
  
  "viewpoint": {
    "@odata.type": "microsoft.graph.chatViewpoint"
  },
  "webUrl": "string",
}

Contenu connexe