Method: locations.verify

Memulai proses verifikasi untuk lokasi.

Permintaan HTTP

POST https://mybusinessverifications.googleapis.com/v1/{name=locations/*}:verify

URL menggunakan sintaksis gRPC Transcoding.

Parameter jalur

Parameter
name

string

Wajib. 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:
  "emailAddress": string,
  "mailerContact": string,
  "phoneNumber": string,
  "token": {
    object (VerificationToken)
  }
  // End of list of possible types for union field RequestData.
}
Kolom
method

enum (VerificationMethod)

Wajib. Metode verifikasi.
languageCode

string

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

object (ServiceBusinessContext)

Opsional. Informasi konteks tambahan untuk verifikasi bisnis layanan. Kolom ini hanya 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 GetVerifikasiOptions. 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:
emailAddress

string

Opsional. Input untuk metode EMAIL. Alamat email untuk mengirim PIN.

Alamat email hanya diterima jika merupakan salah satu alamat yang diberikan oleh locations.fetchverificationOptions. Jika [EmailVerifikasiData] [google.mybusiness-verifications.v1.VerifyOption.EmailVerificationData] memiliki isUserNameEditable yang ditetapkan ke true, klien dapat menentukan nama pengguna yang berbeda (bagian lokal), tetapi harus cocok dengan nama domain.
mailerContact

string

Opsional. Input untuk metode ADDRESS. Nama kontak yang akan dikirimi email.
phoneNumber

string

Opsional. Input untuk metode PHONE_CALL/SMS Nomor telepon yang akan dihubungi atau dikirimi SMS. Nomor telepon harus berupa salah satu nomor telepon dalam opsi yang memenuhi syarat.
token

object (VerificationToken)

Opsional. Input untuk metode VETTED_PARTNER tersedia untuk partners. yang dipilih. Input tidak diperlukan untuk akun terverifikasi. Token yang terkait dengan lokasi. Token yang terkait dengan lokasi.

Isi respons

Pesan respons untuk Verifications.VerifyLocation.

Jika berhasil, isi respons memuat data dengan struktur berikut:

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

object (Verification)

Permintaan verifikasi yang dibuat.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut ini:

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

Untuk informasi selengkapnya, lihat Ringkasan OAuth 2.0.

VerificationToken

Token yang dibuat oleh partner terverifikasi.

Representasi JSON 
{
  "tokenString": string
}
Kolom
tokenString

string

String token.