Method: locations.verify

Rozpoczyna proces weryfikacji lokalizacji.

Żądanie HTTP

POST https://mybusinessverifications.googleapis.com/v1/{name=locations/*}:verify

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
name

string

Wymagane. Nazwa zasobu lokalizacji, którą chcesz zweryfikować.

Treść żądania

Treść żądania zawiera dane o następującej strukturze:

Zapis JSON 
{
  "method": enum (VerificationMethod),
  "languageCode": string,
  "context": {
    object (ServiceBusinessContext)
  },

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "emailAddress": string,
  "mailerContact": string,
  "phoneNumber": string,
  "token": {
    object (VerificationToken)
  },
  "trustedPartnerToken": string
  // End of mutually exclusive fields.
}
Pola
method

enum (VerificationMethod)

Wymagane. Metoda weryfikacji.
languageCode

string

Opcjonalnie. Kod języka BCP 47 reprezentujący język, który ma być używany w procesie weryfikacji.
context

object (ServiceBusinessContext)

Opcjonalnie. Dodatkowe informacje kontekstowe dotyczące weryfikacji firm usługowych. Jest on wymagany tylko w przypadku lokalizacji, których typ działalności to CUSTOMER_LOCATION_ONLY. W przypadku weryfikacji ADRESU adres zostanie użyty do wysłania pocztówki. W przypadku innych metod powinien być taki sam jak ten przekazywany do GetVerificationOptions. Jeśli zostanie ustawiony dla innych typów lokalizacji firmy, zostanie zwrócony błąd INVALID_ARGUMENT.
Dane wejściowe użytkownika dotyczące konkretnej metody oprócz danych wyświetlanych. Dane muszą być zgodne z wybraną metodą. Jeśli nie potrzebujesz żadnych danych, pozostaw to pole puste. Poniżej znajduje się lista pól, które wykluczają się nawzajem. W odpowiedzi zostanie ustawione co najwyżej jedno z tych pól:
emailAddress

string

Opcjonalnie. Dane wejściowe dla metody EMAIL. Adres e-mail, na który ma zostać wysłany kod PIN.

Adres e-mail jest akceptowany tylko wtedy, gdy jest jednym z adresów podanych przez locations.fetchVerificationOptions. Jeśli parametr [EmailVerificationData] [google.mybusiness-verifications.v1.VerificationOption.EmailVerificationData] ma wartość isUserNameEditable ustawioną na „true”, klient może podać inną nazwę użytkownika (część lokalną), ale musi ona pasować do nazwy domeny.
mailerContact

string

Opcjonalnie. Dane wejściowe metody ADDRESS. Imię i nazwisko osoby, do której ma zostać wysłana poczta.
phoneNumber

string

Opcjonalnie. Dane wejściowe dla metody PHONE_CALL/SMS. Numer telefonu, na który należy zadzwonić lub wysłać SMS-a. Musi to być jeden z numerów telefonów podanych w dostępnych opcjach.
token

object (VerificationToken)

Opcjonalnie. Dane wejściowe metody VETTED_PARTNER dostępne dla wybranych partnerów. W przypadku konta zweryfikowanego te dane wejściowe nie są potrzebne. Token powiązany z lokalizacją. Token powiązany z lokalizacją.
trustedPartnerToken

string

Dane wejściowe metody TRUSTED_PARTNER. Token weryfikacyjny powiązany z lokalizacją.
Koniec pól wykluczających się wzajemnie.

Treść odpowiedzi

Komunikat odpowiedzi dla Verifications.VerifyLocation.

W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:

Zapis JSON 
{
  "verification": {
    object (Verification)
  }
}
Pola
verification

object (Verification)

Utworzona prośba o weryfikację.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

  • https://www.googleapis.com/auth/business.manage

Więcej informacji znajdziesz w OAuth 2.0 Overview.

VerificationToken

Token wygenerowany przez sprawdzonego partnera.

Zapis JSON 
{
  "tokenString": string
}
Pola
tokenString

string

Ciąg znaków tokena.