إدارة الإشعارات في الوقت الفعلي

في My Business Notifications API، يتم نشر الإشعارات في خدمة Cloud Pub/Sub. بعد بعد إعداد خدمة Cloud Pub/Sub وإنشاء موضوع، يمكنك تنفيذ ما يلي: العمليات المتعلقة بالإشعارات:

• استرداد إعدادات الإشعارات
• تعديل إعدادات الإشعارات:
• حذف إعدادات الإشعارات

مراجعات وأسئلة وأجوبة جديدة أو محدّثة وتحميلات الوسائط تتوفّر تحديثات Google للمراجعة وتغييرات في حالة الموقع الجغرافي وغير ذلك. الكائن NotificationType ويسرد ويصف أنواع الإشعارات المتاحة.

قبل البدء

لاستخدام واجهة برمجة تطبيقات "إشعارات نشاطي التجاري"، يجب تسجيل تطبيقك والحصول على بيانات اعتماد OAuth 2.0 للاطّلاع على تفاصيل حول كيفية بدء استخدام واجهة برمجة التطبيقات، راجِع الإعداد الأساسي.

إعداد Cloud Pub/Sub

لإعداد إشعارات واجهة برمجة التطبيقات باستخدام Cloud Pub/Sub، عليك اتّباع الخطوات التالية:

1. اتّبِع دليل Cloud Pub/Sub من أجل: إعداد تطبيقك
2. إنشاء موضوع في مشروع Cloud Pub/Sub وتدوين اسم الموضوع الذي تم إنشاؤه.
3. يمكنك تقديم مبلغ pubsub.topics.publish على الأقل. الأذونات إلى [e-mail].
4. اتّبِع صفحة نظرة عامة على المشتركين. الدليل لإعداد الإشعارات الفورية أو الإشعارات الفورية.
5. لتلقّي الإشعارات، يُرجى الاتصال بخدمة accounts.updateNotificationSetting نقطة نهاية في واجهة برمجة تطبيقات إشعارات نشاطي التجاري. في المكالمة، استخدِم الموضوع الاسم الذي أنشأته في Cloud Pub/Sub لربط حسابك على "الملف التجاري" بالموضوع.
6. (اختياري) كرِّر الخطوة 5 لكل حساب تريد على "الملف التجاري" تنفيذه. تلقي إشعارات بشأنها.

استرداد إعدادات الإشعارات

accounts.getNotificationSetting تُرجع نقطة النهاية إعدادات إشعارات Cloud Pub/Sub الحالية الحساب. يوضح الجدول التالي كيفية تسميتها:

بروتوكول HTTP

GET
https://mybusinessnotifications.googleapis.com/v1/accounts/{accountId}/notificationSetting

تعديل إعدادات الإشعارات

accounts.updateNotificationSetting تعدِّل نقطة النهاية إعدادات إشعارات Cloud Pub/Sub المرتبطة الحساب. يوضح الجدول التالي كيفية تسميتها:

بروتوكول HTTP

PATCH
https://mybusinessnotifications.googleapis.com/v1/accounts/{accountId}/notificationSetting?updateMask={commaSeparatedFieldsToUpdate}

{
  pubsubTopic: your/pubsub/topicName
}

حذف إعدادات الإشعارات

جارٍ الاتصال بالرقم accounts.updateNotificationSetting يؤدي ترك pubsubTopic فارغًا إلى حذف إعدادات إشعارات Cloud Pub/Sub من الحساب. يوضح الجدول التالي كيفية تسميتها:

بروتوكول HTTP

PATCH
https://mybusinessnotifications.googleapis.com/v1/accounts/{accountId}/notificationSetting?updateMask=pubsubTopic