Zarządzanie weryfikacją

Dostawcy, którzy oferują zarządzanie wizytówkami bezpośrednio na swojej platformie, mogą weryfikować firmę sprzedawcy w swojej witrynie. Dzięki temu nie trzeba przekierowywać sprzedawcy do interfejsu Profilu Firmy.

Pobieranie bieżącego stanu

Użytkownicy mogą wywołać metodę locations.getVoiceOfMerchantState w lokalizacji, aby pobrać jej bieżący stan. Jeśli wartość logiczna hasVoiceOfMerchant to true, lokalizacja jest już w dobrym stanie i nie musisz podejmować żadnych dodatkowych działań. Jeśli odpowiedź zawiera obiekt verify, musisz przejść weryfikację. Więcej informacji znajdziesz w instrukcjach w następnych sekcjach.

Pobierz opcje weryfikacji

Dostawcy mogą używać metody locations.fetchVerificationOptions, aby poprosić sprzedawców o wybranie preferowanej formy kontaktu z listy dostępnych metod weryfikacji.

Aby pobrać opcje weryfikacji, użyj tej metody:

HTTP
POST
https://mybusinessverifications.googleapis.com/v1/locations/{locationId}:fetchVerificationOptions

{
  "languageCode": "en"
}

Rozpoczynanie procesu weryfikacji

Po wybraniu metody weryfikacji rozpocznij proces weryfikacji za pomocą locations.verify. W wyniku tego wywołania lokalizacja zostanie zweryfikowana lub zostanie zwrócony stan błędu.

HTTP
POST
https://mybusinessverifications.googleapis.com/v1/locations/{locationId}:verify

// Use only one of the verification methods below

// For postcard verification:
{
  "method": "ADDRESS",
  "languageCode": "en",
  "mailerContact": "Ann Droyd"
}

// For phone verification:
{
  "method": "PHONE_CALL",
  "languageCode": "en",
  "phoneNumber": "800-555-0136"
}

// For SMS verification:
{
  "method": "SMS",
  "languageCode": "en",
  "phoneNumber": "800-555-0136"
}

// For email verification:
{
  "method": "EMAIL",
  "languageCode": "en",
  "emailAddress": "ex@google.com"
}

Pobieranie bieżących weryfikacji

Wywołanie locations.verifications.list pobiera historię próśb o weryfikację wraz z ich stanem dla lokalizacji określonej w wywołaniu.

Aby pobrać wszystkie prośby o weryfikację, użyj tego polecenia:

HTTP
GET
https://mybusinessverifications.googleapis.com/v1/locations/{locationId}
/verifications

Kończenie oczekującej weryfikacji

Do ukończenia weryfikacji firmy zwykle wymagany jest kod PIN i metoda locations.verifications.complete.

Aby dokończyć oczekującą weryfikację, użyj tych metod:

HTTP
POST
https://mybusinessverifications.googleapis.com/v1/locations/{locationId}
/verifications/{verificationId}:complete

{
  "pin": "123456"
}

Sprawdzone metody weryfikacji profilu firmy za pomocą interfejsu API

Tworzenie lokalizacji

Dzięki interfejsowi GBP Business Information API możesz umieścić swoją platformę, aby udostępnić funkcję tworzenia lokalizacji. Gdy prosisz sprzedawców o dodanie nowej lokalizacji, wykonaj te czynności:

Zbierz od sprzedawcy informacje o lokalizacji, takie jak nazwa firmy, adres i kategoria.

  1. Wywołaj punkt końcowy googleLocations.search.
  2. W żądaniu do interfejsu API podaj dane o lokalizacji, takie jak nazwa firmy, kategoria, adres, numer telefonu i witryna.

Możesz też wyszukać potencjalnie pasującą lokalizację, wykonując te czynności:

  1. Zapytanie o możliwe dopasowania lokalizacji.
  2. Poproś sprzedawcę o wybranie prawidłowej lokalizacji.
  3. Jeśli requestAdminRightsUri istnieje w dopasowanym GoogleLocation, pomóż sprzedawcy poprosić o dostęp do tej lokalizacji i uprawnienia właściciela w Profilu Firmy w Google.
  4. Jeśli requestAdminRightsUri nie istnieje, wywołaj accounts.locations.create, używając szczegółów location z dopasowanego GoogleLocation.
  5. Zweryfikuj nową lokalizację.

Uwaga: jeśli w wyniku początkowego zapytania nie otrzymasz żadnych możliwych dopasowań lokalizacji, wywołaj funkcję accounts.locations.create, podając szczegóły lokalizacji zebrane od sprzedawcy, a następnie zweryfikuj nową lokalizację.

Weryfikacja lokalizacji

Aby rozpocząć proces weryfikacji za pomocą interfejsu GBP API, wykonaj te czynności:

  1. Wywołaj metodę accounts.locations.list, aby wyświetlić listę wszystkich lokalizacji na koncie Google.
  2. Wybierz lokalizację, którą chcesz zweryfikować.
  3. Wywołaj metodę interfejsu API locations.getVoiceOfMerchantState, aby sprawdzić, czy ta lokalizacja wymaga weryfikacji.
  4. Jeśli odpowiedź zawiera verify, wywołaj locations.fetchVerificationOptions, aby uzyskać listę metod dostępnych do weryfikacji tej lokalizacji.
  5. Sprawdź, czy dane VerificationOption zawierają prawidłowy adres, numer telefonu i adres e-mail.
  6. Gdy sprzedawca wybierze najlepszą dostępną opcję weryfikacji, wywołaj metodę locations.verify, aby rozpocząć odpowiednią weryfikację. Aby sprawdzić, czy inicjowanie jest w toku, wywołaj metodę locations.verifications.list.
  7. Wywołaj metodę locations.verifications.complete, podając kod PIN sprzedawcy.
  8. Wywołaj metodę interfejsu API locations.getVoiceOfMerchantState. Jeśli hasVoiceOfMerchant to true, oznacza to, że lokalizacja została zweryfikowana.

Uwaga: jeśli w przypadku danej lokalizacji dostępna jest weryfikacja AUTO, sprzedawca nie musi wykonywać żadnych czynności weryfikacyjnych.

Więcej informacji o weryfikacji Profilu Firmy znajdziesz w artykule pomocy w Centrum pomocy.