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 merepresentasikan 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 mengirim kartu pos. Untuk metode lain, kolom ini harus sama dengan yang diteruskan ke locations.fetchVerificationOptions. INVALID_FILENAME akan ditampilkan jika kolom tersebut 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 ada berupa salah satu diantara 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 untuk mengirim PIN.

Alamat email hanya diterima jika merupakan salah satu alamat yang diberikan oleh locations.fetchverificationOptions. Jika EmailVerificationData memiliki isUserNameEditable yang ditetapkan ke benar (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 email.

PhoneInput

Input untuk verifikasi PHONE_CALL/SMS.

Representasi JSON 
{
  "phoneNumber": string
}
Kolom
phoneNumber

string

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