Mengaktivasi lokasi dari Profil Bisnis

Profil Bisnis adalah alat gratis dan mudah digunakan bagi bisnis dan organisasi untuk mengelola kehadiran di internet di seluruh Google, termasuk Penelusuran dan Maps.

Google Business Profile API menyediakan antarmuka untuk mengelola informasi lokasi bisnis di Google. Bisnis dapat memberikan akses melalui izin OAuth ke bisnis lain untuk mengelola profilnya atas nama mereka.

Bisnis terkelola di Profil Bisnis telah diverifikasi melalui proses verifikasi Profil Bisnis. Anda dapat memperluas alur izin OAuth Profil Bisnis untuk mengaktivasi bisnis ini ke Pesan Bisnis dan memverifikasinya secara otomatis untuk diluncurkan di Business Messages.

Ini adalah metode yang lebih skalabel dan lebih cepat untuk meluncurkan Pesan Bisnis dan merupakan alur yang direkomendasikan untuk mengaktifkan fitur pesan untuk lokasi Profil Bisnis.

Prasyarat

Anda harus sudah menjadi partner Profil Bisnis dengan akses ke Google Profil Bisnis API. Jika tidak, ikuti prasyarat Profil Bisnis untuk mengajukan permohonan akses.

Setelah Anda diberi akses ke Google Business Profile API, ikuti panduan penyiapan dasar dan penyiapan OAuth mereka sebelum melanjutkan.

Mengaktifkan Business Messages untuk lokasi Profil Bisnis terverifikasi

Diagram berikut menunjukkan bagaimana layanan web Anda dapat memanfaatkan verifikasi lokasi Profil Bisnis suatu merek untuk agen Business Messages. Lihat petunjuk selengkapnya di bawah ini.

1. Dalam alur izin OAuth yang ada tempat pemilik akun Profil Bisnis memberikan akses kepada Anda untuk memanggil API Google Profil Bisnis atas nama mereka, perbarui cakupan API untuk menyertakan

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

   Kedua cakupan tersebut diperlukan agar berhasil memverifikasi otomatis agen dan lokasi bisnis.

2. Buat agen dengan displayName yang cocok dengan nama setidaknya salah satu listingan Google Profil Bisnis yang dimiliki oleh kredensial OAuth yang Anda peroleh di langkah sebelumnya. Cari lokasi dengan Google Business Profile API untuk menemukan nama bisnis.

   Untuk pencocokan nama,

   • Kapitalisasi karakter tidak sensitif.
   • Nama lengkap agen harus sama persis dengan kata pertama atau kata-kata dalam nama lokasi Profil Bisnis. Misalnya, agen bernama "GBP Bakery" cocok dengan "Gbp Bakery Mountain View", "Gbp Bakery", dan "gbp toko cerahvale", tetapi tidak cocok dengan "Bakery San Francisco".

3. Untuk setiap lokasi di Profil Bisnis, buat lokasi dengan placeId yang sama. placeId untuk lokasi Profil Bisnis dimuat dalam objek LocationKey saat lokasi diambil dari Google Business Profile API.

4. Dengan agen yang Anda buat dan token OAuth yang diperoleh, minta verifikasi agen.

   Catatan: Anda harus menggunakan token OAuth cakupan ganda yang diperoleh, bukan kunci akun layanan project.

   Permintaan verifikasi memerlukan informasi kontak merek. Namun, proses verifikasi tidak akan mengirim email ke perusahaan jika nama agen cocok dengan nama Profil Bisnis dan jika Anda memperoleh token OAuth dengan cakupan yang benar.

   Jika Anda melakukan ini dengan benar, output dari permintaan verifikasi akan segera menampilkan verificationState dari VERIFICATION_STATE_VERIFIED. Jika verificationState menampilkan nilai yang berbeda, kemungkinan Anda tidak menggunakan token OAuth yang benar saat membuat permintaan atau agen tidak dapat dicocokkan dengan lokasi Profil Bisnis.

5. Dengan token OAuth yang sama, minta verifikasi lokasi untuk semua lokasi yang dimiliki oleh bisnis di Profil Bisnis.

   Seperti halnya verifikasi agen, jika Anda melakukan ini dengan benar, output dari permintaan verifikasi akan segera menampilkan verificationState dari VERIFICATION_STATE_VERIFIED. Jika verificationState menampilkan nilai yang berbeda, kemungkinan Anda tidak menggunakan token OAuth yang benar saat membuat permintaan atau lokasi Profil Bisnis bukan bisnis yang diklaim dan terverifikasi.

6. Luncurkan agen dengan titik entri LOCATION.

7. Aktifkan pengiriman pesan untuk lokasi tertentu dengan meluncurkan lokasi yang ingin Anda tampilkan melalui Penelusuran dan Maps. Setelah proses peluncuran dimulai, pesan untuk setiap lokasi yang diluncurkan akan tersedia bagi pengguna dalam beberapa jam.

Setelah Anda mengikuti langkah-langkah ini, semua pesan konsumen akan diposting ke webhook Business Messages yang terdaftar, dan Anda harus mengirimkan respons kepada konsumen dengan Business Messages API.