ב-My Business Notification API, ההתראות מתפרסמות שירות Cloud Pub/Sub. אחרי אחרי שמגדירים את Cloud Pub/Sub ויוצרים נושא, אפשר לבצע את הפעולות הבאות פעולות הנוגעות להתראות:
ביקורות, שאלות ותשובות חדשות או מעודכנות, העלאות של מדיה העדכונים של Google לבדיקה, שינויים במצב המיקום ועוד נתמכים. האובייקט NotificationType ומתאר את סוגי ההתראות הזמינים.
לפני שמתחילים
כדי להשתמש ב-My Business Notification 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 כדי לקשר את החשבון שלך ב'פרופיל העסק ב-Google' לנושא. - (אופציונלי) חוזרים על שלב 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