ניהול ההתראות בזמן אמת

ב-My Business Notifications API, ההתראות מתפרסמות בשירות Cloud Pub/Sub. אחרי שמגדירים את Cloud Pub/Sub ויוצרים נושא, אפשר לבצע את הפעולות הבאות בהתראות:

הדף כולל תמיכה בביקורות, שאלות ותשובות, העלאות של מדיה חדשות או עדכונים של Google, עדכונים של 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 לכל חשבון ב'פרופיל העסק ב-Google' שלגביו רוצים לקבל התראות.

אחזור הגדרות ההתראות

נקודת הקצה 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