Method: accounts.locations.verify

Memulai proses verifikasi untuk lokasi.

Permintaan HTTP

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

URL menggunakan sintaksis gRPC Transcoding.

Parameter jalur

Parameter
name

string

Nama resource lokasi yang akan diverifikasi.

Isi permintaan

Isi permintaan memuat data dengan struktur berikut:

Representasi 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.
}
Kolom
method

enum (VerificationMethod)

Metode verifikasi.
languageCode

string

Kode bahasa BCP 47 yang mewakili bahasa yang akan digunakan untuk proses verifikasi.
context

object (ServiceBusinessContext)

Informasi konteks tambahan untuk verifikasi bisnis layanan. Diperlukan untuk lokasi yang jenis bisnisnya adalah CUSTOMER_LOCATION_ONLY. Untuk verifikasi ADDRESS, alamat akan digunakan untuk mengirimkan kartu pos. Untuk metode lain, parameter ini harus sama dengan metode yang diteruskan ke locations.fetchVerificationOptions. INVALID_ARGUMENT akan ditampilkan jika ditetapkan untuk jenis lokasi bisnis lain.
Kolom union RequestData. Data input pengguna untuk metode tertentu selain data tampilan. Data harus cocok dengan metode yang diminta. Biarkan kosong jika tidak ada data yang diperlukan. RequestData hanya dapat berupa salah satu dari berikut:
emailInput

object (EmailInput)

Input untuk metode EMAIL.
addressInput

object (AddressInput)

Input untuk metode ADDRESS.
phoneInput

object (PhoneInput)

Input untuk metode PHONE_CALL/SMS

Isi respons

Jika berhasil, isi respons memuat data dengan struktur berikut:

Pesan respons untuk Verifications.VerifyLocation.

Representasi JSON 
{
  "verification": {
    object (Verification)
  }
}
Kolom
verification

object (Verification)

Permintaan verifikasi yang dibuat.

Cakupan Otorisasi

Memerlukan salah satu cakupan OAuth berikut:

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

Untuk informasi selengkapnya, lihat Ringkasan OAuth 2.0.

EmailInput

Input untuk verifikasi EMAIL.

Representasi JSON 
{
  "emailAddress": string
}
Kolom
emailAddress

string

Alamat email tujuan pengiriman PIN.

Alamat email hanya diterima jika merupakan salah satu alamat yang disediakan oleh locations.fetchVerificationOptions. Jika EmailVerificationData memiliki isUserNameEditable yang ditetapkan ke true, klien dapat menentukan nama pengguna yang berbeda (bagian lokal), tetapi harus cocok dengan nama domain.

AddressInput

Input untuk verifikasi ADDRESS.

Representasi JSON 
{
  "mailerContactName": string
}
Kolom
mailerContactName

string

Nama kontak yang akan dikirimi surat.

PhoneInput

Input untuk verifikasi PHONE_CALL/SMS.

Representasi JSON 
{
  "phoneNumber": string
}
Kolom
phoneNumber

string

Nomor telepon yang akan dihubungi atau dikirimi SMS. Nomor ini harus berupa salah satu nomor telepon dalam opsi yang memenuhi syarat.