Di My Business Notifications API, notifikasi dipublikasikan di layanan Cloud Pub/Sub. Setelah menyiapkan Cloud Pub/Sub dan membuat topik, Anda dapat melakukan operasi berikut pada notifikasi:
Ulasan dan tanya jawab baru atau yang diperbarui, media yang diupload, update Google untuk ditinjau, 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 detail tentang cara memulai API, lihat Penyiapan dasar.
Penyiapan Cloud Pub/Sub
Untuk menyiapkan notifikasi API dengan Cloud Pub/Sub, lakukan langkah-langkah berikut:
- Ikuti panduan Cloud Pub/Sub untuk menyiapkan aplikasi Anda.
- Buat topik di project Cloud Pub/Sub dan catat nama topik yang dibuat.
- Berikan setidaknya izin
pubsub.topics.publish
untuk mybusiness-api- parameter@system.gserviceaccount.com. - Ikuti panduan Ringkasan subscriber untuk menyiapkan notifikasi push atau pull.
- Untuk menerima notifikasi, panggil endpoint
accounts.updateNotificationSetting
di My Business Notifications API. Pada panggilan, gunakan nama topik yang Anda buat di Cloud Pub/Sub untuk menautkan akun Profil Bisnis ke topik tersebut. - (Opsional) Ulangi langkah 5 untuk setiap akun Profil Bisnis 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:
GET https://mybusinessnotifications.googleapis.com/v1/accounts/{accountId}/notificationSetting
Memperbarui setelan notifikasi
Endpoint accounts.updateNotificationSetting
memperbarui setelan notifikasi Cloud Pub/Sub yang terkait dengan
akun. Tabel berikut menunjukkan cara memanggilnya:
PATCH https://mybusinessnotifications.googleapis.com/v1/accounts/{accountId}/notificationSetting?updateMask={commaSeparatedFieldsToUpdate} { 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:
PATCH https://mybusinessnotifications.googleapis.com/v1/accounts/{accountId}/notificationSetting?updateMask=pubsubTopic