Daten übertragen
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Wenn Sie die Data Transfer API verwenden möchten, definieren Sie eine Übertragung und initiieren sie dann mit der Methode insert
. Die Übertragung wird in Bezug auf eine oder mehrere Anwendungen definiert, deren Daten übertragen werden. Sie kann anwendungsspezifische Parameter enthalten.
Im Folgenden finden Sie eine allgemeine Zusammenfassung des Übertragungsvorgangs:
- Legen Sie fest, für welche Anwendungen Sie Daten übertragen möchten.
- Definieren Sie eine
DataTransfer
-Ressource, in der die Quell- und Zielnutzer sowie die Anwendungen angegeben sind, für die Daten übertragen werden sollen.
- Starten Sie die Übertragung mit der Methode
insert()
.
Im folgenden JSON-Anfragetext wird beispielsweise ein Kalender vom Quellnutzer (SOURCE_USER_ID
) an den Zielnutzer (DESTINATION_USER_ID
) übertragen. Sie können die Nutzer-IDs für jeden Inhaber abrufen, indem Sie die user.get()
-Methode der Directory API aufrufen und die E-Mail-Adresse oder den E-Mail-Alias angeben.
{
"oldOwnerUserId": "SOURCE_USER_ID",
"newOwnerUserId": "DESTINATION_USER_ID",
"applicationDataTransfers": [
{
"applicationId": "435070579839",
"applicationTransferParams": [
{
"key": "RELEASE_RESOURCES",
"value": [
"TRUE"
]
}
]
}
]
}
Die Data Transfer API bietet zusätzliche Methoden und Ressourcen, mit denen Sie Übertragungen erstellen und verwalten können. So haben Sie beispielsweise folgende Möglichkeiten:
- Listen Sie die für die Datenübertragung verfügbaren Apps auf.
- Anwendungsinformationen nach Anwendungs-ID abrufen
- Liste der Übertragungen nach Quellnutzer, Zielnutzer oder Status.
- Abrufen eines Übertragungsantrags nach Ressourcen-ID
Sofern nicht anders angegeben, sind die Inhalte dieser Seite unter der Creative Commons Attribution 4.0 License und Codebeispiele unter der Apache 2.0 License lizenziert. Weitere Informationen finden Sie in den Websiterichtlinien von Google Developers. Java ist eine eingetragene Marke von Oracle und/oder seinen Partnern.
Zuletzt aktualisiert: 2025-03-25 (UTC).
[null,null,["Zuletzt aktualisiert: 2025-03-25 (UTC)."],[],[],null,["# Transfer data\n\nTo use the Data Transfer API, you define a transfer and then initiate\nit using the `insert` method. The transfer is defined in terms of one or more\napplications whose data will be transferred, and can include\n[application-specific parameters](/workspace/admin/data-transfer/v1/parameters).\n\nThe following is a high-level summary of the transfer process:\n\n1. Determine the applications for which you want to transfer data.\n2. Define a [`DataTransfer` resource](/workspace/admin/data-transfer/reference/rest/v1/transfers) that specifies the source and destination users and the applications for which to transfer data.\n3. Initiate the transfer by using the [`insert()` method](/workspace/admin/data-transfer/reference/rest/v1/transfers/insert).\n\nFor example, the following JSON request body transfers a calendar from\nthe source user (\u003cvar translate=\"no\"\u003eSOURCE_USER_ID\u003c/var\u003e) to the destination user\n(\u003cvar translate=\"no\"\u003eDESTINATION_USER_ID\u003c/var\u003e). You can retrieve the user IDs for\neach owner by calling the\n[`user.get()` method](/workspace/admin/directory/reference/rest/v1/users/get)\nof the Directory API and providing their email address or email alias. \n\n {\n \"oldOwnerUserId\": \"\u003cvar translate=\"no\"\u003eSOURCE_USER_ID\u003c/var\u003e\",\n \"newOwnerUserId\": \"\u003cvar translate=\"no\"\u003eDESTINATION_USER_ID\u003c/var\u003e\",\n \"applicationDataTransfers\": [\n {\n \"applicationId\": \"435070579839\",\n \"applicationTransferParams\": [\n {\n \"key\": \"RELEASE_RESOURCES\",\n \"value\": [\n \"TRUE\"\n ]\n }\n ]\n }\n ]\n }\n\nRelated topics\n--------------\n\nThe Data Transfer API includes additional methods and resources to\nhelp you construct and administer transfers, allowing you to do things like\nthe following:\n\n- [List](/workspace/admin/data-transfer/v1/reference/applications/list) applications available for data transfer.\n- [Get](/workspace/admin/data-transfer/v1/reference/applications/get) application information by application ID.\n- [List](/workspace/admin/data-transfer/v1/reference/transfers/list) transfers by source user, destination user, or status.\n- [Get](/workspace/admin/data-transfer/v1/reference/transfers/get) a transfer request by resource ID."]]