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 địa điểm sang các tài khoản hoặc nhóm địa điểm khác nhau. 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.

Lưu ý: Để chuyển một vị trí, phương thức gọi phải là chủ sở hữu của vị trí đó và chủ tài khoản đích ít nhất phải là người quản lý vị trí đó. Để biết thông tin chi tiết về cách cấp quyền sở hữu trang thông tin, hãy xem bài viết Quản lý quản trị viên cho các tài khoản và vị trí.

Bắt đầu

Bạn phải 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 là chủ sở hữu của 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 thể truy cập thông tin vị trí nữa.
Tài khoản đích: Tài khoản đích là tài khoản sẽ nhận thông tin 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 chuyển xong, tài khoản đích sẽ là chủ sở hữu chính của vị trí.
Mã làm mới/mã truy cập OAuth2: Cần có mã làm mới/mã truy cập OAuth2 cho tài khoản nguồn và tài khoản đích cho từng tài khoản để gọi API.

Chuyển vị trí

Lưu ý: Trang doanh nghiệp có thời gian thử nghiệm đối với quản trị viên địa điểm. Sau khi người dùng được thêm vào một trang doanh nghiệp với tư cách là chủ sở hữu hoặc người quản lý, họ sẽ bị giới hạn trong vòng 7 ngày đối với những thao tác mà họ có thể thực hiện đối với người dùng ở vị trí khác cũng như đối với chính vị trí đó. Trong thời gian này, người dùng trong thời gian thử nghiệm sẽ không thể chuyển quyền sở hữu chính của một trang doanh nghiệp cho chính họ hoặc cho người dùng thứ ba.

Để chuyển vị trí, hãy hoàn tất các bước sau:

1. Nếu không phải là chủ sở hữu 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ủ 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 để lấy mã lời mời. Gọi accounts.invitations.accept để chấp nhận lời mời này.

   Lưu ý: Người nhận không thể là thành viên của tài khoản tổ chức hoặc nhóm người dùng.

2. Sử dụng thông tin xác thực OAuth của tài khoản đích dự định để 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í sang. Bạn cũng có thể dùng mã nhận dạng 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 làm mã tài khoản. Mã tài khoản này có thể là 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 (Tài khoản đích) trong nội dung yêu cầu mà bạn có thể dùng để gọi locations.transfer.

   Lưu ý: Sau khi chuyển xong, tài khoản đích là tài khoản chính liên kết với chủ sở hữu trang thông tin. Nếu đây không phải là kết quả mong muốn, hãy lặp lại các bước từ 1 đến 3 với người dùng mới. Sau đó, chuyển vị trí trở lại tài khoản chính ban đầu. Bạn có thể sử dụng điểm cuối accounts.admins.patch để hạ cấp vai trò quản trị viên của tài khoản đích ban đầu.

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í được 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 đưa vào kết quả.

Chuyển sang nhóm địa điểm

Để chuyển một vị trí cho location group trong tổ chức, hãy gọi locations.admins.create bằng cách sử dụ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 dùng mã tài khoản của nhóm vị trí 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 đúng lời mời.