Exporter du contenu avec les API Microsoft Teams Exporter

Teams L’exportation d’API vous permet d’exporter des conversations de groupe, des conversations de réunion et des messages de canal à partir d’Microsoft Teams. Si votre organisation doit exporter des messages Microsoft Teams, vous pouvez les extraire à l’aide d’Teams API d’exportation. Le message de conversation représente un message de conversation individuel au sein d’un canal ou d’une conversation. Le message de conversation peut être un message de conversation racine ou un élément d’un thread de réponse défini par la propriété replyToId dans le message de conversation.

Voici quelques exemples sur l’utilisation de ces API d’exportation :

  • Exemple 1: si vous avez activé Microsoft Teams dans votre organisation et que vous souhaitez exporter tous les messages Microsoft Teams à ce jour par programme en transmettre la plage de dates pour un utilisateur ou une équipe donné.
  • Exemple 2: si vous voulez exporter quotidiennement tous les messages des utilisateurs ou de l’équipe par programme en fournissant une plage de dates. Les API d’exportation peuvent extraire tous les messages créés ou mis à jour pendant la plage de dates donnée.

Quels sont les API pris en charge Teams’exportation ?

  • Message d’exportation en bloc : les API d’exportation Teams peuvent prendre en charge jusqu’à 200 SSP par application par client et 600 SD pour une application, avec ces limites, vous devez être en mesure d’exporter en bloc des messages Teams. Teams

  • Contexte de l’application: pour appeler microsoft Graph, votre application doit acquérir un jeton d’accès à partir du Plateforme d'identités Microsoft. Le jeton d’accès contient des informations sur votre application et les autorisations qu’elle possède pour les ressources et API disponibles via Microsoft Graph. Pour obtenir un jeton d’accès, votre application doit être inscrite auprès de la Plateforme d'identités Microsoft et être autorisée par un utilisateur ou un administrateur à accéder aux ressources Microsoft Graph dont elle a besoin.

    Si vous êtes déjà familiarisé avec l’intégration d’une application au Plateforme d'identités Microsoft pour obtenir des jetons, consultez la section Étapes suivantes pour plus d’informations et d’exemples spécifiques de Microsoft Graph.

  • Environnement hybride : L’exportation d’API prise en charge des messages envoyés par les utilisateurs qui sont provisionés dans un environnement hybride (environnement local Exchange et Teams). Tous les messages envoyés par les utilisateurs configurés pour un environnement hybride seront accessibles à l’aide d’API d’exportation.

  • Messages supprimés par l’utilisateur : Les messages supprimés par les utilisateurs du client Teams sont accessibles à l’aide d’API d’exportation jusqu’à 21 jours à partir de la suppression.

  • Pièces jointes : Les API d’exportation incluent les liens vers les pièces jointes envoyées dans le cadre des messages. Les API d’exportation vous permet de récupérer les fichiers joints aux messages.

  • Propriétés des messages de conversation : Consultez la liste complète des propriétés que vous ne Teams la prise en charge d’API Export ici.

Notes

L’exportation d’API ne permet pas de réactions.

Comment accéder aux API Teams Exporter

  • L’exemple 1 est une requête simple qui vous permettent de récupérer tous les messages d’un utilisateur ou d’une équipe sans filtre :

    GET https://graph.microsoft.com/v1.0/users/{id}/chats/getAllMessages
    
    GET https://graph.microsoft.com/v1.0/teams/{id}/channels/getAllMessages
    
  • L’exemple 2 est un exemple de requête qui vous permettent de récupérer tous les messages d’un utilisateur ou d’une équipe en spécifiant les filtres d’heure et les 50 premiers messages :

    GET https://graph.microsoft.com/v1.0/users/{id}/chats/getAllMessages?$top=50&$filter=lastModifiedDateTime gt 2020-06-04T18:03:11.591Z and lastModifiedDateTime lt 2020-06-05T21:00:09.413Z
    
    GET https://graph.microsoft.com/v1.0/teams/{id}/channels/getAllMessages?$top=50&$filter=lastModifiedDateTime gt 2020-06-04T18:03:11.591Z and lastModifiedDateTime lt 2020-06-05T21:00:09.413Z
    

