Google Business Performance API 的
NEW API 方法可擷取單一 API 要求中的多個「DailyMetrics」。
請詳閱
淘汰時間表和從 v4 reportInsights API 方法遷移至 Google Business Profile Performance API 的操作說明。
NotificationSetting
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
在位置更新或有新評論時發布通知的 Google Pub/Sub 主題。每個帳戶只會有一項通知設定資源。
JSON 表示法 |
{
"name": string,
"pubsubTopic": string,
"notificationTypes": [
enum (NotificationType )
]
} |
欄位 |
name |
string
必要欄位。這項設定適用的資源名稱。這份表單的格式為 accounts/{account_id}/notificationSetting 。
|
pubsubTopic |
string
選用設定。這個 Google Pub/Sub 主題會在這個帳戶管理的位置更新時接收通知。如未設定,系統就不會發布任何通知。 帳戶 mybusiness-api-pubsub@system.gserviceaccount.com 至少必須具備 Pub/Sub 主題的發布權限。
|
notificationTypes[] |
enum (NotificationType )
會傳送至 Pub/Sub 主題的通知類型。如要完全停止接收通知,請使用 NotificationSettings.UpdateNotificationSetting 其中空白的通知 Type,或將 pubsubTopic 設為空字串。
|
NotificationType
列舉 |
NOTIFICATION_TYPE_UNSPECIFIED |
無通知類型。沒有任何通知。 |
GOOGLE_UPDATE |
這個地點有 Google 資訊更新需要審查。通知中的 location_name 欄位會顯示該位置的資源名稱,並顯示 Google 資訊更新。 |
NEW_REVIEW |
已針對地點新增評論。通知中的 review_name 欄位會顯示所新增評論的資源名稱,而 location_name 會包含地點的資源名稱。 |
UPDATED_REVIEW |
針對營業地點的評論已更新。通知中的 review_name 欄位會顯示所新增評論的資源名稱,而 location_name 會包含地點的資源名稱。 |
NEW_CUSTOMER_MEDIA |
有 Google 地圖使用者已將新的媒體項目新增至位置。通知中會提供新媒體項目的資源名稱。 |
NEW_QUESTION |
系統會在地點新增問題。通知中會提供問題的資源名稱。 |
UPDATED_QUESTION |
地點的問題已更新。通知中會提供問題的資源名稱。 |
NEW_ANSWER |
地點會新增一個答案。通知中會提供問題與答案的資源名稱。 |
UPDATED_ANSWER |
該地點的答案已更新。通知中會提供問題與答案的資源名稱。 |
DUPLICATE_LOCATION |
指出地點中繼資料的重複位置欄位是否有變更。 |
LOSS_OF_VOICE_OF_MERCHANT |
已淘汰:將這個值的現有使用方式遷移至範圍更廣的「VOICE_OF_MERCHANT_UPDATED」。 |
VOICE_OF_MERCHANT_UPDATED |
表示營業地點是否在 Voice of Merchant (VOM) 狀態更新。VOM 會決定地點的信譽是否良好,以及商家能否在 Google 上管理商家。經過審查後,你對地點所做的任何修改都會反映在 Google 地圖上。如要瞭解詳情,請呼叫 GetVoiceOfMerchantState。 |
除非另有註明,否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權,程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間:2025-07-25 (世界標準時間)。
[null,null,["上次更新時間:2025-07-25 (世界標準時間)。"],[[["\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. |"]]