Method: accounts.locations.findMatches

Znajduje wszystkie możliwe lokalizacje pasujące do określonej lokalizacji. Ta operacja jest ważna 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, do której znaleziono 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 pasującej lokalizacji (w formacie BCP-47).
numResults

integer

Liczba dopasowań do zwrócenia. Wartością domyślną jest 3, a maksymalnie 10. Pamiętaj, że w przypadku zwiększenia limitu czas oczekiwania może się zwiększyć. Brak podziału na strony.
maxCacheDuration

string (Duration format)

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

Czas trwania w sekundach zawierający maksymalnie 9 cyfr po przecinku zakończony znakiem „s”. Przykład: "3.5s".

Treść odpowiedzi

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

Odpowiedź na żądanie Locations.FindMatchingLocations.

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

object (MatchedLocation)

Zbiór lokalizacji, które mogą zostać dopasowane do określonej lokalizacji, uporządkowane w kolejności od najlepszej do najmniejszej. Jeśli występuje dopasowanie ścisłe, zostanie ono wyświetlone na pierwszej pozycji.
matchTime

string (Timestamp format)

Data ostatniego uruchomienia algorytmu dopasowania w tej lokalizacji.

Sygnatura czasowa w formacie RFC3339 UTC „Zulu”, z rozdzielczością nanosekundy 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 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

Reprezentuje możliwe dopasowanie do lokalizacji.

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

object (Location)

Słabo zaludniona lokalizacja, która może potencjalnie pasować. Niewypełnione pola to między innymi: nazwa (pasującej lokalizacji nie można pobrać za pomocą aplikacji locations.get ani locations.batchGet); storeCode; szczegóły obszaru zasięgu (serviceArea); labels; adWordsLocationExtensions; photos
isExactMatch

boolean

Czy to dopasowanie ścisłe?