Perbarui integrasi Google Business Profile API Anda sebelum endpoint penting dinonaktifkan. Tinjau jadwal penghentian dan petunjuk untuk menghindari gangguan mulai April 2022.

Pertanyaan Umum (FAQ)

Apa yang dimaksud dengan GBP API?

API Business Profile adalah antarmuka pemrograman yang memungkinkan developer menulis aplikasi untuk mengelola akun Profil Bisnis dan data lokasi mereka. API memungkinkan penjual atau perwakilannya mengelola cara penyajian data mereka di Google dan mengontrol orang yang bersama-sama mengelola data mereka. Data yang dibuat pengguna, seperti foto, postingan, dan ulasan juga dapat dikelola melalui API ini.

Business Profile API menawarkan fitur yang hampir sama seperti antarmuka pengguna Profil Bisnis, ditambah beberapa fitur tambahan khusus lainnya untuk API. Pengguna API akan mendapatkan update Google yang sama seperti yang diperoleh pengguna antarmuka pengguna.

Siapa saja yang bisa mendapatkan akses ke GBP API?

GBP API tidak terbuka untuk umum. Pengguna harus meminta akses ke GBP API untuk menggunakannya. Setiap individu atau perusahaan yang dapat menunjukkan alasan bisnis yang sah untuk mengakses GBP API akan disetujui untuk mendapatkan akses. Berikut adalah beberapa rekomendasi untuk menunjukkan legalitas sebagai bisnis:

Menggunakan alamat email bisnis valid yang terkait dengan domain bisnis Anda.
Memastikan situs bisnis diperbarui dan aktif.

Apakah pengguna dapat mengajukan kueri tentang data Google Profil Bisnis jika memiliki akses ke GBP API?

Tidak. Meskipun Anda mendapatkan akses ke GBP API, Anda tidak dapat mengajukan kueri tentang data Google Profil Bisnis kecuali jika Anda memiliki akses ke Google Profil Bisnis tersebut.

Apa saja kebijakan yang relevan bagi pengguna GBP API?

Partner harus mematuhi kebijakan Google Profil Bisnis bersama dengan semua kebijakan serta persyaratan dan ketentuan API.

Bagaimana cara pengguna mendapatkan akses ke GBP API?

Agar berhasil membuat aplikasi klien pertama, Anda harus menyelesaikan prasyarat berikut:

Membuat Akun Google.
Mencoba Profil Bisnis.
Membuat project di Konsol API Google.
Meminta akses ke API: Permintaan akan ditinjau dalam 14 hari.

Bagaimana cara pengguna mendapatkan akses ke API tertentu dalam GBP API?

Ada delapan API yang terkait dengan Profil Bisnis yang harus diaktifkan di Konsol API Google:

Google My Business API 4.9, yang mencakup panggilan API untuk fitur penting berikut:
- FoodMenus
- Media
- Reviews
- LocalPosts
My Business Account Management API
My Business Lodging API
My Business Place Actions API
My Business Notifications API
My Business Verifications API
My Business Business Information API
My Business Q&A API
Business Profile Performance API

Jika aplikasi pengguna yang meminta akses disetujui, kuota default standar akan diberikan untuk kedelapan API.

Bagaimana cara kerja akses ke GBP API?

Akses GBP API diberikan di level project Google Cloud. Jika pengguna A telah mengajukan permohonan akses Google Business Profile API untuk project # - 12345678, maka akses akan diberikan ke project # - 12345678. Jadi, semua pengguna termasuk pengguna A yang memiliki akses ke project Google Cloud dapat melakukan panggilan ke Google Business Profile API. Partner harus mengontrol akses ke project Google Cloud berdasarkan kebutuhan akses untuk menghindari penyalahgunaan.

Apakah Anda memiliki ringkasan tentang API dan contoh kemampuannya?

Lihat tabel berikut untuk mengetahui berbagai API dan kemampuannya.

