Vị trí của Google

API GoogleLocation cho phép bạn xem trước liệu một vị trí đã được xác nhận quyền sở hữu trong Trang doanh nghiệp hay chưa. Bằng cách này, nếu vị trí đã được xác nhận quyền sở hữu, bạn có thể yêu cầu quyền truy cập ngay vào vị trí đó. Ngoài ra, nếu quản lý các tài khoản được xác minh hàng loạt, bạn có thể chọn trước các kết quả có khả năng trùng khớp chính xác hơn và tránh phải tạo vị trí trùng lặp.

Điểm cuối API trả về một URL cho biết vị trí đã được xác nhận quyền sở hữu hay chưa. Nếu URL này đã được xác nhận quyền sở hữu, thì URL tương tự sẽ cho phép bạn bắt đầu quá trình yêu cầu quyền truy cập.

Hình ảnh sau đây cung cấp thông tin tổng quan về quy trình xin cấp quyền sở hữu một vị trí.

Hình 1. Sơ đồ đường bơi về quyền sở hữu vị trí Trang doanh nghiệp

Các bước sau cho phép bạn sử dụng API GoogleLocations:

  1. Thu thập dữ liệu vị trí từ người bán.

  2. Gọi điểm cuối googleLocations.search. Cung cấp dữ liệu vị trí trong phần nội dung của cuộc gọi. Ngoài ra, bạn có thể cung cấp giá trị đó trong một chuỗi truy vấn, tương tự như nội dung người dùng sẽ nhập trong Tìm kiếm hoặc Maps. Ví dụ: "Starbucks 5th ave NYC."

    API trả về danh sách các vị trí có khả năng trùng khớp và thông tin về từng vị trí, chẳng hạn như locationName và địa chỉ.

  3. Chọn vị trí phù hợp với vị trí của bạn. Nếu không có kết quả phù hợp, hãy gọi accounts.locations.create, rồi chuyển sang bước 5.

  4. Dựa trên trạng thái của requestAdminRightsUrl trong phản hồi, hãy thực hiện các hành động sau:

    1. Nếu requestAdminRightsUrl tồn tại, người dùng khác có quyền sở hữu danh sách. Chuyển hướng người bán đến URL để bắt đầu yêu cầu cấp quyền truy cập và quyền sở hữu vị trí hiện tại trong Trang doanh nghiệp.
    2. Nếu requestAdminRightsUrl không tồn tại, hãy gọi accounts.locations.create và tạo một trang thông tin mới để xác minh sau.
  5. Nếu đã tạo các trang thông tin mới trong quá trình này, bạn có thể sử dụng các API xác minh để bắt đầu quy trình xác minh trang thông tin. Để biết thêm thông tin, hãy xem phần Quản lý quy trình xác minh.