Method: accounts.listRecommendGoogleLocations

Liệt kê tất cả GoogleLocation đã được đề xuất cho tài khoản Trang doanh nghiệp đã chỉ định. Nội dung đề xuất chỉ được đưa ra cho tài khoản cá nhân và nhóm vị trí. Các yêu cầu đối với 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 địa điểm là dựa trên các vị trí trong nhóm đó.

Nội dung đề 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 địa điểm) và là tập mẹ của mọi nội dung đề 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

Các 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 của Google.

Tham số truy vấn

Các 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 địa điểm tiếp theo 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.

Ngoài ra, bảng này cũng chứa một số địa điểm đã được những người dùng khác trên Trang doanh nghiệp 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
}
Các 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 này đại diện cho một GoogleLocation có trên Maps. Các địa điểm này được sắp xếp theo thứ tự giảm dần mức độ liên quan đến 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ể cách phân trang.
nextPageToken

string

Trong quá trình phân trang, nếu có thêm vị trí cần tìm nạp trong trang tiếp theo, thì trường này sẽ đượ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ó vị trí nào khá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 uỷ quyền

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 Tổng quan về OAuth 2.0.