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

To pole jest 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)

To pole jest wymagane. Metoda weryfikacji.
languageCode

string

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

object (ServiceBusinessContext)

Opcjonalnie. Dodatkowe informacje kontekstowe na potrzeby weryfikacji firm świadczących usługi. Jest to wymagane 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 kartki pocztowej. W przypadku innych metod powinna być taka sama jak ta, która jest przekazywana do GetVerifyOptions. W przypadku innego typu lokalizacji firmy zostanie wysłane żądanie IARC_anie.
Pole sumy RequestData. Oprócz danych wyświetlanych przez użytkownika dane wejściowe związane z określoną metodą. Dane muszą być zgodne z żądaną metodą. Jeśli dane nie są potrzebne, 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 ma zostać wysłany kod PIN.

Adres e-mail jest akceptowany tylko wtedy, gdy jest to jeden z adresów podanych przez locations.fetchVerifyOptions. Jeśli w polu [EmailVerifyData] [google.mybusiness-verifications.v1.verificationOption.EmailVerifyData] jest ustawiona wartość [IsUserNameEditable], klient może podać inną nazwę użytkownika (część lokalną), ale musi być zgodna z nazwą domeny.
mailerContact

string

Opcjonalnie. Dane wejściowe metody ADDRESS. Nazwa kontaktu, do którego należy wysyłać pocztę.
phoneNumber

string

Opcjonalnie. Dane wejściowe metody PHONE_CALL/SMS Numer telefonu, na 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 metody VETTED_PARTNER są dostępne dla wybranych partners.. Dane wejściowe nie są potrzebne w przypadku zweryfikowanego konta. Token powiązany z lokalizacją. Token powiązany z lokalizacją.

Treść odpowiedzi

Odpowiedź na pytanie Weryfikacjas.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.