Method: accounts.listRecommendGoogleLocations

Liệt kê tất cả GoogleLocation đã được đề xuất cho tài khoản Trang doanh nghiệp được chỉ định. Thông tin đề xuất chỉ được cung cấp cho các tài khoản cá nhân và nhóm vị trí. Yêu cầu cho tất cả các loại tài khoản khác sẽ dẫn đến lỗi. Các đề xuất cho nhóm vị trí được dựa trên những vị trí trong nhóm đó.

Các đề xuất cho tài khoản cá nhân được dựa trên tất cả các vị trí mà người dùng có quyền truy cập trên Trang doanh nghiệp (bao gồm cả những vị trí mà họ có thể truy cập thông qua các nhóm vị trí) và là tập hợp tất cả các đề xuất được tạo cho người dùng.

Yêu cầu HTTP

GET https://mybusiness.googleapis.com/v4/{name=accounts/*}:recommendGoogleLocations

URL sử dụng cú pháp Chuyển mã gRPC.

Tham số đường dẫn

Tham số
name

string

Tên của tài nguyên tài khoản để tìm nạp các vị trí được đề xuất trên Google.

Tham số truy vấn

Tham số
pageSize

integer

Số lượng vị trí cần tìm nạp trên mỗi trang. Giá trị mặc định là 25, tối thiểu là 1 và kích thước trang tối đa là 100.
pageToken

string

Nếu được chỉ định, trang tiếp theo của vị trí sẽ được truy xuất.

Nội dung yêu cầu

Nội dung yêu cầu phải trống.

Nội dung phản hồi

Nếu thành công, phần nội dung phản hồi sẽ chứa dữ liệu có cấu trúc sau:

Thông báo phản hồi cho GoogleLocations.ListRecommendedGoogleLocations.

Trang doanh nghiệp này cũng chứa một số vị trí đã được những người dùng Trang doanh nghiệp khác xác nhận quyền sở hữu kể từ lần gần đây nhất họ được đề xuất cho tài khoản Trang doanh nghiệp này.

Biểu diễn dưới dạng JSON 
{
  "googleLocations": [
    {
      object (GoogleLocation)
    }
  ],
  "totalSize": integer,
  "nextPageToken": string
}
Trường
googleLocations[]

object (GoogleLocation)

Các vị trí được đề xuất cho tài khoản Trang doanh nghiệp. Mỗi đối tượng trong số này đại diện cho một GoogleLocation xuất hiện trên Maps. Các vị trí được sắp xếp theo thứ tự giảm dần mức độ liên quan đối với tài khoản Trang doanh nghiệp.
totalSize

integer

Tổng số vị trí được đề xuất cho tài khoản Trang doanh nghiệp này, bất kể việc phân trang.
nextPageToken

string

Trong quá trình phân trang, nếu có thêm vị trí có sẵn để tìm nạp trong trang tiếp theo, trường này được điền sẵn một mã thông báo để tìm nạp trang vị trí tiếp theo trong lệnh gọi tiếp theo. Nếu không còn vị trí nào khác cần được tìm nạp, thì trường này sẽ không xuất hiện trong phản hồi.

Phạm vi cấp phép

Yêu cầu một trong các phạm vi OAuth sau:

  • https://www.googleapis.com/auth/plus.business.manage
  • https://www.googleapis.com/auth/business.manage

Để biết thêm thông tin, hãy xem bài viết Tổng quan về OAuth 2.0.