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.

Mengelola notifikasi real-time

Di My Business Notifications API, notifikasi dipublikasikan di layanan Cloud Pub/Sub. Setelah menyiapkan Cloud Pub/Sub dan membuat topik, Anda dapat melakukan tindakan berikut pada notifikasi:

Ulasan dan tanya jawab terkini atau yang diperbarui, media yang diupload, update Google untuk ulasan, perubahan status lokasi, dan lainnya didukung. Objek NotificationType mendeskripsikan dan menampilkan daftar jenis notifikasi yang tersedia.

Sebelum memulai

Untuk menggunakan My Business Notifications API, daftarkan aplikasi Anda dan dapatkan kredensial OAuth 2.0. Untuk mengetahui detail tentang cara memulai API, lihat Penyiapan dasar.

Penyiapan Cloud Pub/Sub

Untuk menyiapkan notifikasi API dengan Cloud Pub/Sub, lakukan langkah-langkah berikut:

  1. Ikuti panduan Cloud Pub/Sub untuk menyiapkan aplikasi Anda.
  2. Buat topik di project Cloud Pub/Sub dan catat nama topik yang dibuat.
  3. Berikan setidaknya izin pubsub.topics.publish untuk mybusiness-api-pubsub@system.gserviceaccount.com.
  4. Ikuti panduan Ringkasan subscriber untuk menyiapkan notifikasi push atau pull.
  5. Untuk menerima notifikasi, panggil endpoint accounts.updateNotificationSetting di Google My Business API. Pada panggilan, gunakan nama topik yang Anda buat di Cloud Pub/Sub untuk menautkan akun Bisnisku milik Anda ke topik tersebut.
  6. (Opsional) Ulangi langkah 5 untuk setiap akun Google Bisnisku yang notifikasinya ingin Anda terima.

Mengambil setelan notifikasi

Endpoint accounts.getNotificationSetting menampilkan setelan notifikasi Cloud Pub/Sub saat ini untuk akun. Tabel berikut menunjukkan cara memanggilnya:

HTTP
GET
https://mybusinessnotifications.googleapis.com/v1/accounts/{accountId}/notificationSetting

Mengubah setelan notifikasi

Endpoint accounts.updateNotificationSetting memperbarui setelan notifikasi Cloud Pub/Sub yang terkait dengan akun. Tabel berikut menunjukkan cara memanggilnya:

HTTP
PATCH
https://mybusinessnotifications.googleapis.com/v1/accounts/{accountId}/notificationSetting

{
  pubsubTopic: your/pubsub/topicName
}

Menghapus setelan notifikasi

Memanggil accounts.updateNotificationSetting dengan pubsubTopic kosong akan menghapus setelan notifikasi Cloud Pub/Sub dari akun. Tabel berikut menunjukkan cara memanggilnya:

HTTP
PATCH
https://mybusinessnotifications.googleapis.com/v1/accounts/{accountId}/notificationSetting