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
endpoint, किसी खाते के लिए 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