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

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

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

قبل البدء

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

إعداد Cloud Pub/Sub

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

  1. اتّبِع دليل Cloud Pub/Sub لإعداد تطبيقك.
  2. أنشئ موضوعًا في مشروعك على Cloud Pub/Sub وسجِّل اسم الموضوع الذي تم إنشاؤه.
  3. امنح pubsub.topics.publish إذنًا على الأقل لحساب mybusiness-api-pubsub@system.gserviceaccount.com.
  4. اتّبِع دليل نظرة عامة على المشتركين لإعداد الإشعارات الفورية أو الإشعارات التي يتم طلبها.
  5. لتلقّي الإشعارات، يمكنك الاتصال بنقطت نهاية accounts.updateNotificationSetting في واجهة برمجة التطبيقات My Business Notifications API. في المكالمة، استخدِم اسم الموضوع الذي أنشأته في Cloud Pub/Sub لربط حسابك على "الملف التجاري على Google" بالموضوع.
  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