Zarządzanie weryfikacją

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

Pobierz bieżący stan

Użytkownicy mogą wywołać funkcję locations.getVoiceOfMerchantState dotyczącą lokalizacji, aby sprawdzić jej bieżący stan. Jeśli wartość logiczna hasVoiceOfMerchant to true, oznacza to, że lokalizacja ma już dobrą opinię i nie musisz nic robić. W przeciwnym razie, jeśli działanie gain_voice_of_merchant w odpowiedzi zawiera parametr verify, musisz ukończyć weryfikację. Aby uzyskać więcej informacji, postępuj zgodnie z instrukcjami poniżej.

Opcje weryfikacji pobierania

Dostawcy mogą używać metody locations.fetchVerificationOptions, aby prosić 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 w: locations.verify. W wyniku tego wywołania lokalizacja przechodzi do stanu zweryfikowanego 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

Wywołanie locations.verifications.list pobiera historię próśb o weryfikację wraz z ich stanem dla lokalizacji podanej w połączeniu.

Aby pobrać wszystkie żądania weryfikacji, użyj tego polecenia:

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

Przeprowadzanie weryfikacji oczekującej

Do zakończenia weryfikacji firmy zwykle wymagane są podanie kodu PIN i użycie metody locations.verifications.complete.

Aby ukończyć oczekującą weryfikację, wykonaj te czynności:

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

{
  "pin": "123456"
}

Sprawdzone metody weryfikacji profilu Profil Firmy w Google za pomocą interfejsu API

Tworzenie lokalizacji

Za pomocą interfejsu Profil Firmy w Google możesz umieścić swoją platformę, aby udostępnić funkcję tworzenia lokalizacji. Gdy poprosisz sprzedawców o dodanie nowej lokalizacji, wykonaj te czynności:

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

  1. Wywołaj punkt końcowy googleLocations.search.
  2. Podaj w żądaniu do interfejsu API 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. Zapytania dotyczące możliwych dopasowań lokalizacji.
  2. Poproś sprzedawcę o wybranie prawidłowej lokalizacji.
  3. Jeśli w odpowiedzi dotyczącej lokalizacji znajduje się requestAdminRightsUrl, pomóż sprzedawcy poprosić o dostęp do tej lokalizacji i prawa własności do niej w Profilu Firmy w Google.
  4. Jeśli requestAdminRightsUrl nie istnieje, utwórz nową lokalizację z identyfikatorem miejsca w odpowiedzi na temat lokalizacji.
  5. Zweryfikuj nową lokalizację.

Uwaga: jeśli po pierwszym zapytaniu nie uda się znaleźć żadnych pasujących lokalizacji, utwórz nową lokalizację, używając pustego identyfikatora miejsca. 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 powiązane z kontem Google.
  2. Wybierz lokalizację do zweryfikowania.
  3. Wywołaj metodę interfejsu API GetVoiceOfMerchant, aby sprawdzić, czy lokalizacja wymaga weryfikacji.
  4. Jeśli odpowiedź zwraca weryfikację, wywołaj fetchVerificationOptions, aby uzyskać listę dostępnych metod weryfikacji lokalizacji.
  5. Dokładnie sprawdź, czy dane verificationOption zawierają prawidłowy adres, numer telefonu i adres e-mail.
  6. Gdy mechant wybierze najlepszą dostępną opcję weryfikacji, wywołaj metodę locations.verify, aby zainicjować odpowiednią weryfikację. Aby potwierdzić, że trwa inicjowanie, wywołaj funkcję locations.verifications.list.
  7. Wywołaj metodę locations.verification.complete, używając kodu PIN sprzedawcy.
  8. Wywołaj metodę GetVoiceOfMerchant interfejsu API. Jeśli HasVoiceOfMerchant = true, lokalizacja została zweryfikowana.

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

Więcej informacji o weryfikacji w usłudze Profil Firmy w Google znajdziesz w tym artykule w Centrum pomocy.

Przewodnik po metodach weryfikacji dla zweryfikowanych partnerów