Perhatian: Akan ada perubahan besar pada API dalam waktu dekat yang akan memerlukan migrasi. Kunjungi halaman rilis mendatang dan jadwal penghentian kami untuk mendapatkan info terbaru. Anda juga dapat mendaftar ke milis kami untuk menerima info terbaru.

Log Perubahan

v4.9

Fitur Baru

MoreHours
MoreHours sekarang dapat ditetapkan sebagai bagian dari listingan bisnis.
MoreHourTypes dapat diambil untuk setiap kategori menggunakan categories.batchGet.

Perubahan Perilaku

Penghentian Akun v4.x
accounts, accounts.admins, accounts.invitations, dan accounts.locations.admins sekarang tidak digunakan lagi di Google My Business API. Lihat log perubahan penghentian untuk info selengkapnya.
Postingan CallToAction
Pada K2 tahun 2021, Postingan CallToAction dengan ActionType GET_OFFER tidak akan berlaku lagi.

v4.8

Fitur Baru

Fasilitas Penginapan
Pengambilan dan pembaruan Fasilitas Penginapan. Info Lebih Lanjut
Penambahan endpoint GetGoogleUpdated untuk Penginapan.
Penambahan nilai boolean canOperateLodgingData di LocationState
Atribut Penyedia Layanan Kesehatan
Pengambilan dan pembaruan HealthProviderAttributes. Info Lebih Lanjut
Penambahan nilai boolean canOperateHealthData di LocationState
Jaringan Asuransi
Daftar jaringan asuransi yang diterima oleh lokasi. Info Lebih Lanjut

Perubahan Perilaku

ID Ulasan
ID Ulasan telah diubah ke format baru. ID baru ini sekarang akan ditampilkan dalam semua respons API yang berlaku. Dalam waktu singkat, ID ulasan lama masih akan di-resolve jika digunakan untuk memanggil API, tetapi seperti yang diwajibkan oleh kebijakan kami, semua ID ulasan yang disimpan di sistem Anda harus diperbarui dalam waktu 30 hari dengan memanggil endpoint listReviews.
Bisnis Jasa Sistem Panggilan
Pada K1 2021, Address tidak akan ditampilkan lagi dalam objek Lokasi untuk bisnis CUSTOMER_LOCATION_ONLY.

v4.7

Fitur Baru

Menu Makanan
Pengambilan dan pembaruan FoodMenus. Info Lebih Lanjut

v4.6

Fitur Baru

Daftar Layanan
Sekarang Anda dapat mengambil dan memperbarui layanan yang ditawarkan bisnis. Info Lebih Lanjut
Penambahan nilai boolean canModifyServiceList di LocationState
Menunjukkan apakah lokasi memenuhi syarat untuk mengubah daftar layanan. Info Lebih Lanjut
ServiceTypes standar untuk Kategori
Jenis layanan standar kini disertakan seperti dalam objek kategori. Info Lebih Lanjut
CategoryView
Kemampuan untuk menentukan tampilan BASIC atau FULL untuk kategori. Tampilan FULL akan menampilkan detail tambahan seperti jenis layanan. Info Lebih Lanjut
Metode Categories.BatchGet
Metode baru ini memungkinkan Anda memasukkan daftar kategori dan menampilkan informasi hanya tentang kategori tersebut. Info Lebih Lanjut

v4.5 Update Terkait COVID-19 2

Fitur Baru

Jenis Postingan Peringatan COVID-19
Sekarang Anda dapat membuat postingan COVID_19 melalui API. Info Lebih Lanjut.

v4.5 Update Terkait COVID-19 1

Fitur Baru

Tutup Sementara
Sekarang Anda dapat menetapkan bisnis ke CLOSED_TEMPORARILY melalui API. Info Lebih Lanjut.

v4.5

Fitur Baru

Pub/Sub untuk Tanya Jawab
Anda sekarang dapat menerima notifikasi Google Cloud Pub/Sub untuk pertanyaan dan jawaban baru/yang diperbarui tentang lokasi. Info Lebih Lanjut.
Pub/Sub untuk status listingan
Anda sekarang dapat menerima notifikasi Google Cloud Pub/Sub untuk perubahan dalam status listingan. Info Lebih Lanjut.

v4.4

Fitur Baru

Verifikasi Bisnis Jasa dan Servis
Bisnis jasa dan servis sekarang dapat diverifikasi dengan API. Info Lebih Lanjut.
Jumlah Pengikut
Anda sekarang dapat mengambil metadata tentang pengikut. Info Lebih Lanjut.
Grup Pengguna dan Grup Lokasi
Grup pengguna dan grup lokasi sekarang dapat dibuat melalui API. Info Lebih Lanjut
Penambahan kolom hasPendingEdits di LocationState
Menunjukkan apakah properti Lokasi berada dalam status hasil edit menunggu keputusan. Info Lebih Lanjut

Perubahan Perilaku

