My Business Notifications API में, सूचनाएं Cloud Pub/Sub सेवा में पब्लिश की जाती हैं. Cloud Pub/Sub को सेट अप करने और कोई विषय बनाने के बाद, सूचनाओं पर ये कार्रवाइयां की जा सकती हैं:
नई या अपडेट की गई समीक्षाएं, सवाल और जवाब, मीडिया अपलोड, समीक्षा के लिए Google के अपडेट, कारोबार की स्थिति में बदलाव वगैरह किए जा सकते हैं. NotificationType ऑब्जेक्ट, सूचना के उपलब्ध टाइप की सूची बनाता है और उनके बारे में जानकारी देता है.
शुरू करने से पहले
My Business Notifications API का इस्तेमाल करने के लिए, अपना ऐप्लिकेशन रजिस्टर करें और OAuth 2.0 क्रेडेंशियल पाएं. एपीआई का इस्तेमाल शुरू करने के तरीके के बारे में जानने के लिए, बेसिक सेटअप देखें.
Cloud Pub/Sub का सेटअप
Cloud Pub/Sub के साथ एपीआई सूचनाएं सेट अप करने के लिए, यह तरीका अपनाएं:
- अपना ऐप्लिकेशन सेट अप करने के लिए, Cloud Pub/Sub की गाइड पढ़ें.
- अपने Cloud Pub/Sub प्रोजेक्ट में कोई टॉपिक बनाएं और बनाए गए टॉपिक का नाम नोट करें.
- mybusiness-api-pubsub@system.gserviceaccount.com को कम से कम
pubsub.topics.publish
अनुमतियां दें. - पुश या पुल नोटिफ़िकेशन सेट अप करने के लिए, सदस्यों के बारे में खास जानकारी वाली गाइड का पालन करें.
- सूचनाएं पाने के लिए, My Business Notifications API में
accounts.updateNotificationSetting
एंडपॉइंट को कॉल करें. कॉल में, अपने Business Profile खाते को विषय से लिंक करने के लिए, Cloud Pub/Sub में बनाए गए विषय के नाम का इस्तेमाल करें. - (ज़रूरी नहीं) हर उस Business Profile खाते के लिए पांचवां चरण दोहराएं जिससे आपको सूचनाएं चाहिए.
सूचना सेटिंग वापस लाना
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 }
सूचना सेटिंग मिटाना
खाली pubsubTopic
के साथ accounts.updateNotificationSetting
को कॉल करने पर, किसी खाते से Cloud Pub/Sub की सूचना सेटिंग मिट जाती हैं.
इस टेबल में, इसे कॉल करने का तरीका बताया गया है:
PATCH https://mybusinessnotifications.googleapis.com/v1/accounts/{accountId}/notificationSetting?updateMask=pubsubTopic