データの移行

Data Transfer API を使用するには、転送を定義し、insert メソッドを使用して転送を開始します。転送は、データが転送される 1 つ以上のアプリに関して定義され、アプリ固有のパラメータを含めることができます。

移行プロセスの概要は次のとおりです。

  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 で転送リクエストを取得します。