Method: locations.verify

Memulai proses verifikasi untuk lokasi.

Permintaan HTTP

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

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

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "emailAddress": string,
  "mailerContact": string,
  "phoneNumber": string,
  "token": {
    object (VerificationToken)
  },
  "trustedPartnerToken": string
  // End of mutually exclusive fields.
}
Kolom
method

enum (VerificationMethod)

Wajib. 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 jasa. Atribut ini hanya diperlukan untuk lokasi yang jenis bisnisnya adalah CUSTOMER_LOCATION_ONLY. Untuk verifikasi ALAMAT, alamat akan digunakan untuk mengirim kartu pos. Untuk metode lain, metode ini harus sama dengan yang diteruskan ke GetVerificationOptions. INVALID_ARGUMENT akan ditampilkan jika ditetapkan untuk jenis lokasi bisnis lainnya.

Data input pengguna untuk metode tertentu selain data tampilan. Data harus cocok dengan metode yang diminta. Biarkan kosong jika tidak ada data yang diperlukan. Berikut adalah daftar kolom yang saling eksklusif. Maksimal satu kolom akan ditetapkan dalam respons:
emailAddress

string

Opsional. Input untuk metode EMAIL. Alamat email yang akan dikirimi 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 (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 harus dihubungi atau dikirimi SMS. Nomor telepon harus merupakan salah satu nomor telepon dalam opsi yang memenuhi syarat.

token

object (VerificationToken)

Opsional. Input untuk metode VETTED_PARTNER tersedia untuk partner tertentu. Input tidak diperlukan untuk akun yang telah diperiksa. Token yang terkait dengan lokasi. Token yang terkait dengan lokasi.

trustedPartnerToken

string

Input untuk metode TRUSTED_PARTNER Token verifikasi yang terkait dengan lokasi.

Akhir kolom yang saling eksklusif.

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 mengetahui informasi selengkapnya, lihat OAuth 2.0 Overview.

VerificationToken

Token yang dibuat oleh partner yang telah diperiksa.

Representasi JSON
{
  "tokenString": string
}
Kolom
tokenString

string

String token.