Method: accounts.locations.findMatches

Znajduje wszystkie możliwe lokalizacje pasujące do określonej lokalizacji. Ta operacja jest prawidłowa tylko wtedy, gdy lokalizacja nie jest zweryfikowana.

Żądanie HTTP

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

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
name

string

Nazwa zasobu lokalizacji, dla której chcesz znaleźć dopasowania.

Treść żądania

Treść żądania zawiera dane o następującej strukturze:

Zapis JSON 
{
  "languageCode": string,
  "numResults": integer,
  "maxCacheDuration": string
}
Pola
languageCode

string

Preferowany język lokalizacji (w formacie BCP-47).
numResults

integer

Liczba dopasowań do zwrócenia. Wartość domyślna to 3, maksymalnie 10. Pamiętaj, że czas oczekiwania może się zwiększyć, jeśli zostanie zażądanych więcej. Brak podziału na strony.
maxCacheDuration

string (Duration format)

Rola wycofana. To pole jest ignorowane w przypadku wszystkich żądań.

Czas trwania w sekundach z maksymalnie dziewięcioma cyframi po przecinku, zakończony znakiem „s”. Przykład: "3.5s".

Treść odpowiedzi

W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:

Komunikat z odpowiedzią na temat Locations.FindMatchingLocations.

Zapis JSON 
{
  "matchedLocations": [
    {
      object (MatchedLocation)
    }
  ],
  "matchTime": string
}
Pola
matchedLocations[]

object (MatchedLocation)

Zbiór lokalizacji, które mogą być dopasowane do określonej lokalizacji, uporządkowane w kolejności od najlepszego do najmniej dopasowanego. Jeśli występuje dopasowanie ścisłe, będzie ono zajmować pierwszą pozycję.
matchTime

string (Timestamp format)

Czas ostatniego wykonania algorytmu dopasowywania w przypadku tej lokalizacji.

Sygnatura czasowa w RFC3339 UTC „Zulu” z rozdzielczością nanosekundową i maksymalnie 9 cyframi po przecinku. Przykłady: "2014-10-02T15:01:23Z" i "2014-10-02T15:01:23.045123456Z".

Zakresy autoryzacji

Wymaga jednego z tych zakresów protokołu OAuth:

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

Więcej informacji znajdziesz w artykule Omówienie protokołu OAuth 2.0.

MatchedLocation

Przedstawia możliwe dopasowanie do lokalizacji.

Zapis JSON 
{
  "location": {
    object (Location)
  },
  "isExactMatch": boolean
}
Pola
location

object (Location)

Mało zaludniona lokalizacja, która może pasować do zapytania. Niewypełnione pola zawierają m.in.: nazwę (Dopasowanej lokalizacji nie można pobrać za pomocą locations.get ani locations.batchGet); storeCode; szczegóły obszaru zasięgu: serviceArea; labels; adWordsLocationExtensions; photos
isExactMatch

boolean

Czy to dopasowanie ścisłe?