API	Dokumentasi referensi	Contoh kemampuan
Account Management API	Dokumentasi	Mengelola akses ke sebuah lokasi. Membuat akun dengan nama dan jenis yang ditentukan di bawah induk tertentu. Mencantumkan semua akun untuk pengguna terautentikasi. Mencantumkan undangan yang menunggu keputusan untuk akun yang ditentukan. Memindahkan lokasi dari akun yang dimiliki pengguna ke akun lain. Memperbarui administrator untuk lokasi yang ditentukan.
Business Information API	Dokumentasi	Business Information API memungkinkan pengelolaan siklus proses profil dan penambahan atau pengelolaan informasi bisnis di GBP. Memungkinkan penjual mendapatkan, membuat, memperbarui, atau menghapus profil bisnis Google. Memungkinkan penjual mendapatkan atau memperbarui atribut profil. Memungkinkan penjual mendapatkan atau menelusuri kategori profil, jaringan gerai.
Lodging API	Dokumentasi	Memungkinkan pengelolaan data penginapan, misalnya, fasilitas dan kebijakan properti untuk bisnis di Google. API ini ditujukan khusus untuk bisnis yang menyediakan layanan penginapan seperti hotel. Lodging API memungkinkan developer memperbarui atribut penginapan di Google Profil Bisnis.
Place Actions API	Dokumentasi	Memungkinkan pengelolaan link tindakan tempat di bisnis. Mengalihkan pengguna ke situs eksternal untuk melakukan tindakan seperti membuat janji temu, melakukan reservasi meja, memesan makanan.
Notifications API	Dokumentasi	Memungkinkan pengelolaan setelan notifikasi untuk akun yang ditentukan.
Verifications API	Dokumentasi	Memulai proses verifikasi untuk lokasi. Melaporkan semua opsi verifikasi yang memenuhi syarat untuk lokasi dalam bahasa spesifik.
Q&A API	Dokumentasi	Memungkinkan pengelolaan tanya jawab terkait lokasi.
Business Profile Performance API	Dokumentasi	Memungkinkan penjual mengambil insight performa tentang listingan bisnis mereka di Google. Insight mencakup tayangan iklan bisnis, permintaan rute, klik panggilan telepon, klik situs, pemesanan, pemesanan makanan, interaksi menu, dan lainnya.
Media API	Dokumentasi	Memungkinkan developer API mengupload foto dan video untuk profil bisnis.
Reviews API	Dokumentasi	Memungkinkan penjual mendapatkan ulasan dan membalas ulasan di profil bisnis.
Local Posts API	Dokumentasi	Memungkinkan penjual mendapatkan, memuat, atau memperbarui postingan lokal.
FoodMenus API	Dokumentasi	Memungkinkan penjual mendapatkan, membuat, atau memperbarui menu makanan untuk profil bisnis.

Bagaimana cara partner menyiapkan struktur akun untuk menggunakan GBP API?

Jika Anda adalah partner pihak ketiga yang melakukan pengelolaan listingan untuk bisnis:

Daftarkan Akun organisasi GBP sebagai agensi.
Pelajari konsep grup pengguna dan grup bisnis.
Lihat panduan ini untuk memahami cara mengelola lokasi atas nama bisnis.

Bagaimana cara bisnis memberikan otorisasi kepada partner GBP API untuk mengelola listingan bisnisnya?

Bisnis memberikan akses ke partner pihak ketiga dengan dua cara:

Penyiapan OAuth: Lihat panduan ini untuk memahami bagaimana cara platform partner pihak ketiga menggunakan kredensial penjual untuk mengedit dan mengakses data Google Profil Bisnis atas nama penjual atau bisnis.
Akses pemilik atau pengelola: Jika partner pihak ketiga ditambahkan sebagai pengelola Google Profil Bisnis oleh penjual, yang seharusnya menjadi pemilik utama GBP, maka partner pihak ketiga tidak perlu menggunakan kredensial penjual saat menggunakan GBP API untuk mengedit atau mengakses data GBP.

Catatan: Sebaiknya partner pihak ketiga tidak menambahkan diri mereka sebagai pemilik GBP, tetapi hanya menambahkan diri mereka sebagai pengelola.

Jika bisnis memiliki 10 lokasi atau lebih, apakah ada cara untuk melakukan verifikasi massal?

Ya. Anda dapat meminta verifikasi massal untuk 10 profil atau lebih. Setelah diverifikasi, lokasi jaringan gerai yang dipublikasikan dapat dikelola menggunakan Business Profile API dengan cara yang sama seperti pengelolaan lokasi lain, dengan beberapa pengecualian. Misalnya, pengelola lokasi diperlakukan secara berbeda, dan mereka dapat menambahkan diri sendiri ke lokasi waralaba.

Berapa batas kuota untuk beragam API?

Batas kuota standar dicantumkan di Batas penggunaan. Jika memerlukan batas yang lebih tinggi, Anda dapat mengirimkan permintaan kuota standar.

Berapa banyak kuota yang dapat saya minta?

Kuota adalah resource terbatas. Tim dukungan GBP API akan menentukan kelayakan permintaan penambahan kuota dengan mengonfirmasi penggunaan kuota Anda sebelumnya. Jika rata-rata penggunaan kuota Anda kurang dari 70% dari batas kuota saat ini, permintaan Anda untuk menambah batas kuota mungkin akan ditolak.

Apakah partner GBP API dapat membuat akun percobaan untuk produk?

Tidak. Sayang sekali tidak ada cara langsung untuk membuat listingan GBP palsu di produk, baik melalui API atau UI GBP dan mengujinya.

Sebagian besar listingan palsu yang dibuat akan ditandai oleh sistem moderasi kami dan ditangguhkan. Sarannya adalah menggunakan listingan klien dan menggunakannya di luar jam operasional (selama Anda tidak mengubah informasi utama listingan, seperti nama, alamat, kategori) atau Anda membuat listingan untuk kantor pusat perusahaan Anda. Jika Anda ingin menguji respons API untuk memverifikasi listingan atau tindakan lain yang memerlukan listingan produk, Anda dapat menggunakan respons API rekaan.