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.
}
Các trường
resultCount

integer

Số lượng kết quả trùng khớ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 thời gian. Không có quá trình phân trang.
Trường nhóm search_query. Cụm từ tìm kiếm. Điều này có thể được cung cấp dưới dạng đối tượng vị trí hoặc 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í cần tìm kiếm. Nếu được cung cấp, sẽ tìm các vị trí khớp với thông tin vị trí đã cung cấp.
query

string

Cụm từ tìm kiếm bằng văn bản. Các 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 việc cung cấp một 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)
    }
  ]
}
Các trường
googleLocations[]

object (GoogleLocation)

Tập hợp GoogleLocations có thể phù hợp với yêu cầu đã chỉ định, được liệt kê theo thứ tự từ chính xác nhất đến ít chính xác nhất.

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.