Mengelola notifikasi real-time

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

Ulasan atau ulasan baru atau yang diperbarui, pertanyaan dan jawaban, upload media, Update Google untuk peninjauan, perubahan status lokasi, dan lainnya didukung. Objek NotificationType daftar dan menjelaskan 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 siapkan aplikasi Anda.
  2. Membuat topik di project Cloud Pub/Sub Anda dan catat nama topik yang dibuat.
  3. Berikan setidaknya pubsub.topics.publish izin ke mybusiness-api-pubsub@system.gserviceaccount.com.
  4. Ikuti Ringkasan subscriber panduan untuk menyiapkan notifikasi push atau pull.
  5. Untuk menerima notifikasi, panggil accounts.updateNotificationSetting endpoint di My Business Notifications API. Dalam panggilan, gunakan topik nama yang Anda buat di Cloud Pub/Sub untuk menautkan akun Profil Bisnis ke topik tersebut.
  6. (Opsional) Ulangi langkah 5 untuk setiap akun Profil Bisnis yang ingin menerima notifikasinya.

Mengambil setelan notifikasi

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

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

Mengubah setelan notifikasi

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

HTTP
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:

HTTP
PATCH
https://mybusinessnotifications.googleapis.com/v1/accounts/{accountId}/notificationSetting?updateMask=pubsubTopic