Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Sie können Unterhaltungsnachrichten in einen Cloud Storage-Bucket exportieren. Jede Unterhaltung wird als separate JSON-Datei im Standardformat für Unterhaltungsdaten exportiert.
Es können jeweils maximal 10.000 Unterhaltungen exportiert werden. Jede Unterhaltung darf maximal 1.000 Nachrichten enthalten.
Authentifizierung und Zugriffssteuerung
Wenn Sie eine Anfrage zum Exportieren von Unterhaltungen senden, verwenden Sie Ihre Endnutzeranmeldedaten zur Authentifizierung.
Ihrem Nutzerkonto muss mindestens die Rolle Lesen für die Dialogflow API und die Rolle Bearbeiten (mit der Möglichkeit, Objekte zu überschreiben) für den Cloud Storage-Bucket zugewiesen sein, in den Sie Daten exportieren möchten. Weitere Informationen zu Rollen für Nutzerkonten finden Sie in der Dokumentation zur Zugriffssteuerung für Cloud Storage und zur Zugriffssteuerung für Dialogflow.
Beim Ausführen von REST-Anfragen über die Befehlszeile gilt Folgendes:
Verwenden Sie gcloud auth login, um gcloud mit Ihrem Nutzerkonto zu authentifizieren.
Nur abgeschlossene Unterhaltungen können exportiert werden. Alte Unterhaltungen werden regelmäßig vom System gelöscht. Wenn Sie also versuchen, auf eine ältere Unterhaltung zu verweisen, ist sie möglicherweise nicht mehr verfügbar.
Export anfordern
Rufen Sie die Methode exportMessages auf, um einen Export anzufordern. Diese Methode ist ein Vorgang mit langer Ausführungszeit. Sie müssen also den Status prüfen, um festzustellen, ob er abgeschlossen wurde.
[[["Leicht verständlich","easyToUnderstand","thumb-up"],["Mein Problem wurde gelöst","solvedMyProblem","thumb-up"],["Sonstiges","otherUp","thumb-up"]],[["Schwer verständlich","hardToUnderstand","thumb-down"],["Informationen oder Beispielcode falsch","incorrectInformationOrSampleCode","thumb-down"],["Benötigte Informationen/Beispiele nicht gefunden","missingTheInformationSamplesINeed","thumb-down"],["Problem mit der Übersetzung","translationIssue","thumb-down"],["Sonstiges","otherDown","thumb-down"]],["Zuletzt aktualisiert: 2025-09-04 (UTC)."],[[["\u003cp\u003eThis feature is currently in a pre-general availability (Pre-GA) stage, meaning it is provided "as is" with potentially limited support, and it is subject to the "Pre-GA Offerings Terms".\u003c/p\u003e\n"],["\u003cp\u003eYou can export conversation messages to a Cloud Storage bucket as separate JSON files, with each conversation containing at most 1000 messages, and up to 10,000 conversations can be exported in one request.\u003c/p\u003e\n"],["\u003cp\u003eExporting conversations requires user authentication with at least a read role for the Dialogflow API and an edit role for the designated Cloud Storage bucket.\u003c/p\u003e\n"],["\u003cp\u003eOnly conversations that have been marked as completed are available for export, and older conversations may be deleted over time.\u003c/p\u003e\n"],["\u003cp\u003eTo initiate the export, use the \u003ccode\u003eexportMessages\u003c/code\u003e method, which operates as a long-running operation, requiring you to monitor its status for completion.\u003c/p\u003e\n"]]],[],null,["# Export conversation data\n\n| **Preview**\n|\n|\n| This feature is subject to the \"Pre-GA Offerings Terms\" in the General Service Terms section\n| of the [Service Specific Terms](/terms/service-terms#1).\n|\n| Pre-GA features are available \"as is\" and might have limited support.\n|\n| For more information, see the\n| [launch stage descriptions](/products#product-launch-stages).\n\nYou can export conversation messages to a\n[Cloud Storage](/storage/docs) bucket. Each conversation is exported as a\nseparate JSON file in the\n[standard conversation data format](/agent-assist/docs/conversation-data-format#conversation_transcript_data).\nA maximum of 10,000 conversations can be exported at a time, and each\nconversation can have at most 1000 messages.\n\nAuthentication and access control\n---------------------------------\n\nWhen you send a request to export conversations, use your\n[end-user credentials for authentication](/docs/authentication/end-user).\nYour user account must be granted at least a **read** role for the Dialogflow\nAPI and an **edit** role (with the ability to overwrite objects) for the Cloud Storage bucket you want to export data to. For more details on user account\nroles see the [Cloud Storage access control](/storage/docs/access-control/iam-roles)\nand [Dialogflow access control](/dialogflow/docs/access-control) documentation.\n\nWhen executing REST requests at the command-line:\n\n- Use [`gcloud auth login`](/sdk/gcloud/reference/auth/login) to authenticate `gcloud` with your user account.\n- Use [`gcloud auth print-access-token`](/sdk/gcloud/reference/auth/print-access-token) to create a token for request authentication.\n\nConversations available for export\n----------------------------------\n\nOnly conversations that have been\n[completed](/agent-assist/docs/smart-reply#complete_the_conversation) are\navailable for export. Old conversations are deleted by the system periodically,\nso if you try to reference an older conversation it may no longer be available.\n\nRequest export\n--------------\n\nTo request export, call the\n[`exportMessages`](/dialogflow/es/docs/reference/rest/v2beta1/projects/exportMessages)\nmethod. This method is a\n[long-running operation](/dialogflow/docs/how/long-running-operations), so you\nneed to check the status for completion."]]
