Google Business Performance API یک روش API
جدید دارد که امکان واکشی چندین «DailyMetrics» را در یک درخواست API فراهم می‌کند.
زمان‌بندی منسوخ شدن و دستورالعمل‌های انتقال از روش API reportInsights v4 به API عملکرد نمایه کسب‌وکار Google را مرور کنید.
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 با نوع اعلان خالی یا pubsubTopic را روی یک رشته خالی تنظیم کنید. |
نوع اعلان
نوع اعلان ارسال شده به موضوع Pub/Sub.
| Enums |
|---|
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 Maps به مکان اضافه شده است. اعلان نام منبع مورد رسانه جدید را ارائه می دهد. |
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 کنترل دارد یا خیر. هر گونه ویرایشی که در مکان انجام شود پس از گذراندن مرحله بازبینی در Maps منتشر می شود. برای جزئیات بیشتر با GetVoiceOfMerchantState rpc تماس بگیرید. |
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده 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. |"]]
