轉移資料

如要使用 Data Transfer API,您必須定義轉移作業,然後使用 insert 方法啟動轉移作業。轉移作業會以一或多個應用程式為依據,這些應用程式會轉移資料,且可包含應用程式專屬參數

以下是轉移程序的概略說明:

  1. 決定要轉移資料的應用程式。
  2. 定義 DataTransfer 資源,指定來源和目的地使用者,以及要用來轉移資料的應用程式。
  3. 使用 insert() 方法啟動轉移作業。

舉例來說,下列 JSON 要求主體會將日曆從來源使用者 (SOURCE_USER_ID) 轉移至目的地使用者 (DESTINATION_USER_ID)。您可以呼叫 Directory API 的 user.get() 方法,並提供使用者的電子郵件地址或電子郵件別名,藉此擷取每位擁有者的使用者 ID。

{
  "oldOwnerUserId": "SOURCE_USER_ID",
  "newOwnerUserId": "DESTINATION_USER_ID",
  "applicationDataTransfers": [
    {
      "applicationId": "435070579839",
      "applicationTransferParams": [
        {
          "key": "RELEASE_RESOURCES",
          "value": [
            "TRUE"
          ]
        }
      ]
    }
  ]
}

Data Transfer API 包含其他方法和資源,可協助您建構及管理轉移作業,讓您執行下列操作:

  • 列出可用於資料移轉的應用程式。
  • 依據應用程式 ID 取得應用程式資訊。
  • 列出轉移作業,依來源使用者、目的地使用者或狀態排序。
  • 依據資源 ID 取得轉移要求。