Notes

L’API renvoie la réponse avec le lien de page suivant en cas de résultats multiples. Pour obtenir le jeu de résultats suivant, appelez simplement GET sur l’URL depuis @odata.nextlink. Si @odata.nextlink n’est pas présent ou null, tous les messages sont récupérés.

Conditions préalables d’accès Teams API Exporter

  • Microsoft Teams Les API dans Microsoft Graph qui accèdent aux données sensibles sont considérées comme des API protégées. Pour pouvoir les utiliser, les API d’exportation nécessitent une validation supplémentaire, au-delà des autorisations et du consentement. Pour demander l’accès à ces API protégées, remplissez le formulaire de demande.

  • Les autorisations d’application sont utilisées par les applications qui s’exécutent sans présentation d’utilisateur inscrit ; autorisations d’application ne peuvent être autorisées que par un administrateur. Les autorisations suivantes sont nécessaires :

    • Chat.Read.All: permet d’accéder aux messages de conversation de groupe et de réunion en tête-à-tête
    • ChannelMessage.Read.All: autorise l’accès à tous les messages de canal
    • User.Read.All: active l’accès à la liste des utilisateurs pour un client

Conditions de licence requises pour Teams API Exporter

L’API Export prend en charge les scénarios de sécurité et de conformité (S+C) et d’utilisation générale via un paramètre de requête de modèle. Les scénarios S+C (modèle A) incluent la capacité en charge et nécessitent un abonnement E5, et les scénarios d’utilisation générale (Modèle B) sont disponibles pour tous les abonnements et sont la consommation uniquement. Pour plus d’informations sur les frais de capacité et de consommation en charge, voir Gestion des licences et exigences de paiement pour les API Graph Teams Microsoft.

Scénarios S+C/Model A

Limité aux applications qui effectuent des fonctions de sécurité et/ou de conformité, les utilisateurs doivent avoir des licences E5 spécifiques pour utiliser cette fonctionnalité et recevoir une capacité accrue. La capacité en valeur est par utilisateur, calculée par mois et agrégée au niveau du client. Pour une utilisation en plus de la capacité accrue, les propriétaires d’application sont facturés pour la consommation d’API. Le modèle A permet uniquement d’accéder aux messages des utilisateurs qui ont une licence E5 attribuée.

Utilisation générale/Scénarios de modèle B

Disponible pour tous les scénarios autres que S+C, il n’y a pas de exigences de licence ou de capacité accrue. Lorsque des mètres de consommation deviennent disponibles, les propriétaires d’application seront facturés pour tous les appels d’API mensuels.

Mode d’évaluation (par défaut)

Aucune déclaration de modèle n’autorise l’accès à des API avec une utilisation limitée par chaque application de demande à des fins d’évaluation.

Représentation JSON

L’exemple suivant est une représentation JSON de la ressource :

Espace de noms : microsoft.graph

{
"id": "string (identifier)",
"replyToId": "string (identifier)",
"from": {"@odata.type": "microsoft.graph.identitySet"},
"etag": "string",
"messageType": "string",
"createdDateTime": "string (timestamp)",
"lastModifiedDateTime": "string (timestamp)",
"deletedDateTime": "string (timestamp)",
"subject": "string",
"from": {
                "application": null,
                "device": null,
                "conversation": null,
                "user": {

                    "id": \[{"@odata.type": "microsoft.graph.user"}\],
                    "displayName": "User Name",

                    "userIdentityType": "aadUser"                }
            },
"body": {"@odata.type": "microsoft.graph.itemBody"},
"summary": "string",

"chatId": \[{"@odata.type": "microsoft.graph.chat"}\]

"attachments": \[{"@odata.type": "microsoft.graph.chatMessageAttachment"}\],
"mentions": \[{"@odata.type": "microsoft.graph.chatMessageMention"}\],
"importance": "string",
"locale": "string",
}

Notes

Pour plus d’informations sur la ressource chatMessage, consultez l’article du type de ressource chatMessage.