Trong API Thông báo của Google Doanh nghiệp của tôi, thông báo được phát hành trong dịch vụ Cloud Pub/Sub. Sau khi thiết lập Cloud Pub/Sub và tạo một chủ đề, bạn có thể thực hiện các thao tác sau trên thông báo:
- Truy xuất chế độ cài đặt thông báo.
- Cập nhật chế độ cài đặt thông báo.
- Xoá chế độ cài đặt thông báo.
Chúng tôi hỗ trợ các bài đánh giá mới hoặc đã cập nhật, câu hỏi và câu trả lời, nội dung tải lên đa phương tiện, nội dung cập nhật của Google để xem xét, thay đổi trạng thái vị trí và nhiều nội dung khác. Đối tượng NotificationType liệt kê và mô tả các loại thông báo hiện có.
Trước khi bắt đầu
Để sử dụng API Thông báo của doanh nghiệp, hãy đăng ký ứng dụng và lấy thông tin xác thực OAuth 2.0. Để biết thông tin chi tiết về cách bắt đầu sử dụng API này, hãy xem phần Thiết lập cơ bản.
Thiết lập Cloud Pub/Sub
Để thiết lập thông báo API bằng Cloud Pub/Sub, hãy thực hiện các bước sau:
- Làm theo hướng dẫn về Cloud Pub/Sub để thiết lập ứng dụng.
- Tạo chủ đề trong dự án Cloud Pub/Sub và ghi lại tên của chủ đề đã tạo.
- Cấp ít nhất quyền
pubsub.topics.publish
cho mybusiness-api-pubsub@system.gserviceaccount.com. - Làm theo hướng dẫn Tổng quan về người đăng ký để thiết lập thông báo đẩy hoặc thông báo kéo.
- Để nhận thông báo, hãy gọi điểm cuối
accounts.updateNotificationSetting
trong API Thông báo của Doanh nghiệp của tôi. Trong lệnh gọi, hãy sử dụng tên chủ đề mà bạn đã tạo trong Cloud Pub/Sub để liên kết tài khoản Trang doanh nghiệp với chủ đề đó. - (Không bắt buộc) Lặp lại bước 5 cho từng tài khoản Trang doanh nghiệp mà bạn muốn nhận thông báo.
Truy xuất chế độ cài đặt thông báo
Điểm cuối accounts.getNotificationSetting
trả về chế độ cài đặt thông báo Cloud Pub/Sub hiện tại cho một tài khoản. Bảng sau đây cho biết cách gọi hàm này:
GET https://mybusinessnotifications.googleapis.com/v1/accounts/{accountId}/notificationSetting
Cập nhật chế độ cài đặt thông báo
Điểm cuối accounts.updateNotificationSetting
cập nhật chế độ cài đặt thông báo Cloud Pub/Sub liên kết với một tài khoản. Bảng sau đây cho biết cách gọi hàm này:
PATCH https://mybusinessnotifications.googleapis.com/v1/accounts/{accountId}/notificationSetting?updateMask={commaSeparatedFieldsToUpdate} { pubsubTopic: your/pubsub/topicName }
Xoá chế độ cài đặt thông báo
Việc gọi accounts.updateNotificationSetting
bằng pubsubTopic
trống sẽ xoá chế độ cài đặt thông báo Cloud Pub/Sub khỏi tài khoản.
Bảng sau đây cho biết cách gọi hàm này:
PATCH https://mybusinessnotifications.googleapis.com/v1/accounts/{accountId}/notificationSetting?updateMask=pubsubTopic