NotificationSetting
Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
Một chủ đề trên Google Pub/Sub, nơi bạn có thể xuất bản thông báo khi một vị trí được cập nhật hoặc có bài đánh giá mới. Sẽ chỉ có một tài nguyên cài đặt thông báo cho mỗi tài khoản.
| Biểu diễn dưới dạng JSON |
{
"name": string,
"pubsubTopic": string,
"notificationTypes": [
enum (NotificationType)
]
} |
| Trường |
name |
string
Bắt buộc. Tên tài nguyên mà chế độ cài đặt này dành cho. Đây là biểu mẫu accounts/{account_id}/notificationSetting.
|
pubsubTopic |
string
Không bắt buộc. Chủ đề Google Pub/Sub sẽ nhận được thông báo khi cập nhật thông tin về các vị trí do tài khoản này quản lý. Nếu bạn không đặt chính sách này thì sẽ không có thông báo nào được đăng. Tài khoản mybusiness-api-pubsub@system.gserviceaccount.com phải có ít nhất quyền Xuất bản đối với chủ đề Pub/Sub.
|
notificationTypes[] |
enum (NotificationType)
Các loại thông báo sẽ được gửi đến chủ đề Pub/Sub. Để ngừng nhận hoàn toàn thông báo, hãy sử dụng NotificationSettings.UpdateNotificationSettings với một notificationTypes trống hoặc đặt pubsubTopics thành một chuỗi trống.
|
NotificationType
Loại thông báo được gửi đến chủ đề Pub/Sub.
| Enum |
NOTIFICATION_TYPE_UNSPECIFIED |
Không có loại thông báo nào. Sẽ không khớp với bất kỳ thông báo nào. |
GOOGLE_UPDATE |
Vị trí có nội dung cập nhật của Google cần xem xét. Trường location_name trên thông báo sẽ cung cấp tên tài nguyên của vị trí với nội dung cập nhật của Google. |
NEW_REVIEW |
Một bài đánh giá mới đã được thêm vào vị trí này. Trường review_name trên thông báo sẽ cung cấp tên tài nguyên của bài đánh giá đã được thêm, còn location_name sẽ có tên tài nguyên của vị trí đó. |
UPDATED_REVIEW |
Một bài đánh giá về vị trí này đã được cập nhật. Trường review_name trên thông báo sẽ cung cấp tên tài nguyên của bài đánh giá đã được thêm, còn location_name sẽ có tên tài nguyên của vị trí đó. |
NEW_CUSTOMER_MEDIA |
Một người dùng Google Maps đã thêm một mục nội dung nghe nhìn mới vào vị trí. Thông báo sẽ cung cấp tên tài nguyên của mục nội dung đa phương tiện mới. |
NEW_QUESTION |
Một câu hỏi mới được thêm vào vị trí. Thông báo sẽ cung cấp tên tài nguyên của câu hỏi. |
UPDATED_QUESTION |
Một câu hỏi về vị trí đã được cập nhật. Thông báo sẽ cung cấp tên tài nguyên của câu hỏi. |
NEW_ANSWER |
Câu trả lời mới được thêm vào vị trí. Thông báo sẽ cung cấp tên tài nguyên của câu hỏi và câu trả lời. |
UPDATED_ANSWER |
Câu trả lời của vị trí đã được cập nhật. Thông báo sẽ cung cấp tên tài nguyên của câu hỏi và câu trả lời. |
DUPLICATE_LOCATION |
Cho biết liệu có thay đổi trong trường vị trí trùng lặp của siêu dữ liệu vị trí hay không. |
LOSS_OF_VOICE_OF_MERCHANT |
Không dùng nữa: Di chuyển cách sử dụng hiện tại của giá trị này sang "VOICE_OF_MERCHANT_UPDATED" mở rộng hơn. |
VOICE_OF_MERCHANT_UPDATED |
Cho biết liệu vị trí có được cập nhật trong trạng thái Voice của người bán (VOM) hay không. VOM cho biết liệu vị trí có ở trạng thái tốt và người bán có quyền kiểm soát doanh nghiệp trên Google hay không. Mọi nội dung chỉnh sửa đối với vị trí đó sẽ được xuất hiện trên Maps sau khi vượt qua giai đoạn xem xét. Hãy gọi GetVoiceOfMerchantState rpc để biết thêm chi tiết. |
Trừ phi có lưu ý khác, nội dung của trang này được cấp phép theo Giấy phép ghi nhận tác giả 4.0 của Creative Commons và các mẫu mã lập trình được cấp phép theo Giấy phép Apache 2.0. Để biết thông tin chi tiết, vui lòng tham khảo Chính sách trang web của Google Developers. Java là nhãn hiệu đã đăng ký của Oracle và/hoặc các đơn vị liên kết với Oracle.
Cập nhật lần gần đây nhất: 2025-07-25 UTC.
[null,null,["Cập nhật lần gần đây nhất: 2025-07-25 UTC."],[[["\u003cp\u003eGoogle Pub/Sub notifications can be configured for location updates and new reviews.\u003c/p\u003e\n"],["\u003cp\u003eA single notification setting exists per account, directing notifications to a specified Pub/Sub topic.\u003c/p\u003e\n"],["\u003cp\u003eNotification types include Google updates, new/updated reviews, new customer media, new/updated Q&A, duplicate location and Voice of Merchant updates.\u003c/p\u003e\n"],["\u003cp\u003eAccount must grant \u003ccode\u003emybusiness-api-pubsub@system.gserviceaccount.com\u003c/code\u003e publish permissions on the designated Pub/Sub topic.\u003c/p\u003e\n"],["\u003cp\u003eTo disable notifications, clear the \u003ccode\u003enotificationTypes\u003c/code\u003e list or set \u003ccode\u003epubsubTopic\u003c/code\u003e to an empty string in the notification settings.\u003c/p\u003e\n"]]],[],null,["# NotificationSetting\n\n- [JSON representation](#SCHEMA_REPRESENTATION)\n- [NotificationType](#NotificationType)\n\nA Google Pub/Sub topic where notifications can be published when a location is updated or has a new review. There will be only one notification setting resource per-account.\n\n| JSON representation |\n|----------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"name\": string, \"pubsubTopic\": string, \"notificationTypes\": [ enum (/my-business/reference/notifications/rest/v1/NotificationSetting#NotificationType) ] } ``` |\n\n| Fields ||\n|-----------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `name` | `string` Required. The resource name this setting is for. This is of the form `accounts/{account_id}/notificationSetting`. |\n| `pubsubTopic` | `string` Optional. The Google Pub/Sub topic that will receive notifications when locations managed by this account are updated. If unset, no notifications will be posted. The account [mybusiness-api-pubsub@system.gserviceaccount.com](mailto:mybusiness-api-pubsub@system.gserviceaccount.com) must have at least Publish permissions on the Pub/Sub topic. |\n| `notificationTypes[]` | `enum (`[NotificationType](/my-business/reference/notifications/rest/v1/NotificationSetting#NotificationType)`)` The types of notifications that will be sent to the Pub/Sub topic. To stop receiving notifications entirely, use NotificationSettings.UpdateNotificationSetting with an empty notificationTypes or set the pubsubTopic to an empty string. |\n\nNotificationType\n----------------\n\nType of notification sent to the Pub/Sub topic.\n\n| Enums ||\n|---------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `NOTIFICATION_TYPE_UNSPECIFIED` | No notification type. Will not match any notifications. |\n| `GOOGLE_UPDATE` | The location has Google updates for review. The location_name field on the notification will provide the resource name of the location with Google updates. |\n| `NEW_REVIEW` | A new review has been added to the location. The review_name field on the notification will provide the resource name of the review that was added, and location_name will have the location's resource name. |\n| `UPDATED_REVIEW` | A review on the location has been updated. The review_name field on the notification will provide the resource name of the review that was added, and location_name will have the location's resource name. |\n| `NEW_CUSTOMER_MEDIA` | A new media item has been added to the location by a Google Maps user. The notification will provide the resource name of the new media item. |\n| `NEW_QUESTION` | A new question is added to the location. The notification will provide the resource name of question. |\n| `UPDATED_QUESTION` | A question of the location is updated. The notification will provide the resource name of question. |\n| `NEW_ANSWER` | A new answer is added to the location. The notification will provide the resource name of question and answer. |\n| `UPDATED_ANSWER` | An answer of the location is updated. The notification will provide the resource name of question and answer. |\n| `DUPLICATE_LOCATION` | Indicates whether there is a change in location metadata's duplicate location field. |\n| `LOSS_OF_VOICE_OF_MERCHANT` | Deprecated: Migrate the existing usages of this value to the more expanded \"VOICE_OF_MERCHANT_UPDATED\". | This item is deprecated! |\n| `VOICE_OF_MERCHANT_UPDATED` | Indicates whether the location has an update in Voice of Merchant (VOM) status. VOM dictates whether the location is in good standing and the merchant has control over the business on Google. Any edits made to the location will propagate to Maps after passing the review phase. Call GetVoiceOfMerchantState rpc for more details. |"]]
