Package google.mybusiness.verifications.v1

Indeks

Verifikasi

API ini memungkinkan pengelolaan verifikasi Lokasi di Google. Dengan begitu, Anda dapat mengelola resource [Verifikasi] [google.mybusiness.v1.verification].

Setiap [Lokasi] [google.mybusiness.businessinformation.locations.v1.Location] memiliki kumpulan resource [Verifikasi] [google.mybusiness.verifications], yang bernama locations/*/verifications/*.

CompleteVerification

rpc CompleteVerification(CompleteVerificationRequest) returns (CompleteVerificationResponse)

Menyelesaikan verifikasi PENDING.

Ini hanya diperlukan untuk metode verifikasi non-AUTO. Permintaan verifikasi AUTO langsung VERIFIED saat pembuatan.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut ini:

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

Untuk informasi selengkapnya, lihat Ringkasan OAuth 2.0.
FetchVerificationOptions

rpc FetchVerificationOptions(FetchVerificationOptionsRequest) returns (FetchVerificationOptionsResponse)

Melaporkan semua opsi verifikasi yang memenuhi syarat untuk lokasi dalam bahasa tertentu.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut ini:

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

Untuk informasi selengkapnya, lihat Ringkasan OAuth 2.0.
ListVerifications

rpc ListVerifications(ListVerificationsRequest) returns (ListVerificationsResponse)

Menampilkan daftar verifikasi lokasi, yang diurutkan berdasarkan waktu pembuatan.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut ini:

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

Untuk informasi selengkapnya, lihat Ringkasan OAuth 2.0.
VerifyLocation

rpc VerifyLocation(VerifyLocationRequest) returns (VerifyLocationResponse)

Memulai proses verifikasi untuk lokasi.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut ini:

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

Untuk informasi selengkapnya, lihat Ringkasan OAuth 2.0.

VoiceOfMerchant

Layanan ini memungkinkan pengguna pihak ketiga meminta detail terkait status voice of merchant.

GetVoiceOfMerchantState

rpc GetVoiceOfMerchantState(GetVoiceOfMerchantStateRequest) returns (VoiceOfMerchantState)

Mendapatkan status VoiceOfMerchant.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut ini:

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

Untuk informasi selengkapnya, lihat Ringkasan OAuth 2.0.

CompleteVerificationRequest

Pesan permintaan untuk Verifications.CompleteverificationAction.

Kolom
name

string

Wajib. Nama resource verifikasi yang akan diselesaikan.
pin

string

Wajib. Kode PIN yang diterima oleh penjual untuk menyelesaikan verifikasi.

CompleteVerificationResponse

Pesan respons untuk Verifications.CompleteverificationAction.

Kolom
verification

Verification

Verifikasi yang telah selesai.

ComplyWithGuidelines

Menunjukkan bahwa lokasi tidak mematuhi panduan kami.

Kolom
recommendation_reason

RecommendationReason

Alasan lokasi tersebut direkomendasikan untuk mematuhi pedoman.

RecommendationReason

Menunjukkan alasan lokasi direkomendasikan menurut Mematuhi Pedoman.

Enum
RECOMMENDATION_REASON_UNSPECIFIED Tidak ditentukan.
BUSINESS_LOCATION_SUSPENDED Lokasi bisnis ditangguhkan. Untuk memperbaiki masalah ini, baca artikel Pusat Bantuan.
BUSINESS_LOCATION_DISABLED Lokasi bisnis dinonaktifkan. Untuk memperbaiki masalah ini, baca artikel Pusat Bantuan.

FetchVerificationOptionsRequest

Pesan permintaan untuk Verifications.FetchverificationOptions.

Kolom
location

string

Wajib. Lokasi yang akan diverifikasi.
language_code

string

Wajib. Kode bahasa BCP 47 yang merepresentasikan bahasa yang akan digunakan untuk proses verifikasi. Opsi yang tersedia bervariasi berdasarkan bahasa.
context

ServiceBusinessContext

Opsional. Informasi konteks tambahan untuk verifikasi bisnis layanan. Hanya dapat diterapkan ke lokasi yang jenis bisnisnya adalah CUSTOMER_LOCATION_ONLY. Menentukan alamat yang akurat dapat mengaktifkan lebih banyak opsi. INVALID_ ARGUMENT akan ditampilkan jika kolom ini ditetapkan untuk jenis lokasi bisnis lain.

FetchVerificationOptionsResponse

Pesan respons untuk Verifications.FetchVerificationOptions.

Kolom
options[]

VerificationOption

Opsi verifikasi yang tersedia.

GetVoiceOfMerchantStateRequest

Pesan permintaan untuk VoiceOfMerchant.GetVoiceOfMerchantState.

Kolom
name

string

Wajib. Nama resource lokasi.

ListVerificationsRequest

Pesan permintaan untuk Verifications.Listverifications.

Kolom
parent

string

Wajib. Nama resource lokasi yang memiliki permintaan verifikasi.
page_size

int32

Berapa banyak verifikasi yang akan disertakan per halaman. Ukuran halaman minimum adalah 1, serta ukuran halaman default dan maksimum adalah 100.
page_token

string

Jika ditentukan, menampilkan halaman verifikasi berikutnya.

ListVerificationsResponse

Pesan respons untuk Verifications.Listverifications.

Kolom
verifications[]

Verification

Daftar verifikasi.
next_page_token

string

Jika jumlah verifikasi melebihi ukuran halaman yang diminta, kolom ini akan diisi dengan token untuk mengambil halaman verifikasi berikutnya pada panggilan berikutnya. Jika tidak ada atribut lagi, kolom ini tidak akan ada dalam respons.

ResolveOwnershipConflict

Jenis ini tidak memiliki kolom.

Menunjukkan bahwa lokasi tersebut menduplikasi lokasi lain yang memiliki reputasi baik.

ServiceBusinessContext

Data tambahan untuk verifikasi bisnis layanan.

Kolom
address

PostalAddress

Alamat verifikasi lokasi. Kunci ini digunakan untuk memungkinkan lebih banyak opsi verifikasi atau mengirim kartu pos.

Verifikasi

Verifikasi merepresentasikan upaya verifikasi pada lokasi.

Kolom
name

string

Nama resource verifikasi.
method

VerificationMethod

Metode verifikasi.
state

State

Status verifikasi.
create_time

Timestamp

Stempel waktu saat verifikasi diminta.
announcement

string

Opsional. Pengumuman respons hanya disetel jika metodenya adalah VETTED_PARTNER.

Negara Bagian

Semua kemungkinan status verifikasi.

Enum
STATE_UNSPECIFIED Nilai default akan menghasilkan error.
PENDING Verifikasi tertunda.
COMPLETED Verifikasi selesai.
FAILED Verifikasi gagal.

VerificationMethod

Menentukan proses yang digunakan oleh Google untuk memverifikasi lokasi.

Enum
VERIFICATION_METHOD_UNSPECIFIED Nilai default akan menghasilkan error.
ADDRESS Kirim kartu pos dengan PIN verifikasi ke alamat surat tertentu. PIN digunakan untuk menyelesaikan verifikasi dengan Google.
EMAIL Kirim email dengan PIN verifikasi ke alamat email tertentu. PIN digunakan untuk menyelesaikan verifikasi dengan Google.
PHONE_CALL Lakukan panggilan telepon dengan PIN verifikasi ke nomor telepon tertentu. PIN digunakan untuk menyelesaikan verifikasi dengan Google.
SMS Kirim SMS dengan PIN verifikasi ke nomor telepon tertentu. PIN digunakan untuk menyelesaikan verifikasi dengan Google.
AUTO Verifikasi lokasi tanpa tindakan pengguna tambahan. Opsi ini mungkin hanya tersedia untuk lokasi tertentu.
VETTED_PARTNER Opsi ini mungkin hanya tersedia untuk lokasi tertentu.

VerificationOption

Opsi verifikasi merepresentasikan cara memverifikasi lokasi (yang ditunjukkan dengan metode verifikasi) dan tempat verifikasi akan dikirim (yang ditunjukkan dengan data tampilan).

Kolom
verification_method

VerificationMethod

Metode untuk memverifikasi lokasi.
Kolom union DisplayData. Salah satu data tampilan. Data harus cocok dengan metode. Kosong jika metode yang sesuai tidak memiliki data tampilan. DisplayData hanya ada berupa salah satu diantara berikut:
phone_number

string

Tetapkan hanya jika metode adalah PHONE_CALL atau SMS. Nomor telepon yang akan dikirimi PIN.
address_data

AddressVerificationData

Tetapkan hanya jika metodenya adalah EMAIL.
email_data

EmailVerificationData

Tetapkan hanya jika metode adalah EMAIL.
announcement

string

Tetapkan hanya jika metode adalah VETTED_PARTNER.

AddressVerificationData

Menampilkan data untuk verifikasi melalui kartu pos.

Kolom
business

string

Nama bisnis penjual.
address

PostalAddress

Alamat yang dapat dikirimi kartu pos.
expected_delivery_days_region

int32

Perkiraan jumlah hari yang diperlukan untuk mengirimkan kartu pos ke wilayah alamat.

EmailVerificationData

Data tampilan untuk verifikasi melalui email.

Kolom
domain

string

Nama domain di alamat email. mis. "gmail.com" di foo@gmail.com
user

string

Nama pengguna di alamat email. mis. "foo" di foo@gmail.com
is_user_name_editable

bool

Apakah klien diizinkan untuk memberikan nama pengguna yang berbeda atau tidak.

VerificationToken

Token yang dibuat oleh partner terverifikasi.

Kolom
token_string

string

String token.

Verifikasi

Menunjukkan bahwa lokasi memerlukan verifikasi. Berisi informasi tentang tindakan verifikasi saat ini yang dilakukan di lokasi.

Kolom
has_pending_verification

bool

Menunjukkan apakah proses verifikasi sudah dimulai, dan dapat diselesaikan oleh lokasi.

VerifyLocationRequest

Pesan permintaan untuk Verifications.VerifyLocation.

Kolom
name

string

Wajib. Nama resource lokasi yang akan diverifikasi.
method

VerificationMethod

Wajib. Metode verifikasi.
language_code

string

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

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:
email_address

string

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

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

string

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

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

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.

VerifyLocationResponse

Pesan respons untuk Verifications.VerifyLocation.

Kolom
verification

Verification

Permintaan verifikasi yang dibuat.

VoiceOfMerchantState

Pesan respons untuk VoiceOfMerchant.GetVoiceOfMerchantState.

Kolom
has_voice_of_merchant

bool

Menunjukkan apakah lokasi memiliki reputasi baik dan memiliki kontrol atas bisnis di Google. Setiap hasil edit yang dibuat pada lokasi akan diterapkan ke Maps setelah melewati fase peninjauan.
has_business_authority

bool

Menunjukkan apakah lokasi memiliki otoritas (kepemilikan) atas bisnis di Google. Jika benar, lokasi lain tidak dapat mengambil alih dan menjadi listingan dominan di Maps. Namun, hasil edit tidak akan ditampilkan kecuali jika Voice of Merchant didapatkan (yaitu has_voice_of_merchant benar).
Kolom union gain_voice_of_merchant_action. Tindakan direkomendasikan ke lokasi untuk mendapatkan kontrol atas bisnis di Google. gain_voice_of_merchant_action hanya ada berupa salah satu diantara berikut:
wait_for_voice_of_merchant

WaitForVoiceOfMerchant

Tunggu untuk mendapatkan Voice of Merchant. Lokasi sedang dalam peninjauan untuk menjaga kualitas.
verify

Verify

Mulai atau lanjutkan proses verifikasi.
resolve_ownership_conflict

ResolveOwnershipConflict

Lokasi ini sama dengan lokasi lain yang bereputasi baik. Jika Anda memiliki akses ke lokasi yang bereputasi baik, gunakan id lokasi tersebut untuk melakukan operasi. Atau, minta akses dari pemilik saat ini.
comply_with_guidelines

ComplyWithGuidelines

Lokasi tidak mematuhi pedoman kami dan memerlukan langkah tambahan untuk diaktifkan kembali. Untuk memperbaiki masalah ini, baca Artikel Pusat Bantuan.

WaitForVoiceOfMerchant

Jenis ini tidak memiliki kolom.

Menunjukkan bahwa lokasi akan mendapatkan voice of merchant setelah lulus peninjauan.