Exportieren von Inhalten mit den Microsoft Teams Export-APIsExport content with the Microsoft Teams Export APIs

Teams-Export-APIs ermöglichen es Ihnen, 1:1-und Gruppen-Chatnachrichten aus Microsoft Teams zu exportieren.Teams Export APIs allow you to export 1:1 and group chat messages from Microsoft Teams. Wenn Ihre Organisation Microsoft Teams-Nachrichten exportieren muss, können Sie diese mithilfe von Team Export-APIs extrahieren.If your organization needs to export Microsoft Teams messages, you are able to extract them using Teams Export APIs. Chat-Nachricht stellt eine einzelne Chatnachricht in einem Kanal oder Chatdar.Chat Message represents an individual chat message within a channel or chat. Bei der Chatnachricht kann es sich um eine root-Chatnachricht oder einen Teil eines Antwort Threads handeln, der durch die replyToId -Eigenschaft in der Chatnachricht definiert ist.The chat message can be a root chat message or part of a reply thread that is defined by the replyToId property in the chat message.

Nachfolgend finden Sie einige Beispiele, wie Sie diese Export-APIs verwenden können:Here are some examples on how you can use these export APIs:

  • Beispiel 1: Wenn Sie Microsoft Teams in Ihrer Organisation aktiviert haben und alle Microsoft Teams-Nachrichten bis dato programmgesteuert exportieren möchten, indem Sie den Datumsbereich für einen bestimmten Benutzer übergeben.Example 1: If you have enabled Microsoft Teams in your organization and want to export all the Microsoft Teams messages to date programmatically by passing the date range for a given user.
  • Beispiel 2: Wenn Sie alle Benutzer Nachrichten programmgesteuert exportieren möchten, indem Sie einen Datumsbereich angeben.Example 2: If you want to programmatically export all user messages daily by providing a date range. Export-APIs können alle Nachrichten abrufen, die während des angegebenen Datumsbereichs erstellt oder aktualisiert wurden.Export APIs can retrieve all the messages created or updated during the given date range.

Was wird von den Export-APIs für Teams unterstützt?What is supported by the Teams Export APIs?

  • Massen Export der Teams-Nachricht: Teams-Export-APIs unterstützen bis zu 200 RPS pro App pro Mandant und 600 RPS für eine Anwendung, mit diesen Einschränkungen sollten Sie in der Lage sein, den Massen Export von Teams-Nachrichten auszuführen.Bulk Export of Teams Message: Teams Export APIs support up to 200 RPS Per App Per tenant and 600 RPS for an Application, with these limits you should be able to bulk export of Teams messages.

  • Anwendungskontext: zum Aufrufen von Microsoft Graph muss Ihre APP ein Zugriffstoken von der Microsoft Identity-Plattform erwerben.Application Context: To call Microsoft Graph, your app must acquire an access token from the Microsoft identity platform. Das Zugriffstoken enthält Informationen über Ihre APP und die Berechtigungen für die Ressourcen und APIs, die über Microsoft Graph zur Verfügung stehen.The access token contains information about your app and the permissions it has for the resources and APIs available through Microsoft Graph. Zum Abrufen eines Zugriffstokens muss Ihre APP bei der Microsoft Identity-Plattform registriert und von einem Benutzer oder Administrator für den Zugriff auf die benötigten Microsoft Graph-Ressourcen autorisiert werden.To get an access token, your app must be registered with the Microsoft identity platform and be authorized by either a user or an administrator for access to the Microsoft Graph resources it needs.

    Wenn Sie bereits mit der Integration einer APP mit der Microsoft Identity-Plattform zum Abrufen von Token vertraut sind, lesen Sie den Abschnitt Nächste Schritte für Informationen und Beispiele für Microsoft Graph.If you are already familiar with integrating an app with the Microsoft identity platform to get tokens, see the Next Steps section for information and samples specific to Microsoft Graph.

  • Hybrid Umgebung: Export-APIs unterstützen Nachrichten, die von Benutzern gesendet werden, die in einer Hybrid Umgebung bereitgestellt werden (Lokales Exchange und Teams).Hybrid Environment: Export APIs support messages sent by users who are provisioned on Hybrid Environment (on-premises Exchange and Teams). Alle Nachrichten, die von Benutzern gesendet werden, die für eine Hybridumgebung konfiguriert sind, können mithilfe von Export-APIs aufgerufen werden.Any messages that are sent by users who are configured for hybrid environment will be accessible using Export APIs.

  • Gelöschte Nachrichten des Benutzers: Nachrichten, die vom Benutzer des Teams-Clients gelöscht werden, können mithilfe von Export-APIs bis zu 30 Tage nach dem Löschvorgang aufgerufen werden.User Deleted Messages: Messages that are deleted by user from Teams client can be accessed using export APIs up to 30 days from the time of deletion.

  • Nachrichtenanlagen: Export-APIs enthalten die Links zu den Anlagen, die als Teil von Nachrichten gesendet werden.Message Attachments: Export APIs include the links to the attachments that are sent as part of messages. Mit Export-APIs können Sie die in den Nachrichten angefügten Dateien abrufen.Using Export APIs you can retrieve the files attached in the messages.

  • Eigenschaften von Chat Nachrichten: Weitere Informationen finden Sie in der vollständigen Liste der Eigenschaften, die Team- APIs unterstützen.Chat Message Properties: Refer to the complete list of properties that Teams Export APIs support here.

