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 diisi. 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 diisi. Metode verifikasi.

languageCode

string

Opsional. Kode bahasa BCP 47 yang mewakili 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 mengirimkan kartu pos. Untuk metode lain, parameter ini harus sama dengan yang diteruskan ke GetVerificationOptions. 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:
emailAddress

string

Opsional. Input untuk metode EMAIL. Alamat email tujuan pengiriman PIN.

Alamat email hanya diterima jika merupakan salah satu alamat yang disediakan oleh locations.fetchVerificationOptions. Jika [EmailVerificationData] [google.mybusiness-verifications.v1.VerificationOption.EmailVerificationData] memiliki isUserNameEditable yang ditetapkan ke benar, 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 surat.

phoneNumber

string

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

token

object (VerificationToken)

Opsional. Input untuk metode VETTED_PARTNER yang tersedia untuk memilih partners. 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:

  • 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.