Daten übertragen

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:

  1. Legen Sie fest, für welche Anwendungen Sie Daten übertragen möchten.
  2. Definieren Sie eine DataTransfer-Ressource, in der die Quell- und Zielnutzer sowie die Anwendungen angegeben sind, für die Daten übertragen werden sollen.
  3. 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