Zugreifen auf Team Export-APIsHow to access Teams Export APIs

  • Beispiel 1 ist eine einfache Abfrage, mit der alle Nachrichten eines Benutzers ohne Filter abgerufen werden:Example 1 is a simple query to retrieve all the messages of a user without any filters:

    GET https://graph.microsoft.com/beta/users/{id}/chats/allMessages
    
  • Beispiel 2 ist eine Beispielabfrage, um alle Nachrichten eines Benutzers abzurufen, indem Datums Zeitfilter und Top 50-Nachrichten angegeben werden:Example 2 is a sample query to retrieve all the messages of a user by specifying date time filters and top 50 messages:

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

Hinweis

Die API gibt die Antwort mit dem Link "Nächste Seite" zurück, falls mehrere Ergebnisse vorliegen.The API returns response with next page link in case of multiple results. Wenn Sie den nächsten Satz von Ergebnissen erhalten möchten, rufen Sie einfach die URL von @odata. Nextlink.For getting next set of results, simply call GET on the url from @odata.nextlink. Wenn @odata. Nextlink nicht vorhanden oder NULL ist, werden alle Nachrichten abgerufen.If @odata.nextlink is not present or null then all messages are retrieved.

Voraussetzungen für den Zugriff auf Team Export-APIsPrerequisites to access Teams Export APIs

  • Die Export-APIs für Teams befinden sich derzeit in der Vorschau.Teams Export APIs are currently in preview. Es steht Benutzern und Mandanten nur zur Verfügung, die über die erforderlichen Lizenzen für APIs verfügen.It will only be available to users and tenants that have the required licenses for APIs. In Zukunft kann Microsoft verlangen, dass Sie oder Ihre Kunden zusätzliche Gebühren auf der Grundlage der Datenmenge Zahlen, auf die über die API zugegriffen wird.In the future, Microsoft may require you or your customers to pay additional fees based on the amount of data accessed through the API.

  • Microsoft Teams-APIs in Microsoft Graph, die auf vertrauliche Daten zugreifen, gelten als geschützte APIs.Microsoft Teams APIs in Microsoft Graph that access sensitive data are considered protected APIs. Für Export-APIs ist es erforderlich, dass Sie über Berechtigungen und Zustimmung hinaus zusätzliche Überprüfung haben, bevor Sie Sie verwenden können.Export APIs require that you have additional validation, beyond permissions and consent, before you can use them. Wenn Sie den Zugriff auf diese geschützten APIs anfordern möchten, füllen Sie das Anforderungsformularaus.To request access to these protected APIs, complete the request form.

  • Anwendungsberechtigungen werden von apps verwendet, die ohne angemeldeten Benutzer ausgeführt werden. Anwendungsberechtigungen können nur von einem Administrator zugestimmt werden.Application permissions are used by apps that run without a signed-in user present; application permissions can only be consented by an administrator. Die folgenden Berechtigungen sind erforderlich:The following permissions are needed:

    • Chat. Read. all: ermöglicht den Zugriff auf alle 1:1-und Gruppen-ChatnachrichtenChat.Read.All: enables access to all 1:1 and Group chat messages
    • User. Read. all: ermöglicht den Zugriff auf die Liste der Benutzer für einen MandantenUser.Read.All: enables access to the list of users for a tenant

JSON-DarstellungJSON representation

Im folgenden Beispiel handelt es sich um eine JSON-Darstellung der Ressource:The following example is a JSON representation of the resource:

Namespace: Microsoft. GraphNamespace: 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": "0de69e5e-2da8-4cf2-821f-5e6585b2c65b",
                    "displayName": "User Name",
                    "userIdentityType": "aadUser"                }
            },
"body": {"@odata.type": "microsoft.graph.itemBody"},
"summary": "string",
"chatId": "19:0de69e5e-2da8-4cf2-821f-5e6585b2c65b_5c64e248-3269-4268-a36e-0f80314e9c39@unq.gbl.spaces"
"attachments": \[{"@odata.type": "microsoft.graph.chatMessageAttachment"}\],
"mentions": \[{"@odata.type": "microsoft.graph.chatMessageMention"}\],
"importance": "string",
"locale": "string",
}

Hinweis

Weitere Informationen zur chatMessage-Ressource finden Sie im Artikel zum chatMessage-Ressourcentyp .For more details on chatMessage resource, see the chatMessage resource type article.