데이터 이전
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
Data Transfer API를 사용하려면 전송을 정의한 후 insert
메서드를 사용하여 시작합니다. 전송은 데이터가 전송될 하나 이상의 애플리케이션을 기준으로 정의되며 애플리케이션별 매개변수를 포함할 수 있습니다.
다음은 이전 프로세스에 대한 대략적인 요약입니다.
- 데이터를 전송할 애플리케이션을 확인합니다.
- 소스 및 대상 사용자와 데이터를 전송할 애플리케이션을 지정하는
DataTransfer
리소스를 정의합니다.
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별로 이전 요청을 가져옵니다.
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-03-25(UTC)
[null,null,["최종 업데이트: 2025-03-25(UTC)"],[],[],null,["# Transfer data\n\nTo use the Data Transfer API, you define a transfer and then initiate\nit using the `insert` method. The transfer is defined in terms of one or more\napplications whose data will be transferred, and can include\n[application-specific parameters](/workspace/admin/data-transfer/v1/parameters).\n\nThe following is a high-level summary of the transfer process:\n\n1. Determine the applications for which you want to transfer data.\n2. Define a [`DataTransfer` resource](/workspace/admin/data-transfer/reference/rest/v1/transfers) that specifies the source and destination users and the applications for which to transfer data.\n3. Initiate the transfer by using the [`insert()` method](/workspace/admin/data-transfer/reference/rest/v1/transfers/insert).\n\nFor example, the following JSON request body transfers a calendar from\nthe source user (\u003cvar translate=\"no\"\u003eSOURCE_USER_ID\u003c/var\u003e) to the destination user\n(\u003cvar translate=\"no\"\u003eDESTINATION_USER_ID\u003c/var\u003e). You can retrieve the user IDs for\neach owner by calling the\n[`user.get()` method](/workspace/admin/directory/reference/rest/v1/users/get)\nof the Directory API and providing their email address or email alias. \n\n {\n \"oldOwnerUserId\": \"\u003cvar translate=\"no\"\u003eSOURCE_USER_ID\u003c/var\u003e\",\n \"newOwnerUserId\": \"\u003cvar translate=\"no\"\u003eDESTINATION_USER_ID\u003c/var\u003e\",\n \"applicationDataTransfers\": [\n {\n \"applicationId\": \"435070579839\",\n \"applicationTransferParams\": [\n {\n \"key\": \"RELEASE_RESOURCES\",\n \"value\": [\n \"TRUE\"\n ]\n }\n ]\n }\n ]\n }\n\nRelated topics\n--------------\n\nThe Data Transfer API includes additional methods and resources to\nhelp you construct and administer transfers, allowing you to do things like\nthe following:\n\n- [List](/workspace/admin/data-transfer/v1/reference/applications/list) applications available for data transfer.\n- [Get](/workspace/admin/data-transfer/v1/reference/applications/get) application information by application ID.\n- [List](/workspace/admin/data-transfer/v1/reference/transfers/list) transfers by source user, destination user, or status.\n- [Get](/workspace/admin/data-transfer/v1/reference/transfers/get) a transfer request by resource ID."]]