ב-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:
- להגדרת האפליקציה, פועלים לפי ההוראות במדריך של Cloud Pub/Sub.
- יוצרים נושא בפרויקט Cloud Pub/Sub ורושמים את שם הנושא שנוצר.
- נותנים לפחות ל-
pubsub.topics.publish
הרשאות ל-mybusiness-api-pubsub@system.gserviceaccount.com. - פועלים לפי ההוראות שבמדריך סקירה כללית של המנויים כדי להגדיר התראות או משיכה.
- כדי לקבל התראות, מפעילים את נקודת הקצה
accounts.updateNotificationSetting
ב-My Business Notifications API. בשיחה, עליכם להשתמש בשם הנושא שיצרתם ב-Cloud Pub/Sub כדי לקשר את חשבון פרופיל העסק לנושא. - (אופציונלי) חוזרים על שלב 5 לכל חשבון ב'פרופיל העסק ב-Google' שלגביו רוצים לקבל התראות.
אחזור הגדרות ההתראות
נקודת הקצה 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