Zarządzanie weryfikacją

Usługodawcy, którzy oferują zarządzanie wizytówkami bezpośrednio na swojej platformie, mogą weryfikować firmy sprzedawców w swojej witrynie. Eliminuje to konieczność przekierowywania sprzedawcy do interfejsu Profilu Firmy.

Pobieranie bieżącego stanu

Użytkownicy mogą zadzwonić pod numer locations.getVoiceOfMerchantState, aby sprawdzić aktualny stan lokalizacji. Jeśli wartość logiczna hasVoiceOfMerchant true to true, oznacza to, że lokalizacja jest już w dobrym stanie i nie wymaga żadnych dodatkowych działań. W przeciwnym razie, jeśli działanie gain_voice_of_merchant w odpowiedzi zawiera verify, musisz przejść weryfikację. Więcej informacji znajdziesz w instrukcjach poniżej.

Pobieranie opcji weryfikacji

Dostawcy mogą używać metody locations.fetchVerificationOptions do wyświetlania sprzedawcom prośby o wybranie preferowanej formy kontaktu z listy dostępnych metod weryfikacji.

Aby pobrać opcje weryfikacji, użyj tego kodu:

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

{
  "languageCode": "en"
}

rozpocząć proces weryfikacji;

Po wybraniu metody weryfikacji rozpocznij proces weryfikacji za pomocą locations.verify. W wyniku tego wywołania lokalizacja przechodzi w stan zweryfikowany 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

Wywołanie locations.verifications.list pobiera historię próśb o weryfikację wraz z ich stanem w przypadku 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

Dokończ weryfikację oczekującą

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

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

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

{
  "pin": "123456"
}

Sprawdzone metody weryfikacji Profilu Firmy w Google za pomocą interfejsu API

Tworzenie lokalizacji

Dzięki interfejsowi API informacji o firmie w Profilu Firmy w Google możesz zintegrować swoją platformę, aby udostępniać funkcję tworzenia lokalizacji. Gdy prosisz sprzedawców o dodanie nowej lokalizacji, wykonaj te czynności:

Zbieranie od sprzedawcy informacji o lokalizacji, takich jak nazwa firmy, adres i kategoria.

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

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

  1. Wyszukiwanie możliwych dopasowań lokalizacji.
  2. Poproś sprzedawcę o wybranie prawidłowej lokalizacji.
  3. Jeśli w odpowiedzi dotyczącej lokalizacji występuje requestAdminRightsUrl, pomóż sprzedawcy poprosić o dostęp do tej lokalizacji i o przyznanie do niej praw w Profilu Firmy w Google.
  4. Jeśli requestAdminRightsUrl nie istnieje, utwórz nową lokalizację z identyfikatorem miejsca w odpowiedzi dotyczącej lokalizacji.
  5. Zweryfikuj nową lokalizację.

Uwaga: jeśli w wyniku początkowego zapytania nie otrzymasz ż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, wykonaj te czynności:

  1. Aby wyświetlić listę wszystkich lokalizacji na koncie Google, wywołaj metodę accounts.locations.list.
  2. Wybierz lokalizację, którą chcesz zweryfikować.
  3. Wywołaj metodę interfejsu API GetVoiceOfMerchant, aby sprawdzić, czy ta lokalizacja wymaga weryfikacji.
  4. Jeśli odpowiedź to „verify”, zadzwoń pod numer fetchVerificationOptions, aby uzyskać listę metod weryfikacji tej lokalizacji.
  5. Sprawdź dokładnie, czy verificationOption dane 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 potwierdzić, że inicjowanie jest w toku, zadzwoń pod numer locations.verifications.list.
  7. Wywołaj metodę locations.verification.complete z kodem PIN sprzedawcy.
  8. Wywołaj metodę interfejsu API GetVoiceOfMerchant. Jeśli HasVoiceOfMerchant = true, lokalizacja została zweryfikowana.

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

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