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

في 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 على الأقل إلى 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