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 do zweryfikowania.

Treść żądania

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

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

  // Union field RequestData can be only one of the following:
  "emailAddress": string,
  "mailerContact": string,
  "phoneNumber": string,
  "token": {
    object (VerificationToken)
  }
  // End of list of possible types for union field RequestData.
}
Pola
method

enum (VerificationMethod)

Wymagane. Metoda weryfikacji.
languageCode

string

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

object (ServiceBusinessContext)

Opcjonalnie: Dodatkowe informacje kontekstowe potrzebne do weryfikacji firm usługowych. Jest wymagany tylko w przypadku lokalizacji, których rodzaj działalności to CUSTOMER_LOCATION_ONLY. W przypadku weryfikacji ADDRESS użyjemy adresu, aby wysłać pocztówkę. W przypadku innych metod powinien być taki sam jak ta, która jest przekazywana do GetverificationOptions. Jeśli dla innych typów lokalizacji firmy jest ustawiona wartość INVALID_AR, zostanie ona zgłoszona.
Pole sumy RequestData. Oprócz danych wyświetlanych dane wejściowe użytkownika dotyczące określonej metody Dane muszą być zgodne z żądaną metodą. Jeśli nie są potrzebne żadne dane, pozostaw to pole puste. RequestData może mieć tylko jedną z tych wartości:
emailAddress

string

Opcjonalnie: Dane wejściowe metody EMAIL. Adres e-mail, na który należy wysłać kod PIN.

Adres e-mail jest akceptowany tylko wtedy, gdy jest to jeden z adresów podanych przez locations.fetchverifyOptions. Jeśli [EmailverificationData] [google.mybusiness-verifications.v1.verificationOption.EmailverificationData] ma wartość isUserNameEditable ustawioną na true. Klient może określić inną nazwę użytkownika (local-part), ale musi być zgodna z nazwą domeny.
mailerContact

string

Opcjonalnie: Dane wejściowe metody ADDRESS. Osoba kontaktowa, do której ma zostać wysłany e-mail.
phoneNumber

string

Opcjonalnie: Dane wejściowe metody PHONE_CALL/SMS Numer telefonu, pod który należy zadzwonić lub na który ma zostać wysłany SMS. Musi to być jeden z numerów telefonu dostępnych w odpowiednich opcjach.
token

object (VerificationToken)

Opcjonalnie: Dane wejściowe dla metody VETTED_PARTNER dostępne dla wybranych partnerów. W przypadku zweryfikowanego konta ta metoda nie jest potrzebna. Token powiązany z lokalizacją. Token powiązany z lokalizacją.

Treść odpowiedzi

Komunikat z odpowiedzią na potrzeby weryfikacjis.VerifyLocation.

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

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

object (Verification)

Utworzono prośbę o weryfikację.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Więcej informacji znajdziesz w artykule Omówienie protokołu OAuth 2.0.

VerificationToken

Token wygenerowany przez zweryfikowanego partnera.

Zapis JSON 
{
  "tokenString": string
}
Pola
tokenString

string

Ciąg tokena.