اعلان‌های بی‌درنگ را مدیریت کنید

در My Business Notifications API، اعلان‌ها در سرویس Cloud Pub/Sub منتشر می‌شوند. پس از راه‌اندازی Cloud Pub/Sub و ایجاد موضوع، می‌توانید عملیات زیر را روی اعلان‌ها انجام دهید:

بررسی‌های جدید یا به‌روزرسانی‌شده، پرسش‌ها و پاسخ‌ها، بارگذاری‌های رسانه‌ای، به‌روزرسانی‌های Google برای بررسی، تغییرات وضعیت مکان و موارد دیگر پشتیبانی می‌شوند. شی NotificationType انواع اعلان موجود را فهرست کرده و توصیف می کند.

قبل از شروع

برای استفاده از My Business Notifications API، برنامه خود را ثبت کنید و اعتبارنامه OAuth 2.0 را دریافت کنید. برای جزئیات در مورد نحوه شروع به کار با API، به تنظیمات اولیه مراجعه کنید.

راه اندازی Cloud Pub/Sub

برای تنظیم اعلان‌های API با 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 ایجاد کرده‌اید استفاده کنید تا حساب نمایه کسب‌وکار خود را به موضوع مرتبط کنید.
  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