Mengelola verifikasi

Penyedia yang menawarkan pengelolaan listingan langsung pada platform mereka dapat memverifikasi bisnis penjual dalam situs mereka. Dengan demikian, penjual tidak perlu dialihkan ke UI Profil Bisnis.

Mendapatkan status saat ini

Pengguna dapat memanggil locations.getVoiceOfMerchantState pada lokasi untuk mengambil statusnya saat ini. Jika boolean hasVoiceOfMerchant adalah true, berarti lokasi tersebut sudah memiliki reputasi baik dan tidak ada tindakan tambahan yang diperlukan. Atau, jika tindakan gain_voice_of_merchant dalam respons berisi verify, Anda harus menyelesaikan verifikasi. Ikuti petunjuk di bawah untuk mendapatkan informasi lebih lanjut.

Mengambil opsi verifikasi

Penyedia dapat menggunakan metode locations.fetchVerificationOptions untuk meminta penjual memilih metode kontak pilihan dari daftar metode verifikasi yang tersedia.

Untuk mengambil opsi verifikasi, gunakan hal berikut:

HTTP
POST
https://mybusinessverifications.googleapis.com/v1/{locationId}:fetchVerificationOptions

{
  "languageCode": "en"
}

Memulai proses verifikasi

Setelah Anda memilih metode verifikasi, mulai proses verifikasi dengan locations.verify. Akibat panggilan ini, lokasi beralih ke status terverifikasi atau status error ditampilkan.

HTTP
POST
https://mybusinessverifications.googleapis.com/v1/locations/{locationId}
:verify

// Use only one of the below verification methods

// For postcard verification:
{
  "method": "ADDRESS",
  "languageCode": "en",
  "addressInput": {
    "mailerContactName": "Ann Droyd"
  }
}

// For phone verification:
{
  "method": "PHONE_CALL",
  "languageCode": "en",
  "phoneInput": {
    "phoneNumber": "800-555-0136"
  }
}

// For SMS verification:
{
  "method": "SMS",
  "languageCode": "en",
  "phoneInput": {
    "phoneNumber": "800-555-0136"
  }
}

// For email verification:
{
  "method": "EMAIL",
  "languageCode": "en",
  "emailInput": {
    "emailAddress": "ex@google.com"
  }
}

Mengambil verifikasi saat ini

Panggilan locations.verifications.list akan mengambil histori permintaan verifikasi bersama dengan statusnya untuk lokasi yang ditentukan dalam panggilan.

Untuk mengambil semua permintaan verifikasi, gunakan hal berikut:

HTTP
GET
https://mybusinessverifications.googleapis.com/v1/locations/{locationId}
/verifications

Menyelesaikan verifikasi yang menunggu keputusan

Kode PIN dan metode locations.verifications.complete biasanya diperlukan untuk menyelesaikan verifikasi suatu bisnis.

Untuk menyelesaikan verifikasi yang menunggu keputusan, gunakan hal berikut:

HTTP
POST
https://mybusinessverifications.googleapis.com/v1/locations/{locationId}
/verifications/{verificationId}:complete

{
  "pin": "123456"
}

Praktik terbaik untuk verifikasi GBP menggunakan API

Pembuatan lokasi

Dengan GBP Business Information API, Anda dapat menyematkan platform untuk menyediakan fungsi pembuatan lokasi. Saat Anda meminta penjual menambahkan lokasi baru, pastikan untuk mengikuti langkah-langkah berikut:

Kumpulkan informasi lokasi seperti nama, alamat, dan kategori bisnis dari penjual.

  1. Panggil endpoint googleLocations.search.
  2. Berikan data lokasi, seperti nama, kategori, alamat, nomor telepon, dan situs bisnis dalam permintaan API.

Selain itu, telusuri kemungkinan lokasi yang cocok dengan mengikuti langkah-langkah berikut:

  1. Cari kemungkinan kecocokan lokasi.
  2. Minta penjual untuk memilih lokasi yang benar.
  3. Jika requestAdminRightsUrl ada di respons lokasi, bantu penjual meminta akses dan kepemilikan untuk lokasi tersebut di Google Profil Bisnis.
  4. Jika requestAdminRightsUrl tidak ada, buat lokasi baru dengan ID Tempat dalam respons lokasi.
  5. Verifikasi lokasi baru.

Catatan: Jika Anda tidak mendapatkan kemungkinan kecocokan lokasi dari pencarian awal, gunakan ID Tempat kosong untuk membuat lokasi baru. Kemudian, verifikasi lokasi baru tersebut.

Verifikasi lokasi

Untuk memulai proses verifikasi menggunakan GBP API, ikuti langkah-langkah berikut:

  1. Panggil metode accounts.locations.list untuk mendapatkan daftar semua lokasi untuk Akun Google.
  2. Pilih lokasi yang akan diverifikasi.
  3. Panggil metode GetVoiceOfMerchant API untuk mengonfirmasi apakah lokasi tersebut memerlukan verifikasi.
  4. Jika responsnya menampilkan "verify", panggil fetchVerificationOptions untuk mendapatkan daftar metode yang tersedia untuk memverifikasi lokasi tersebut.
  5. Periksa kembali apakah data verificationOption menyertakan alamat, nomor telepon, dan alamat email yang benar.
  6. Setelah penjual memilih opsi verifikasi terbaik yang tersedia, panggil metode locations.verify untuk menginisiasi verifikasi yang sesuai. Untuk mengonfirmasi bahwa inisiasi tersebut sedang berlangsung, panggil locations.verifications.list.
  7. Panggil metode locations.verification.complete dengan pin penjual.
  8. Panggil metode GetVoiceOfMerchant API. Jika HasVoiceOfMerchant = true, berarti Anda berhasil memverifikasi lokasi.

Catatan: Jika verifikasi AUTO tersedia untuk lokasi tersebut, penjual tidak perlu melakukan langkah verifikasi apa pun

Untuk mendapatkan informasi lebih lanjut tentang verifikasi GBP, lihat artikel dukungan pusat bantuan kami.

Panduan Metode Verifikasi untuk Partner Terverifikasi