Zarządzanie weryfikacją

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

Pobieranie bieżącego stanu

Użytkownicy mogą zadzwonić pod numer locations.getVoiceOfMerchantState, aby uzyskać aktualny stan lokalizacji. Jeśli wartość logiczna hasVoiceOfMerchant wynosi true, lokalizacja jest już w dobrym stanie i nie trzeba podejmować żadnych dodatkowych działań. Jeśli jednak działanie gain_voice_of_merchant w odpowiedzi zawiera element verify, musisz przejść weryfikację. Aby dowiedzieć się więcej, wykonaj podane niżej instrukcje.

Pobieranie opcji 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, wykonaj te czynności:

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

{
  "languageCode": "en"
}

Rozpoczęcie procesu weryfikacji

Po wybraniu metody weryfikacji rozpocznij proces weryfikacji za pomocą locations.verify. W efekcie tego wywołania lokalizacja zostaje zweryfikowana lub zwracany jest stan błędu.

HTTP
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"
  }
}

Pobieranie bieżących weryfikacji

Zapytanie locations.verifications.list pobiera historię żądań weryfikacji wraz z ich stanem dla lokalizacji określonej w zapytaniu.

Aby pobrać wszystkie prośby o weryfikację:

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

Dokończenie weryfikacji oczekującej

Aby przejść weryfikację firmy, zwykle wymagany jest kod PIN i metoda locations.verifications.complete.

Aby dokończyć weryfikację oczekującą:

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 osadzić swoją platformę, aby udostępnić funkcję tworzenia lokalizacji. Gdy poprosisz sprzedawcę o dodanie nowej lokalizacji, wykonaj te czynności:

Poproś sprzedawcę o informacje o lokalizacji, takie jak nazwa firmy, adres i kategoria.

  1. Wywołaj punkt końcowy googleLocations.search.
  2. Podaj dane o lokalizacji, takie jak nazwa firmy, kategoria, adres, numer telefonu i strona internetowa w ramach żądania interfejsu API.

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

  1. Przesyłanie zapytania o możliwe dopasowania lokalizacji.
  2. Poproś sprzedawcę o wybranie właściwej lokalizacji.
  3. Jeśli w odpowiedzi na zapytanie o lokalizację występuje wartość requestAdminRightsUrl, pomóż sprzedawcy poprosić o dostęp do tej lokalizacji i uprawnienia właściciela w Profilu Firmy w Google.
  4. Jeśli requestAdminRightsUrl nie istnieje, utwórz nową lokalizację z identyfikatorem miejsca w odpowiedzi.
  5. Potwierdź nową lokalizację.

Uwaga: jeśli po początkowym zapytaniu nie znajdziesz żadnych możliwych dopasowań lokalizacji, użyj pustego identyfikatora miejsca, aby utworzyć nową lokalizację. Następnie zweryfikuj nową lokalizację.

Weryfikacja lokalizacji

Aby rozpocząć proces weryfikacji za pomocą interfejsu GBP API:

  1. Wywołaj metodę accounts.locations.list, aby wyświetlić wszystkie lokalizacje konta Google.
  2. Wybierz lokalizację, którą chcesz zweryfikować.
  3. Aby sprawdzić, czy dana lokalizacja wymaga weryfikacji, wywołaj metodę interfejsu API GetVoiceOfMerchant.
  4. Jeśli odpowiedź zweryfikuje, zadzwoń pod numer fetchVerificationOptions, aby uzyskać listę dostępnych metod 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, zadzwoń do niego, aby rozpocząć odpowiednią weryfikację.locations.verify Aby potwierdzić, że proces inicjowania jest w toku, zadzwoń pod numer locations.verifications.list..
  7. Wywołaj metodę locations.verification.complete, podając pin sprzedawcy.
  8. Wywołaj metodę interfejsu API GetVoiceOfMerchant. Jeśli HasVoiceOfMerchant = true, to oznacza, że lokalizacja została zweryfikowana.

Uwaga: jeśli dla lokalizacji dostępna jest weryfikacja AUTO, sprzedawca nie musi wykonywać żadnych kroków weryfikacyjnych.

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

Przewodnik po metodach weryfikacji dla zweryfikowanych partnerów