تتضمّن واجهة برمجة التطبيقات
لأداء الأعمال في Google طريقة واجهة برمجة تطبيقات
جديدة تتيح جلب عدة "مقاييس يومية" في طلب واحد لواجهة برمجة التطبيقات.
يُرجى مراجعة
الجدول الزمني للإيقاف وتعليمات نقل البيانات من طريقة v4 reportInsights 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 أذونات نشر على الأقل في موضوع النشر/الاشتراك.
|
notificationTypes[] |
enum (NotificationType)
أنواع الإشعارات التي سيتم إرسالها إلى موضوع النشر/الاشتراك. لإيقاف تلقّي الإشعارات تمامًا، استخدِم NotificationSettings.UpdateNotification Setting مع قيمة notificationsTypes فارغة أو اضبط 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 Center. يحدد مقياس VOM ما إذا كان الموقع الجغرافي في وضع جيد وأنّ التاجر يتحكّم في النشاط التجاري على Google. وسيتم نشر أي تعديلات يتم إجراؤها على الموقع الجغرافي على "خرائط Google" بعد اجتياز مرحلة المراجعة. يُرجى الاتصال بـ GetVoiceOfMerchantState rpc للحصول على مزيد من التفاصيل. |
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 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. |"]]
