Dostawcy, którzy oferują zarządzanie wizytówką bezpośrednio na swojej platformie, mogą zweryfikować Twojej firmy w swojej witrynie. Dzięki temu nie trzeba przekierowywać sprzedawcy na Interfejs Profilu Firmy.
Pobierz bieżący stan
Użytkownicy mogą dzwonić pod numer locations.getVoiceOfMerchantState
w lokalizacji, aby pobrać jej bieżący stan. Jeśli
hasVoiceOfMerchant
ma wartość true
, to lokalizacja ma już dobrą opinię i nie są wymagane żadne dodatkowe działania. Jeśli działanie gain_voice_of_merchant
w odpowiedzi zawiera wartość verify
, musisz dokończyć weryfikację. Aby uzyskać więcej informacji, postępuj zgodnie z instrukcjami poniżej.
Opcje weryfikacji pobierania
Dostawcy mogą używać
locations.fetchVerificationOptions
proszenie sprzedawców o wybranie preferowanej metody kontaktu z listy dostępnych
metod weryfikacji.
Aby pobrać opcje weryfikacji, użyj tych elementów:
POST https://mybusinessverifications.googleapis.com/v1/{locationId}:fetchVerificationOptions { "languageCode": "en" }
Rozpocznij proces weryfikacji.
Po wybraniu metody weryfikacji rozpocznij proces weryfikacji za pomocą
locations.verify
W wyniku tego połączenia lokalizacja zostaje zweryfikowana lub zwracany jest stan błędu.
POST https://mybusinessverifications.googleapis.com/v1/locations/{locationId} :verify // Use only one of the below verification methods // For postcard verification: { "method": "ADDRESS", "languageCode": "en", "addressInput": { "mailerContactName": "Ann Droyd" } } // For phone verification: { "method": "PHONE_CALL", "languageCode": "en", "phoneInput": { "phoneNumber": "800-555-0136" } } // For SMS verification: { "method": "SMS", "languageCode": "en", "phoneInput": { "phoneNumber": "800-555-0136" } } // For email verification: { "method": "EMAIL", "languageCode": "en", "emailInput": { "emailAddress": "ex@google.com" } }
Pobierz bieżące weryfikacje
locations.verifications.list
pobiera historię próśb o weryfikację wraz z ich stanem dla lokalizacji określonej w połączeniu.
Aby pobrać wszystkie prośby o weryfikację, użyj tych poleceń:
GET https://mybusinessverifications.googleapis.com/v1/locations/{locationId} /verifications
Ukończenie oczekującej weryfikacji
kod PIN oraz
locations.verifications.complete
jest zwykle wymagana do ukończenia weryfikacji firmy.
Aby zakończyć oczekującą weryfikację, wykonaj następujące czynności:
POST https://mybusinessverifications.googleapis.com/v1/locations/{locationId} /verifications/{verificationId}:complete { "pin": "123456" }
Sprawdzone metody weryfikacji w Profilu Firmy w Google za pomocą interfejsu API
Tworzenie lokalizacji
Za pomocą interfejsu API informacji o firmie Profil Firmy w Google możesz umieścić swoją platformę, aby umożliwić tworzenie lokalizacji. Gdy prosisz sprzedawców o dodanie nowej lokalizacji, wykonaj te czynności:
Zbieraj od sprzedawcy informacje o lokalizacji, takie jak nazwa firmy, adres i kategoria.
- Wywołaj punkt końcowy
googleLocations.search
. - W żądaniu do interfejsu API podaj dane o lokalizacji, takie jak nazwa firmy, kategoria, adres, numer telefonu i witryna.
Możesz też poszukać potencjalnej pasującej lokalizacji, wykonując te czynności:
- Zapytanie o możliwe dopasowania lokalizacji.
- Poproś sprzedawcę o wybranie prawidłowej lokalizacji.
- Jeśli w odpowiedzi na lokalizację występuje „
requestAdminRightsUrl
”, pomóż sprzedawcy poprosić o dostęp do tej lokalizacji i prawo własności do niej w Profilu Firmy w Google. - Jeśli obiekt
requestAdminRightsUrl
nie istnieje, utwórz nową lokalizację z identyfikatorem miejsca w odpowiedzi dotyczącej lokalizacji. - Zweryfikuj nową lokalizację.
Uwaga: jeśli z pierwszego zapytania nie ma żadnych możliwych dopasowań, wpisz pusty identyfikator miejsca, by utworzyć nową lokalizację. Następnie zweryfikuj nową lokalizację.
Weryfikacja lokalizacji
Aby rozpocząć proces weryfikacji za pomocą interfejsu Profil Firmy w Google:
- Wywołaj metodę
accounts.locations.list
, aby wyświetlić listę wszystkich lokalizacji na koncie Google. - Wybierz lokalizację do zweryfikowania.
- Wywołaj metodę interfejsu API
GetVoiceOfMerchant
, aby potwierdzić, czy dana lokalizacja wymaga weryfikacji. - Jeśli odpowiedź zwróci wartość „Zweryfikuj”, wywołaj
fetchVerificationOptions
, aby uzyskać listę dostępnych metod weryfikacji tej lokalizacji. - Dokładnie sprawdź, czy dane
verificationOption
zawierają prawidłowy adres, numer telefonu i adres e-mail. - Gdy robot wybierze najlepszą dostępną opcję weryfikacji, wywołaj metodę
locations.verify
, aby rozpocząć odpowiednią weryfikację. Aby potwierdzić, że inicjowanie jest w toku, zadzwoń pod numerlocations.verifications.list.
- Wywołaj metodę
locations.verification.complete
za pomocą kodu PIN sprzedawcy. - Wywołaj metodę interfejsu API
GetVoiceOfMerchant
. JeśliHasVoiceOfMerchant = true
, oznacza to, że lokalizacja została zweryfikowana.
Uwaga: jeśli dla danej lokalizacji dostępna jest weryfikacja na poziomie AUTO
, sprzedawca nie musi wykonywać żadnych czynności weryfikacyjnych.
Więcej informacji o weryfikacji Profilu Firmy w Google znajdziesz w tym artykule w Centrum pomocy.