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 |
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 |
Preferowany język pasującej lokalizacji (w formacie BCP-47). |
numResults |
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 |
Rola wycofana. To pole jest ignorowane w przypadku wszystkich żądań. Czas trwania w sekundach zawierający maksymalnie 9 cyfr po przecinku zakończony znakiem „ |
Treść odpowiedzi
W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:
Odpowiedź na żądanie Locations.FindMatchingLocations.
Zapis JSON | |
---|---|
{
"matchedLocations": [
{
object ( |
Pola | |
---|---|
matchedLocations[] |
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 |
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: |
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 ( |
Pola | |
---|---|
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 |
isExactMatch |
Czy to dopasowanie ścisłe? |