Với API Quản lý tài khoản Doanh nghiệp của tôi, bạn có thể chuyển các vị trí sang nhiều tài khoản hoặc nhóm vị trí. Hãy làm theo hướng dẫn trong tài liệu này để tìm hiểu cách thực hiện.
Bắt đầu
Bạn cần có các mục sau để chuyển vị trí:
Tài khoản nguồn: Tài khoản nguồn là tài khoản sở hữu vị trí. Tài khoản này có thể là tài khoản cá nhân hoặc nhóm vị trí. Sau khi quá trình chuyển hoàn tất, tài khoản nguồn sẽ không còn quyền truy cập vào vị trí đó nữa.
Tài khoản đích: Tài khoản đích là tài khoản mà vị trí sẽ được chuyển đến. Tài khoản này có thể là tài khoản cá nhân hoặc nhóm vị trí. Sau khi quá trình chuyển hoàn tất, tài khoản đích sẽ là chủ sở hữu chính của vị trí.
Mã thông báo làm mới/truy cập OAuth2: Mã thông báo làm mới/truy cập OAuth2
cho tài khoản nguồn và tài khoản đích là cần thiết cho mỗi tài khoản để
gọi API.
Chuyển vị trí
Để chuyển địa điểm, hãy hoàn tất các bước sau:
Nếu không phải là chủ sở hữu của vị trí, bạn phải trở thành chủ sở hữu. Sử dụng thông tin xác thực OAuth của chủ sở hữu doanh nghiệp hiện tại để gọi
account.admins.create
và mời người dùng sở hữu trang thông tin. Sau đó, hãy sử dụng thông tin xác thực OAuth của người dùng được mời để gọiaccounts.invitations.list
nhằm lấy mã lời mời. Gọiaccounts.invitations.accept
để chấp nhận lời mời này.Sử dụng thông tin xác thực OAuth của tài khoản đích dự kiến để gọi
accounts.list
. Sau đó, hãy tìm mã tài khoản trong danh sách mà bạn muốn chuyển vị trí đến. Mã quản trị viên trong phản hồi lệnh gọiaccount.admins.create
hoặc lệnh gọiaccounts.invitations.list
ở bước 1 cũng có thể được dùng làm mã tài khoản. Mã tài khoản này có thể tham chiếu đến một tài khoản cá nhân hoặc một nhóm vị trí.Sử dụng mã tài khoản mà bạn truy xuất ở bước 2 làm tài khoản đích. Đây là trường destinationAccount trong phần nội dung yêu cầu mà bạn có thể dùng để gọi
locations.transfer
.
Sử dụng thông tin xác thực OAuth của tài khoản đích để gọi accounts.locations.list
và xác minh rằng vị trí đã chuyển xuất hiện trong kết quả. Nếu bạn gọi điểm cuối accounts.locations.list
bằng tài khoản nguồn, thì vị trí đã chuyển sẽ không có trong kết quả.
Chuyển sang một nhóm địa điểm
Để chuyển một vị trí sang location group
trong tổ chức, hãy gọi locations.admins.create
bằng thông tin xác thực OAuth merchant
. Sử dụng trường account
trong tài nguyên Admin
để truyền location group account ID
cùng với role
thích hợp. Bạn nên sử dụng thông tin xác thực quản trị viên location group
để gọi accounts.invitations.list
bằng cách sử dụng mã tài khoản của nhóm địa điểm làm đối số parent
để truy xuất các lời mời liên quan đến location group
. Tìm lời mời có vị trí mục tiêu chính xác, sau đó gọi accounts.invitations.accept
để chấp nhận lời mời chính xác.