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, 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)
  },

  // 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, który reprezentuje język używany w procesie weryfikacji.
context

object (ServiceBusinessContext)

Dodatkowe informacje kontekstowe na potrzeby weryfikacji firm usługowych. Wymagany w przypadku lokalizacji, których typ działalności to CUSTOMER_LOCATION_ONLY. W przypadku weryfikacji ADRESU adres będzie używany do wysyłania pocztówek. W przypadku innych metod powinna być taka sama jak ta, która jest przekazywana do funkcji locations.fetchVerificationOptions. Jeśli jest ustawiony dla innych typów lokalizacji firmy, zostanie zwrócony błąd INVALID_ARGUMENT.
Pole unii RequestData. Dane wprowadzane przez użytkownika w przypadku określonej metody oprócz danych wyświetlania. Dane muszą być zgodne z żądaną metodą. Pozostaw je puste, jeśli nie są potrzebne żadne dane. 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 dla 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)

Utworzona prośba 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 OAuth 2.0.

EmailInput

Dane do weryfikacji adresu e-mail.

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 jednym z adresów podanych przez locations.fetchVerificationOptions. Jeśli parametr EmailVerificationData ma wartość true (prawda) dla parametru isUserNameEditable, klient może podać inną nazwę użytkownika (część lokalna), ale musi ona pasować do nazwy domeny.

AddressInput

Dane do weryfikacji ADDRESS.

Zapis JSON 
{
  "mailerContactName": string
}
Pola
mailerContactName

string

Nazwa kontaktu, do którego ma zostać wysłana wiadomość.

PhoneInput

Dane wejściowe do weryfikacji za pomocą PHONE_CALL lub SMS-a.

Zapis JSON 
{
  "phoneNumber": string
}
Pola
phoneNumber

string

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