تتضمّن واجهة برمجة التطبيقات
لأداء الأعمال في Google طريقة واجهة برمجة تطبيقات
جديدة تتيح جلب عدة "مقاييس يومية" في طلب واحد لواجهة برمجة التطبيقات.
يُرجى مراجعة
الجدول الزمني للإيقاف وتعليمات نقل البيانات من طريقة v4 reportInsights API إلى واجهة برمجة التطبيقات الخاصة بأداء "الملف التجاري على Google".
Method: accounts.updateNotificationSetting
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
تعمل على ضبط إعداد إشعار pubsub للحساب الذي يُعلم Google بالموضوع الذي تريد إرسال إشعارات pubsub له. استخدم الحقل NotificationTypes (أنواع الإشعارات) ضمن notifications Settings (إعدادات الإشعارات) لضبط الأحداث التي يريد الحساب الاشتراك فيها.
سيتضمن الحساب موردًا واحدًا فقط لإعداد الإشعارات، ويمكن ضبط موضوع pubsub واحد فقط. لحذف الإعدادات، يجب تعديل الحقل الخاص بأنواع الإشعارات.
طلب HTTP
PATCH https://mybusinessnotifications.googleapis.com/v1/{notificationSetting.name=accounts/*/notificationSetting}
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
مَعلمات المسار
| المَعلمات |
notificationSetting.name |
string
مطلوبة. اسم المورد المعيَّن لهذا الإعداد هذا هو النموذج accounts/{account_id}/notificationSetting.
|
معلمات طلب البحث
| المَعلمات |
updateMask |
string (FieldMask format)
مطلوبة. الحقول المحددة التي يجب تعديلها. الحقل الوحيد القابل للتعديل هو NotificationSettings (إعدادات الإشعارات). هذه قائمة مفصولة بفواصل تضم أسماء الحقول المؤهلة بالكامل. مثال: "user.displayName,photo"
|
نص الطلب
يحتوي نص الطلب على مثال NotificationSetting.
نص الاستجابة
إذا كانت الاستجابة ناجحة، يحتوي نص الاستجابة على مثال NotificationSetting.
نطاقات التفويض
يجب توفير نطاق OAuth التالي:
https://www.googleapis.com/auth/business.manage
لمزيد من المعلومات، راجِع نظرة عامة على بروتوكول OAuth 2.0.
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eAllows configuration of Pub/Sub notification settings for Google My Business accounts to receive event updates.\u003c/p\u003e\n"],["\u003cp\u003eOnly one notification setting and Pub/Sub topic are allowed per account; update with empty notificationTypes to delete the setting.\u003c/p\u003e\n"],["\u003cp\u003eRequires the \u003ccode\u003ehttps://www.googleapis.com/auth/business.manage\u003c/code\u003e OAuth scope for authorization.\u003c/p\u003e\n"],["\u003cp\u003eUses a PATCH request to \u003ccode\u003ehttps://mybusinessnotifications.googleapis.com/v1/{notificationSetting.name=accounts/*/notificationSetting}\u003c/code\u003e to update settings.\u003c/p\u003e\n"],["\u003cp\u003eProvides a \u003ccode\u003enotificationTypes\u003c/code\u003e field within the \u003ccode\u003enotificationSetting\u003c/code\u003e object for managing event subscriptions.\u003c/p\u003e\n"]]],[],null,["# Method: accounts.updateNotificationSetting\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n\nSets the pubsub notification setting for the account informing Google which topic to send pubsub notifications for. Use the notificationTypes field within notificationSetting to manipulate the events an account wants to subscribe to.\n\nAn account will only have one notification setting resource, and only one pubsub topic can be set. To delete the setting, update with an empty notificationTypes\n\n### HTTP request\n\n`PATCH https://mybusinessnotifications.googleapis.com/v1/{notificationSetting.name=accounts/*/notificationSetting}`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|----------------------------|----------------------------------------------------------------------------------------------------------------------------|\n| `notificationSetting.name` | `string` Required. The resource name this setting is for. This is of the form `accounts/{account_id}/notificationSetting`. |\n\n### Query parameters\n\n| Parameters ||\n|--------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `updateMask` | `string (`[FieldMask](https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#google.protobuf.FieldMask)` format)` Required. The specific fields that should be updated. The only editable field is notificationSetting. This is a comma-separated list of fully qualified names of fields. Example: `\"user.displayName,photo\"`. |\n\n### Request body\n\nThe request body contains an instance of [NotificationSetting](/my-business/reference/notifications/rest/v1/NotificationSetting).\n\n### Response body\n\nIf successful, the response body contains an instance of [NotificationSetting](/my-business/reference/notifications/rest/v1/NotificationSetting).\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/business.manage`\n\nFor more information, see the [OAuth 2.0 Overview](https://developers.google.com/identity/protocols/OAuth2)."]]
