Method: accounts.locations.findMatches

Tìm tất cả các vị trí có thể trùng khớp với vị trí được chỉ định. Thao tác này chỉ hợp lệ nếu vị trí chưa được xác minh.

Yêu cầu HTTP

POST https://mybusiness.googleapis.com/v4/{name=accounts/*/locations/*}:findMatches

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

Tham số đường dẫn

Tham số
name

string

Tên tài nguyên của vị trí cần tìm kết quả phù hợp.

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 
{
  "languageCode": string,
  "numResults": integer,
  "maxCacheDuration": string
}
Trường
languageCode

string

Ngôn ngữ ưu tiên cho vị trí phù hợp (ở định dạng BCP-47).
numResults

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

string (Duration format)

Không dùng nữa. Trường này bị bỏ qua đối với mọi yêu cầu.

Thời lượng tính bằng giây với tối đa 9 chữ số phân số, kết thúc bằng "s". Ví dụ: "3.5s".

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 Location.FindMatchingLocations.

Biểu diễn dưới dạng JSON 
{
  "matchedLocations": [
    {
      object (MatchedLocation)
    }
  ],
  "matchTime": string
}
Trường
matchedLocations[]

object (MatchedLocation)

Tập hợp các vị trí có khả năng phù hợp với vị trí được chỉ định, được liệt kê theo thứ tự từ phù hợp nhất đến ít phù hợp nhất. Nếu có kết quả trùng khớp hoàn toàn, thì URL đó sẽ xuất hiện ở vị trí đầu tiên.
matchTime

string (Timestamp format)

Lần gần đây nhất thuật toán so khớp được thực thi cho vị trí này.

Dấu thời gian theo múi giờ "Zulu" RFC3339 (giờ UTC) với độ phân giải nano giây và lên đến 9 chữ số phân số. Ví dụ: "2014-10-02T15:01:23Z" và "2014-10-02T15:01:23.045123456Z".

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.

MatchedLocation

Biểu thị kết quả trùng khớp có thể xảy ra với một vị trí.

Biểu diễn dưới dạng JSON 
{
  "location": {
    object (Location)
  },
  "isExactMatch": boolean
}
Trường
location

object (Location)

Vị trí có mật độ dân cư thưa thớt có thể là kết quả trùng khớp. Các trường không được điền sẵn bao gồm nhưng không giới hạn ở: tên (không truy xuất được vị trí trùng khớp qua locations.get hoặc locations.batchGet); storeCode; Thông tin chi tiết về khu vực phủ sóng serviceArea; labels; adWordsLocationExtensions; photos
isExactMatch

boolean

Thông tin này có khớp chính xác không?