Method: googleLocations.search

Tìm kiếm tất cả vị trí có thể phù hợp với yêu cầu đã chỉ định.

Yêu cầu HTTP

POST https://mybusiness.googleapis.com/v4/googleLocations:search

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

Nội dung yêu cầu

Nội dung yêu cầu chứa dữ liệu có cấu trúc sau:

Biểu diễn dưới dạng JSON
{
  "resultCount": integer,

  // Union field search_query can be only one of the following:
  "location": {
    object (Location)
  },
  "query": string
  // End of list of possible types for union field search_query.
}
Trường
resultCount

integer

Số lượng kết quả phù hợp cần trả về. Giá trị mặc định là 3, tối đa là 10. Xin lưu ý rằng độ trễ có thể tăng lên nếu bạn yêu cầu thêm. Không có tính năng phân trang.

Trường kết hợp search_query. Cụm từ tìm kiếm. Giá trị này có thể được cung cấp dưới dạng đối tượng vị trí hoặc dưới dạng truy vấn chuỗi. search_query chỉ có thể là một trong những trạng thái sau đây:
location

object (Location)

Vị trí để tìm kiếm. Nếu được cung cấp, hệ thống sẽ tìm những vị trí khớp với thông tin vị trí mà bạn cung cấp.

query

string

Cụm từ tìm kiếm bằng văn bản cần tìm. Kết quả tìm kiếm từ một chuỗi truy vấn sẽ kém chính xác hơn so với khi cung cấp vị trí chính xác, nhưng có thể cung cấp nhiều kết quả khớp không chính xác hơn.

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

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

object (GoogleLocation)

Tập hợp các vị trí trên Google có khả năng phù hợp với yêu cầu đã chỉ định, được liệt kê theo thứ tự từ nhiều nhất đến ít nhất.

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.