위치 이전

My Business Account Management API를 사용하면 위치를 다른 계정 또는 위치 그룹으로 이전할 수 있습니다. 이 문서의 안내에 따라 방법을 알아보세요.

시작하기

위치를 이전하려면 다음 항목이 필요합니다.

기존 계정: 기존 계정은 위치 소유자인 계정입니다. 이 계정은 개인 계정 또는 위치 그룹일 수 있습니다. 이전이 완료되면 기존 계정은 더 이상 위치에 액세스할 수 없습니다.
대상 계정: 대상 계정은 위치가 이전되어야 하는 계정입니다. 이 계정은 개인 계정 또는 위치 그룹일 수 있습니다. 이전이 완료되면 대상 계정이 위치의 기본 소유자가 됩니다.
OAuth2 갱신/액세스 토큰: API를 호출하려면 각 계정에 기존 계정 및 대상 계정의 OAuth2 갱신/액세스 토큰이 필요합니다.

위치 이전

위치를 이전하려면 다음 단계를 완료하세요.

  1. 위치의 소유자가 아닌 경우 소유자가 되어야 합니다. 현재 비즈니스 소유자의 OAuth 사용자 인증 정보를 사용하여 account.admins.create를 호출하고 사용자를 비즈니스 정보 소유자로 초대합니다. 그런 다음 초대된 사용자의 OAuth 사용자 인증 정보로 accounts.invitations.list를 호출하여 초대 ID를 가져옵니다. 이 초대를 수락하려면 accounts.invitations.accept를 호출합니다.

  2. 원하는 대상 계정의 OAuth 사용자 인증 정보를 사용하여 accounts.list를 호출합니다. 그런 다음 목록에서 위치를 이전할 대상 계정 ID를 찾습니다. 1단계의 account.admins.create 호출 또는 accounts.invitations.list 호출로 얻은 관리자 ID도 계정 ID로 사용할 수 있습니다. 이 계정 ID는 개인 계정 또는 위치 그룹일 수 있습니다.

  3. 2단계에서 가져온 계정 ID를 대상 계정으로 사용합니다. 요청 본문의 destinationAccount 필드이며, locations.transfer를 호출하는 데 사용할 수 있습니다.

대상 계정의 OAuth 사용자 인증 정보를 사용하여 accounts.locations.list를 호출하고 이전된 위치가 결과에 표시되는지 확인합니다. 기존 계정으로 accounts.locations.list 엔드포인트를 호출하면 이전된 위치가 결과에 포함되지 않습니다.

조직의 location group으로 위치를 이전하려면 merchant OAuth 사용자 인증 정보를 사용하여 locations.admins.create를 호출합니다. Admin 리소스의 account 필드를 사용하여 location group account ID를 적절한 role과 함께 전달합니다. location group 관리자 인증 정보를 사용하고 위치 그룹의 계정 ID를 parent 인수로 사용하여 accounts.invitations.list를 호출해야 location group 관련 초대를 가져올 수 있습니다. 올바른 대상 위치가 있는 초대를 찾은 다음 accounts.invitations.accept를 호출하여 올바른 초대를 수락합니다.