Chuyển vị trí

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:

  1. 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ọi accounts.invitations.list nhằm lấy mã lời mời. Gọi accounts.invitations.accept để chấp nhận lời mời này.

  2. 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ọi account.admins.create hoặc lệnh gọi accounts.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í.

  3. 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.