Tanggal Buka
Anda sekarang dapat menetapkan tanggal buka di masa mendatang untuk listingan.
PointRadius
PointRadius sekarang bersifat hanya baca. Pengeditan atau pembuatan bisnis jasa dan servis akan mewajibkan penggunaan Places.

v4.3

Fitur baru

Questions and Answers API
Mengambil pertanyaan, memposting jawaban, dan memberikan pertanyaan umum (FAQ) tentang lokasi bisnis Anda. Info Lebih Lanjut.
Baca Massal Ulasan
Mengambil ulasan untuk beberapa lokasi dalam satu panggilan. Info Lebih Lanjut.
GoogleLocations yang Direkomendasikan
Melihat lokasi yang belum diklaim yang menurut Google mungkin dimiliki oleh Anda. Info Lebih Lanjut.
Laporkan Masalah GoogleLocation
Melaporkan masalah terkait hasil RecommendedGoogleLocations atau GoogleLocations. Info Lebih Lanjut.
Enum layanan untuk bagian PriceList
Mengidentifikasi bagian PriceList apakah berisi item FOOD atau SERVICES yang disediakan. Info Lebih Lanjut.
Deskripsi Media
Memberikan teks saat mengupload media baru. Info Lebih Lanjut.
Insight CHAINS_QUERIES
Mengambil frekuensi lokasi ditampilkan sebagai hasil penelusuran untuk jaringan gerai yang memilikinya. Info Lebih Lanjut.

Perubahan Perilaku

Notifikasi untuk Akun Organisasi dan Grup Lokasi
Akun yang dikonfigurasi untuk notifikasi Pub/Sub sekarang juga akan menerima notifikasi ini untuk listingan yang tercantum di Akun Organisasi atau Grup Lokasi tempat akun tersebut menjadi admin.
ListLocations untuk Akun Org dan Grup Lokasi
accounts.locations.list yang dipanggil dengan Grup Pengguna atau akun Organisasi sekarang menampilkan semua lokasi yang dapat diakses oleh akun tersebut.

v4.2

Fitur baru

Verification API
Menampilkan daftar dan memicu metode verifikasi untuk lokasi yang belum diverifikasi. Info Lebih Lanjut.
GoogleLocations API
Menelusuri lokasi yang ada di Google yang akan diklaim, atau mengambil link untuk meminta akses ke lokasi yang diklaim. Info Lebih Lanjut.
Filter Lokasi yang Diperluas
Opsi tambahan untuk membatasi hasil yang ditampilkan dari panggilan Locations.List. Info Lebih Lanjut.
Keanggotaan Jaringan
Menunjukkan keanggotaan lokasi sebagai bagian dari jaringan (mis. Walmart, Target, dll.). Info Lebih Lanjut.
Informasi Organisasi
Informasi untuk Akun Organisasi sekarang akan ditampilkan sebagai bagian dari objek Akun. Info Lebih Lanjut.
Foto Profil Pengulas
URL untuk foto profil pengulas sekarang disertakan dalam objek ulasan. Info Lebih Lanjut.

v4.1

Fitur baru

Media yang Diberikan Pelanggan
Anda sekarang dapat mengambil dan melihat insight untuk foto dan video yang dibuat pengguna untuk lokasi yang Anda miliki dan kelola. Info Lebih Lanjut.
Admin Management API
Anda sekarang dapat menampilkan daftar, menerima, dan menolak undangan terkait akun dan lokasi untuk akun Anda. Info Lebih Lanjut.
Profile (Deskripsi yang Disediakan Penjual)
Mendeskripsikan bisnis Anda dengan gaya Anda sendiri dan membagikan cerita unik tentang bisnis dan penawaran Anda kepada pelanggan. Info Lebih Lanjut.
Kolom openingDate
Memberikan tanggal buka lokasi Anda. Info Lebih Lanjut.
Postingan Jenis Penawaran
Jenis Postingan baru di Google, yang membantu pengguna menemukan promo yang tersedia di lokasi Anda. Info Lebih Lanjut.

v4

Fitur baru

Postingan di Google
Anda sekarang dapat membuat Postingan di Google langsung melalui API.
Upload Foto
Foto sekarang dapat diupload langsung melalui API selain upload URL yang ada
Pemfilteran/Keikutsertaan Notifikasi
Anda sekarang dapat memfilter notifikasi yang dikirim ke topik pubsub. Notifikasi mendatang akan menggunakan mekanisme keikutsertaan ini, bukan dikirim ke semua pengguna.
Notifikasi UPDATED_REVIEW
Anda sekarang dapat berlangganan notifikasi real-time untuk mengetahui pembaruan ulasan pelanggan.
Dukungan untuk Grup Pengguna
Google My Business API sekarang mendukung akun jenis Grup Pengguna.

