データ転送

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

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

  1. データを転送するアプリケーションを特定します。
  2. 移行元のユーザーと移行先のユーザー、およびデータを転送するアプリケーションを指定する DataTransfer リソースを定義します。
  3. insert() メソッドを使用して転送を開始します。

たとえば、次の JSON リクエスト本文は、送信元ユーザー（SOURCE_USER_ID）から宛先ユーザー（DESTINATION_USER_ID）にカレンダーを転送します。各オーナーのユーザー ID を取得するには、Directory API の user.get() メソッドを呼び出し、メールアドレスまたはメール エイリアスを指定します。

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

Data Transfer API には、転送の作成と管理に役立つ追加のメソッドとリソースが含まれています。これにより、次のようなことができます。

  • データ転送に使用できるアプリを一覧表示します。
  • アプリケーション ID でアプリケーション情報を取得します。
  • 移行元のユーザー、移行先のユーザー、ステータス別に転送を一覧表示します。
  • リソース ID で転送リクエストを取得します。