در رابط برنامهنویسی کاربردی اعلانهای کسبوکار من، اعلانها در سرویس Cloud Pub/Sub منتشر میشوند. پس از راهاندازی Cloud Pub/Sub و ایجاد یک موضوع، میتوانید عملیات زیر را روی اعلانها انجام دهید:
نقد و بررسیهای جدید یا بهروزرسانیشده، پرسش و پاسخ، آپلود رسانه، بهروزرسانیهای گوگل برای نقد و بررسی، تغییرات وضعیت مکان و موارد دیگر پشتیبانی میشوند. شیء NotificationType انواع اعلانهای موجود را فهرست و شرح میدهد.
قبل از اینکه شروع کنی
برای استفاده از API اعلانهای کسب و کار من، برنامه خود را ثبت کنید و اعتبارنامههای OAuth 2.0 را دریافت کنید. برای جزئیات بیشتر در مورد نحوه شروع به کار با API، به تنظیمات اولیه مراجعه کنید.
راهاندازی Cloud Pub/Sub
برای تنظیم اعلانهای API با Cloud Pub/Sub ، مراحل زیر را انجام دهید:
- برای راهاندازی برنامه خود، راهنمای Cloud Pub/Sub را دنبال کنید.
- یک موضوع (topic) در پروژه Cloud Pub/Sub خود ایجاد کنید و نام موضوع ایجاد شده را یادداشت کنید.
- حداقل به mybusiness-api-pubsub@system.gserviceaccount.com دسترسی
pubsub.topics.publishبدهید. - برای تنظیم اعلانهای push یا pull، راهنمای نمای کلی مشترکین را دنبال کنید.
- برای دریافت اعلانها، نقطه پایانی
accounts.updateNotificationSettingرا در رابط برنامهنویسی کاربردی اعلانهای کسبوکار من (My Business Notifications API) فراخوانی کنید. در فراخوانی، از نام موضوعی که در Cloud Pub/Sub ایجاد کردهاید برای پیوند دادن حساب نمایه کسبوکار خود به موضوع استفاده کنید. - (اختیاری) مرحله ۵ را برای هر حساب نمایه تجاری که میخواهید برای آن اعلان دریافت کنید، تکرار کنید.
بازیابی تنظیمات اعلانها
نقطه پایانی accounts.getNotificationSetting تنظیمات فعلی اعلان Cloud Pub/Sub را برای یک حساب کاربری برمیگرداند. جدول زیر نحوه فراخوانی آن را نشان میدهد:
GET
https://mybusinessnotifications.googleapis.com/v1/accounts/{accountId}/notificationSetting
تنظیمات اعلان را بهروزرسانی کنید
نقطه پایانی accounts.updateNotificationSetting تنظیمات اعلان Cloud Pub/Sub مرتبط با یک حساب را بهروزرسانی میکند. جدول زیر نحوه فراخوانی آن را نشان میدهد:
PATCH
https://mybusinessnotifications.googleapis.com/v1/accounts/{accountId}/notificationSetting?updateMask={commaSeparatedFieldsToUpdate}
{
pubsubTopic: your/pubsub/topicName
}
تنظیمات اعلان را حذف کنید
فراخوانی accounts.updateNotificationSetting با یک pubsubTopic خالی، تنظیمات اعلان Cloud Pub/Sub را از یک حساب حذف میکند. جدول زیر نحوه فراخوانی آن را نشان میدهد:
PATCH
https://mybusinessnotifications.googleapis.com/v1/accounts/{accountId}/notificationSetting?updateMask=pubsubTopic