Interfejs GoogleLocations API pozwala z wyprzedzeniem sprawdzić, czy do profilu firmy zgłoszono prawa do lokalizacji. Dzięki temu do wybranej lokalizacji możesz od razu poprosić o dostęp. Jeśli zarządzasz kontami zweryfikowanymi zbiorczo, możesz z wyprzedzeniem wybrać potencjalne dopasowania i uniknąć tworzenia duplikatów lokalizacji.
Punkt końcowy interfejsu API zwraca adres URL wskazujący, czy dana lokalizacja została już zarezerwowana. Jeśli zgłoszono prawa, ten sam adres URL umożliwia rozpoczęcie procesu wysyłania prośby o dostęp.
Poniższa ilustracja procesu przedstawia prawo własności do lokalizacji.
![](https://developers-dot-devsite-v2-prod.appspot.com/static/my-business/images/locations1.png?authuser=3&hl=pl)
Aby móc korzystać z interfejsu API GoogleLocations
, możesz wykonać te czynności:
- Zbieraj dane o lokalizacji od sprzedawcy.
-
Wywołaj punkt końcowy
googleLocations.search
. Podaj dane dotyczące lokalizacji w treści rozmowy. Możesz też podać go w ciągu zapytania, podobnie jak użytkownik wpisuje w wyszukiwarce lub Mapach Google. np. &"Starbucks 5th ave NYC."Interfejs API zwraca listę potencjalnie pasujących lokalizacji i informacji o każdej lokalizacji, np. adresu
locationName
i adresu. - Wybierz lokalizację, która odpowiada Twojej lokalizacji. W przypadku braku dopasowań zadzwoń do
accounts.locations.create
i przejdź do kroku 5. -
Na podstawie stanu
requestAdminRightsUrl
w odpowiedzi wykonaj te czynności:- Jeśli domena
requestAdminRightsUrl
istnieje, inny użytkownik jest jej właścicielem. Przekieruj sprzedawcę do adresu URL, aby rozpocząć prośbę o dostęp i własność do istniejącej lokalizacji w Profilu Firmy. - Jeśli
requestAdminRightsUrl
nie istnieje, zadzwoń doaccounts.locations.create
i utwórz nową wizytówkę, która zostanie zweryfikowana później.
- Jeśli domena
- Jeśli w ramach tego procesu utworzysz nowe wizytówki, możesz skorzystać z interfejsów API weryfikacji, aby rozpocząć ich weryfikację. Więcej informacji znajdziesz w artykule Zarządzanie weryfikacją.