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 reprezentujący język, który ma zostać użyty w procesie weryfikacji.
context

object (ServiceBusinessContext)

Dodatkowe informacje kontekstowe potrzebne do weryfikacji firm usługowych. Wymagane dla 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 powinna być taka sama jak ta przesyłana do locations.fetchverifyOptions. 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:
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:

Komunikat z odpowiedzią na potrzeby weryfikacjis.VerifyLocation.

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

object (Verification)

Utworzono prośbę o weryfikację.

Zakresy autoryzacji

Wymaga jednego z tych zakresów protokołu 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 na weryfikację adresu EMAIL.

Zapis JSON 
{
  "emailAddress": string
}
Pola
emailAddress

string

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

AddressInput

Dane wejściowe weryfikacji adresu ADDRESS.

Zapis JSON 
{
  "mailerContactName": string
}
Pola
mailerContactName

string

Osoba kontaktowa, do której ma zostać wysłany e-mail.

PhoneInput

Dane wejściowe weryfikacji PHONE_CALL/SMS.

Zapis JSON 
{
  "phoneNumber": string
}
Pola
phoneNumber

string

Numer telefonu, pod który należy zadzwonić lub na który należy wysłać SMS-a. Musi to być jeden z numerów telefonu dostępnych w odpowiednich opcjach.