Perubahan yang tidak kompatibel dengan versi lama

  • Foto, yang sebelumnya berupa kolom objek location, sekarang adalah resource di lokasi (accounts/account_ID/locations/location_ID/photos).

  • Kolom alamat Country sekarang adalah region_code dan sub_locality sekarang adalah sublocality.

  • Kolom Ownership, yang sebelumnya tidak digunakan lagi, sekarang dihapus.

  • Sebelumnya, pemilik bersama atas akun dan lokasi tidak dapat dibedakan dari pemilik utama melalui API (semuanya muncul sebagai OWNER). Sekarang pemilik utama akan diberi peran OWNER dan pemilik lain akan diberi peran CO_OWNER.

  • AccountType.BUSINESS sekarang bernama AccountType.LOCATION_GROUP.

  • Saat menggunakan mask kolom untuk memperbarui lokasi, berikan update_mask sebagai ganti field_mask yang ada.

  • Pesan kategori yang digunakan untuk primary_category dan additional_categories tidak lagi berisi formulir yang dapat dibaca manusia. Pengguna harus menggunakan layanan kategori Google My Business API untuk mendapatkan nama kategori terjemahan yang dapat dibaca manusia.

v3.3

Fitur baru

Menu Terstruktur

Anda sekarang dapat menambahkan, memperbarui, atau menghapus:

  • Beberapa menu di lokasi yang ditentukan

  • Menyertakan beberapa bagian menu dalam satu menu

  • Menampilkan daftar item menu dengan nama, deskripsi, harga, dan foto

v3.2

Fitur baru

Insight
Anda sekarang dapat mengambil insight lokasi dan metrik petunjuk arah melalui API.
Notifikasi
Anda sekarang dapat berlangganan notifikasi real-time untuk Google Update baru.

Perubahan yang tidak kompatibel dengan versi lama

  • Kolom languageCodes dan platforms yang sebelumnya tidak digunakan untuk UrlAttributeValue telah dihapus.

  • SAME di enum Kepemilikan, yang tidak digunakan lagi, sekarang hanya berlaku jika lokasi yang diduplikasi memiliki pemilik utama yang sama. Sebelumnya, perilaku tersebut didasarkan pada penghitungan kepemilikan yang lebih kompleks.

v3.1

Fitur baru

Notifikasi
Anda sekarang dapat berlangganan notifikasi real-time untuk ulasan baru.
URL Maps
URL Google Maps disertakan di respons lokasi sehingga memungkinkan pengguna menautkan ke Google Maps dengan mudah.
Status Lokasi
Status Lokasi tambahan yang menunjukkan kapan listingan dipublikasikan, dinonaktifkan, dan menunggu verifikasi.
Tanda Buka Kembali
Tanda canReopen menunjukkan lokasi yang tutup permanen yang dapat dibuka kembali vs. yang tidak dapat dibuka kembali.
Atribut
Dukungan untuk atribut URL dan Enum.
Endpoint Kategori
Mendapatkan daftar kategori yang didukung menurut negara dan bahasa (menggantikan file CSV).

v3

Fitur baru

Ulasan
Anda sekarang dapat mengambil dan merespons ulasan bisnis melalui API.
Atribut
Memberikan informasi khusus kategori tambahan tentang lokasi.
Temukan Lokasi yang Cocok
Menemukan dan secara manual mengaitkan lokasi peta yang ada dengan lokasi bisnis.
Transfer Lokasi
Tindakan baru pada Location :transfer. Memungkinkan transfer lokasi dari satu akun (bisnis atau pribadi) ke akun lainnya.
Foto Pilihan
Menunjukkan foto pilihan yang akan ditampilkan pada urutan pertama di Google Maps dan Penelusuran.
Filter Penelusuran Baru
Filter penelusuran baru mencakup any_google_updates, is_suspended, dan is_duplicate.
Status Lokasi Baru
Status lokasi sekarang juga mencakup is_verified dan needs_reverification.
Perbaikan URL Foto
API sekarang menerima URL foto tanpa akhiran format gambar.

Perubahan yang tidak kompatibel dengan versi lama

  • Foto sekarang hanya dapat diperbarui untuk lokasi dengan halaman Google+ (hal ini telah diterima dan dibatalkan secara diam-diam sebelumnya).

  • Kolom location_name dan category_name sekarang bersifat hanya output. Hanya gunakan ID kategori saat menetapkan kategori.

  • Mask kolom tidak lagi menyertakan awalan location. untuk kolom yang disertakan.

  • Operasi buat/perbarui sekarang mengambil lokasi sebagai body payload; parameter lainnya dipindahkan ke string kueri.

v2

Perubahan yang tidak kompatibel dengan versi lama

  • Anda sekarang harus menentukan request_id pada panggilan CreateLocation. ID ini harus unik untuk setiap lokasi; hal ini membantu mencegah pembuatan lokasi duplikat di akun. Percobaan untuk membuat lokasi dengan ID permintaan yang cocok dengan lokasi yang dibuat sebelumnya hanya akan menampilkan lokasi yang ada, dan tidak akan membuat duplikat di akun Anda.

    • Nama business_hours di Location telah diganti menjadi regular_hours.