Zarządzanie weryfikacją

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:

HTTP
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.

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

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ń:

HTTP
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:

HTTP
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.

  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ż poszukać potencjalnej pasującej lokalizacji, wykonując te czynności:

  1. Zapytanie o możliwe dopasowania lokalizacji.
  2. Poproś sprzedawcę o wybranie prawidłowej lokalizacji.
  3. 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.
  4. Jeśli obiekt requestAdminRightsUrl nie istnieje, utwórz nową lokalizację z identyfikatorem miejsca w odpowiedzi dotyczącej lokalizacji.
  5. 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:

  1. Wywołaj metodę accounts.locations.list, aby wyświetlić listę wszystkich lokalizacji na koncie Google.
  2. Wybierz lokalizację do zweryfikowania.
  3. Wywołaj metodę interfejsu API GetVoiceOfMerchant, aby potwierdzić, czy dana lokalizacja wymaga weryfikacji.
  4. Jeśli odpowiedź zwróci wartość „Zweryfikuj”, wywołaj fetchVerificationOptions, aby uzyskać listę dostępnych metod weryfikacji tej lokalizacji.
  5. Dokładnie sprawdź, czy dane verificationOption zawierają prawidłowy adres, numer telefonu i adres e-mail.
  6. 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 numer locations.verifications.list.
  7. Wywołaj metodę locations.verification.complete za pomocą kodu PIN sprzedawcy.
  8. Wywołaj metodę interfejsu API GetVoiceOfMerchant. Jeśli HasVoiceOfMerchant = 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.

Przewodnik po metodach weryfikacji dla zweryfikowanych partnerów