Method: accounts.locations.verify

Rozpoczyna proces weryfikacji lokalizacji.

Żądanie HTTP

POST https://mybusiness.googleapis.com/v4/{name=accounts/*/locations/*}:verify

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
name

string

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:
  "emailInput": {
    object (EmailInput)
  },
  "addressInput": {
    object (AddressInput)
  },
  "phoneInput": {
    object (PhoneInput)
  }
  // End of list of possible types for union field RequestData.
}
Pola
method

enum (VerificationMethod)

Metoda weryfikacji.
languageCode

string

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

object (ServiceBusinessContext)

Dodatkowe informacje kontekstowe na potrzeby weryfikacji firm świadczących usługi. Wymagane dla 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 lokalizacji.fetchWeryfikacjaOptions. 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:
emailInput

object (EmailInput)

Dane wejściowe metody EMAIL.
addressInput

object (AddressInput)

Dane wejściowe metody ADDRESS.
phoneInput

object (PhoneInput)

Dane wejściowe metody PHONE_CALL/SMS

Treść odpowiedzi

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

Odpowiedź na pytanie Weryfikacjas.VerifyLocation.

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

object (Verification)

Utworzono prośbę o weryfikację.

Zakresy autoryzacji

Wymaga jednego z tych zakresów OAuth:

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

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

EmailInput

Pole do weryfikacji EMAIL.

Zapis JSON 
{
  "emailAddress": string
}
Pola
emailAddress

string

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 zasada EmailVerificationData ma wartość Prawda, klient może podać inną nazwę użytkownika (część lokalna), ale musi być zgodna z nazwą domeny.

AddressInput

Pole do weryfikacji ADRESU.

Zapis JSON 
{
  "mailerContactName": string
}
Pola
mailerContactName

string

Nazwa kontaktu, do którego należy wysyłać pocztę.

PhoneInput

Pole do weryfikacji PHONE_CALL/SMS.

Zapis JSON 
{
  "phoneNumber": string
}
Pola
phoneNumber

string

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.