تتضمّن واجهة برمجة التطبيقات
لأداء الأعمال في Google طريقة واجهة برمجة تطبيقات
جديدة تتيح جلب عدة "مقاييس يومية" في طلب واحد لواجهة برمجة التطبيقات.
يُرجى مراجعة
الجدول الزمني للإيقاف وتعليمات نقل البيانات من طريقة v4 reportInsights API إلى واجهة برمجة التطبيقات الخاصة بأداء "الملف التجاري على Google".
Notifications
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
موضوع في Google Cloud Pub/Sub يمكن من خلاله نشر الإشعارات عند تعديل موقع جغرافي أو إجراء مراجعة جديدة له. يتوفّر مورد واحد فقط لإعدادات الإشعارات لكل حساب.
| تمثيل JSON |
{
"name": string,
"topicName": string,
"notificationTypes": [
enum (NotificationType)
]
} |
| الحقول |
name |
string
النتائج فقط. اسم مورد الإشعارات.
|
topicName |
string
موضوع Google Cloud Pub/Sub الذي سيتلقى إشعارات عند تعديل المواقع الجغرافية التي يديرها هذا الحساب. وفي حال ترك هذه السياسة بدون ضبط، لن يتم نشر أي إشعارات. يجب أن يتضمّن الحساب mybusiness-api-pubsub@system.gserviceaccount.com أذونات نشر على الأقل في موضوع Cloud Pub/Sub.
|
notificationTypes[] |
enum (NotificationType)
أنواع الإشعارات التي سيتم إرسالها إلى موضوع Cloud Pub/Sub. يجب تحديد حقل واحد على الأقل. لإيقاف تلقّي الإشعارات بالكامل، استخدِم accounts.deleteNotifications.
|
NotificationType
نوع الإشعار الذي تم إرساله إلى موضوع Cloud Pub/Sub.
| عمليات التعداد |
NOTIFICATION_TYPE_UNSPECIFIED |
لا يوجد نوع إشعار. لن يطابق أي إشعارات. |
GOOGLE_UPDATE |
تتوفّر تحديثات Google لمراجعة الموقع الجغرافي. سيوفر حقل locationName في الإشعار اسم المورد للموقع مع تحديثات Google. |
NEW_REVIEW |
تمت إضافة مراجعة جديدة إلى الموقع. سيقدم حقل reviewName في الإشعار اسم مورد المراجعة التي تمت إضافتها، وسيتضمن locationName اسم مورد الموقع. |
UPDATED_REVIEW |
تم تعديل مراجعة للموقع الجغرافي. سيقدم حقل reviewName في الإشعار اسم مورد المراجعة التي تمت إضافتها، وسيتضمن locationName اسم مورد الموقع. |
NEW_CUSTOMER_MEDIA |
أضاف أحد مستخدمي "خرائط Google" عنصر وسائط جديدًا إلى الموقع الجغرافي. سيقدم الإشعار اسم المورد لعنصر الوسائط الجديد. |
NEW_QUESTION |
تمت إضافة سؤال جديد إلى الموقع الجغرافي. سيقدم الإشعار اسم مورد السؤال. |
UPDATED_QUESTION |
تم تعديل سؤال متعلّق بالموقع الجغرافي. سيقدم الإشعار اسم مورد السؤال. |
NEW_ANSWER |
تمت إضافة إجابة جديدة إلى الموقع الجغرافي. سيقدم الإشعار اسم مورد السؤال والإجابة. |
UPDATED_ANSWER |
تم تعديل إجابة الموقع الجغرافي. سيقدم الإشعار اسم مورد السؤال والإجابة. |
UPDATED_LOCATION_STATE |
تم تحديث LocationState للموقع. سيتضمن الإشعار قناع الحقل الخاص بحقول LocationState التي تم تعديلها. |
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eGoogle Cloud Pub/Sub topic allows business accounts to receive notifications about location updates and new reviews.\u003c/p\u003e\n"],["\u003cp\u003eEach account has a single notification settings resource which can be configured to receive different types of notifications.\u003c/p\u003e\n"],["\u003cp\u003eNotifications can be triggered by various events including Google updates, new/updated reviews, customer media, questions, answers, and location state changes.\u003c/p\u003e\n"],["\u003cp\u003eTo receive notifications, the 'mybusiness-api-pubsub@system.gserviceaccount.com' must have publish permissions on the specified Cloud Pub/Sub topic.\u003c/p\u003e\n"],["\u003cp\u003eBusinesses can stop receiving notifications completely using the \u003ccode\u003eaccounts.deleteNotifications\u003c/code\u003e method.\u003c/p\u003e\n"]]],[],null,["# Notifications\n\n- [JSON representation](#SCHEMA_REPRESENTATION)\n- [NotificationType](#NotificationType)\n\nA Google Cloud Pub/Sub topic where notifications can be published when a location is updated or has a new review. There will be only one notification settings resource per-account.\n\n| JSON representation ||\n|------------------------------------------------------------------------------------------------------------------------------------------------|---|\n| ``` { \"name\": string, \"topicName\": string, \"notificationTypes\": [ enum (/my-business/reference/rest/v4/Notifications#NotificationType) ] } ``` |\n\n| Fields ||\n|-----------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `name` | `string` Output only. The notifications resource name. |\n| `topicName` | `string` The Google Cloud 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 Cloud Pub/Sub topic. |\n| `notificationTypes[]` | `enum (`[NotificationType](/my-business/reference/rest/v4/Notifications#NotificationType)`)` The types of notifications that will be sent to the Cloud Pub/Sub topic. At least one must be specified. To stop receiving notifications entirely, use [accounts.deleteNotifications](/my-business/reference/rest/v4/accounts/deleteNotifications#google.mybusiness.v4.Accounts.DeleteNotifications). |\n\nNotificationType\n----------------\n\nType of notification sent to the Cloud 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 locationName 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 reviewName field on the notification will provide the resource name of the review that was added, and locationName will have the location's resource name. |\n| `UPDATED_REVIEW` | A review on the location has been updated. The reviewName field on the notification will provide the resource name of the review that was added, and locationName 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| `UPDATED_LOCATION_STATE` | The LocationState of the Location was updated. The Notification will contain the field mask of the updated LocationState fields. |"]]
