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

Halaman ini diterjemahkan oleh Cloud Translation API.

Pertanyaan Umum (FAQ)

Apa itu GBP API?

API Profil Bisnis 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.

API Profil Bisnis menawarkan fitur yang hampir sama seperti antarmuka pengguna Profil Bisnis dengan beberapa fitur tambahan khusus untuk API. Pengguna API akan mendapatkan update Google yang sama seperti yang diperoleh pengguna antarmuka pengguna.

Siapa yang dapat memperoleh akses ke API GBP?

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

Gunakan alamat email bisnis yang valid yang terkait dengan domain bisnis Anda.
Pastikan situs bisnis diperbarui dan aktif.

Apakah dengan memiliki akses ke API GBP, pengguna dapat membuat kueri data Google Profil Bisnis?

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

Apa kebijakan yang relevan untuk pengguna API GBP?

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

Bagaimana cara pengguna mendapatkan akses ke GBP API?

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

Buat Akun Google.
Mencoba Profil Bisnis.
Membuat project di Konsol API Google.
Minta akses ke API: Permintaan ditinjau dalam waktu 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 menyertakan panggilan API fitur penting berikut:
- FoodMenus
- Media
- Reviews
- LocalPosts
My Business Account Management API
My Business Lodging API
API My Business Place Actions
My Business Notifications API
My Business Verifications API
API Informasi Bisnis Saya
My Business Q&A API
API Performa Profil Bisnis

Jika aplikasi pengguna untuk meminta akses disetujui, aplikasi tersebut akan diberi kuota default standar untuk kedelapan API.

Bagaimana cara kerja akses ke GBP API?

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

Apakah Anda memiliki ringkasan API dan kemampuan contoh?

Lihat tabel berikut untuk mengetahui berbagai API dan kemampuannya.

API	Dokumentasi referensi	Contoh kemampuan
Account Management API	Dokumentasi	Mengelola akses ke lokasi. Membuat akun dengan nama dan jenis yang ditentukan di bawah induk yang ditentukan. Menampilkan daftar semua akun untuk pengguna yang diautentikasi. Mencantumkan undangan tertunda 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 Anda mengelola siklus proses profil dan menambahkan atau mengelola informasi bisnis dalam mata uang GBP. Memungkinkan penjual mendapatkan, membuat, memperbarui, atau menghapus Google Profil Bisnis. Memungkinkan penjual mendapatkan atau memperbarui atribut profil. Memungkinkan penjual mendapatkan atau menelusuri jaringan bisnis dan kategori profil.
Lodging API	Dokumentasi	Mengizinkan pengelolaan data penginapan, misalnya, fasilitas properti, dan kebijakan 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	Mengizinkan pengelolaan link tindakan tempat di bisnis. Alihkan pengguna untuk melakukan tindakan seperti membuat janji temu, melakukan reservasi meja, dan memesan makanan untuk dikirim.
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 tertentu.
API Tanya Jawab	Dokumentasi	Mengizinkan pengelolaan tanya jawab terkait lokasi.
Business Profile Performance API	Dokumentasi	Memungkinkan penjual mengambil analisis performa tentang listingan bisnis mereka di Google. Insight mencakup tayangan bisnis, permintaan rute, klik panggilan, klik situs, pemesanan, pesanan makanan, interaksi menu, dan lainnya.
Media API	Dokumentasi	Memungkinkan developer API mengupload foto dan video untuk profil bisnis.
Ulasan API	Dokumentasi	Memungkinkan penjual mendapatkan ulasan dan membalas ulasan di profil bisnis.
Local Posts API	Dokumentasi	Memungkinkan penjual mendapatkan, membuat, atau memperbarui postingan lokal.
FoodMenus API	Dokumentasi	Memungkinkan penjual mendapatkan, membuat, atau memperbarui menu makanan untuk profil bisnis.

Bagaimana cara partner menyiapkan struktur akun mereka untuk menggunakan API GBP?

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

Daftar untuk membuat akun Organisasi GBP sebagai agensi.
Pahami konsep grup pengguna dan grup lokasi 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 kepada partner pihak ketiga dengan dua cara:

Penyiapan OAuth: Lihat panduan ini untuk memahami 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, partner pihak ketiga tersebut tidak perlu menggunakan kredensial penjual untuk menggunakan API GBP guna mengedit dan mengakses data GBP.

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

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

Ya. Anda dapat meminta verifikasi massal untuk lebih dari 10 profil. Setelah verifikasi, lokasi jaringan bisnis yang dipublikasikan dapat dikelola dengan API Profil Bisnis seperti halnya lokasi lain dikelola, dengan beberapa pengecualian. Misalnya, pengelola lokasi diperlakukan secara berbeda, dan mereka dapat menambahkan diri sendiri ke lokasi waralaba.

Berapa batas kuota untuk berbagai API?

Batas kuota standar tercantum 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 menentukan kelayakan permintaan penambahan kuota Anda dengan mengonfirmasi penggunaan kuota sebelumnya. Jika penggunaan kuota rata-rata kurang dari 70% dari batas kuota saat ini, Anda mungkin tidak akan dapat meningkatkan batas kuota lebih lanjut.

Dapatkah partner GBP API membuat akun pengujian untuk produksi?

Tidak. Sayangnya, tidak ada cara langsung untuk membuat listingan GBP palsu di produksi melalui UI atau API GBP dan mengujinya.

Sebagian besar listingan palsu yang dibuat ditandai oleh moderasi kami dan ditangguhkan. Sebaiknya gunakan listingan klien dan kerjakan setelah jam kerja (asalkan Anda tidak mengubah informasi utama listingan, seperti nama, alamat, kategori) atau Anda membuat listingan untuk kantor pusat perusahaan. Jika ingin menguji respons API untuk memverifikasi listingan atau tindakan lain yang memerlukan listingan produksi, Anda dapat menggunakan respons API tiruan.