Daten übertragen

Wenn Sie die Data Transfer API verwenden möchten, müssen Sie eine Übertragung definieren und dann mit der Methode insert initiieren. Die Übertragung wird anhand einer oder mehrerer Anwendungen definiert, deren Daten übertragen werden sollen, und kann anwendungsspezifische Parameter enthalten.

Im Folgenden finden Sie eine allgemeine Zusammenfassung des Übertragungsprozesses:

  1. Legen Sie die Anwendungen fest, für die Sie Daten übertragen möchten.
  2. Definieren Sie eine DataTransfer-Ressource, die die Quell- und Zielnutzer sowie die Anwendungen angibt, für die Daten übertragen werden sollen.
  3. Initiieren Sie die Übertragung mit der Methode insert().

Mit dem 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 Methode user.get() 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 enthält zusätzliche Methoden und Ressourcen, die Sie beim Erstellen und Verwalten von Übertragungen unterstützen. Damit können Sie beispielsweise Folgendes tun:

  • Anwendungen auflisten, die für die Datenübertragung verfügbar sind.
  • Rufen Sie die Anwendungsinformationen nach Anwendungs-ID ab.
  • Sie können Übertragungen nach Quellnutzer, Zielnutzer oder Status auflisten.
  • Get eine Übertragungsanfrage anhand der Ressourcen-ID.