Business Profile से जगहों की जानकारी जोड़ना

Business Profile, कारोबारों और संगठनों के लिए मुफ़्त और आसानी से इस्तेमाल किया जाने वाला टूल है. इसकी मदद से, Search और Maps जैसे Google के कई प्लैटफ़ॉर्म पर अपनी मौजूदगी मैनेज की जा सकती है.

Google Business Profile API, Google पर कारोबार की जगह की जानकारी मैनेज करने के लिए इंटरफ़ेस उपलब्ध कराता है. कोई कारोबार, OAuth की सहमति के ज़रिए किसी दूसरे कारोबार को अपनी प्रोफ़ाइल मैनेज करने का ऐक्सेस दे सकता है.

Business Profile पर मैनेज किए जा रहे कारोबारों की पुष्टि, Business Profile की पुष्टि करने की प्रोसेस के ज़रिए पहले ही हो चुकी है. Business Messages का इस्तेमाल करने के लिए, इन कारोबारों को जोड़ने और Business Messages पर लॉन्च करने के लिए, Business Profile के OAuth के सहमति फ़्लो का इस्तेमाल किया जा सकता है. इससे, कारोबारों की पुष्टि अपने-आप हो जाएगी.

Business Messages को लॉन्च करने का यह तरीका, ज़्यादा स्केलेबल और तेज़ है. साथ ही, Business Profile में मौजूद जगह की जानकारी के लिए मैसेज सेवा चालू करने का यह सुझाया गया तरीका है.

ज़रूरी शर्तें

आपके पास Business Profile का मौजूदा पार्टनर होना चाहिए और आपके पास Google Business Profile API का ऐक्सेस होना चाहिए. अगर आपके पास Business Profile का ऐक्सेस नहीं है, तो ऐक्सेस पाने के लिए, Business Profile के ज़रूरी शर्तों को पूरा करें.

Google Business Profile API का ऐक्सेस मिलने के बाद, आगे बढ़ने से पहले, सामान्य सेटअप और OAuth सेटअप के लिए दी गई गाइड देखें.

Business Profile पर मौजूद, पुष्टि की गई जगह के लिए Business Messages की सुविधा चालू करना

नीचे दिए गए डायग्राम में दिखाया गया है कि आपकी वेब सेवा, Business Messages एजेंट के लिए, किसी ब्रैंड की Business Profile की जगह की पुष्टि का फ़ायदा कैसे ले सकती है. ज़्यादा जानकारी के लिए, यहां देखें.

1. OAuth की सहमति के मौजूदा फ़्लो में, Business Profile खाते का मालिक आपको अपनी ओर से Google Business Profile के एपीआई को कॉल करने का ऐक्सेस देता है. इस फ़्लो में, एपीआई के दायरे को अपडेट करके इन चीज़ों को शामिल करें

   • https://www.googleapis.com/auth/business.manage
   • https://www.googleapis.com/auth/businesscommunications

   एजेंट और कारोबार की जगहों की अपने-आप पुष्टि करने के लिए, दोनों स्कोप ज़रूरी हैं.

2. displayName के साथ एजेंट बनाएं, जो पिछले चरण में मिले OAuth क्रेडेंशियल के मालिकाना हक वाली Google Business Profile की कम से कम एक लिस्टिंग के नाम से मेल खाता हो. कारोबारों के नाम ढूंढने के लिए, Google Business Profile API की मदद से जगहें खोजें.

   नाम मैच करने के लिए,

   • अक्षरों के केस पर कोई असर नहीं पड़ता.
   • एजेंट का पूरा नाम, Business Profile में कारोबार की जगह के नाम के पहले शब्द या शब्दों से पूरी तरह मेल खाना चाहिए. उदाहरण के लिए, "GBP Bakery" नाम का एजेंट, "Gbp Bakery Mountain View", "Gbp Bakery", और "gbp bakery sunnyvale" से मैच करता है, लेकिन "Bakery San Francisco" से नहीं.

3. Business Profile में मौजूद हर जगह के लिए, एक ही placeId का इस्तेमाल करके जगह की जानकारी जोड़ें. Google Business Profile API से किसी जगह की जानकारी हासिल करने पर, Business Profile की जगह की जानकारी के लिए placeId, LocationKey ऑब्जेक्ट में शामिल होता है.

4. आपने जो एजेंट बनाया है और जो OAuth टोकन हासिल किया है उसके साथ, एजेंट की पुष्टि का अनुरोध करें.

   ध्यान दें: आपको अपने प्रोजेक्ट के सेवा खाते की कुंजी के बजाय, मिले हुए ड्यूअल-स्कोप OAuth टोकन का इस्तेमाल करना होगा.

   पुष्टि के अनुरोध के लिए, ब्रैंड की संपर्क जानकारी देना ज़रूरी है. हालांकि, अगर एजेंट का नाम, Business Profile के नाम से मेल खाता है और आपने सही स्कोप के साथ OAuth टोकन हासिल किया है, तो पुष्टि करने की प्रोसेस के दौरान ब्रैंड को ईमेल नहीं भेजा जाएगा.

   अगर आपने यह सही तरीके से किया है, तो पुष्टि के अनुरोध का आउटपुट तुरंत VERIFICATION_STATE_VERIFIED का verificationState दिखाना चाहिए. अगर verificationState कोई दूसरी वैल्यू दिखाता है, तो हो सकता है कि आपने अनुरोध करते समय सही OAuth टोकन का इस्तेमाल न किया हो या एजेंट को Business Profile की जगह से मैच न किया जा सका हो.

5. उसी OAuth टोकन का इस्तेमाल करके, Business Profile पर कारोबार की सभी जगहों के लिए जगह की पुष्टि का अनुरोध करें.

   एजेंट की पुष्टि करने की तरह ही, अगर आपने यह काम सही तरीके से किया है, तो पुष्टि के अनुरोध का आउटपुट तुरंत verificationState of VERIFICATION_STATE_VERIFIED दिखाना चाहिए. अगर verificationState कोई दूसरी वैल्यू दिखाता है, तो हो सकता है कि आपने अनुरोध करते समय सही OAuth टोकन का इस्तेमाल न किया हो. इसके अलावा, ऐसा भी हो सकता है कि Business Profile में मौजूद कारोबार की जगह पर, दावा न किया गया हो और उसकी पुष्टि न की गई हो.

6. एंट्री पॉइंट LOCATION की मदद से, एजेंट को लॉन्च करें.

7. Search और Maps पर अपने स्टोर की जानकारी दिखाने के लिए, उन जगहों को लॉन्च करें जहां आपको अपने स्टोर की जानकारी दिखानी है. इसके बाद, उन जगहों के लिए मैसेज सेवा चालू करें. लॉन्च की प्रोसेस शुरू होने के बाद, लॉन्च की गई हर जगह के लिए मैसेज सेवा, उपयोगकर्ताओं के लिए कुछ घंटों में उपलब्ध हो जाती है.

यह तरीका अपनाने के बाद, ग्राहकों के सभी मैसेज, रजिस्टर किए गए आपके Business Messages वेबहुक पर पोस्ट हो जाएंगे. साथ ही, आपको Business Messages API की मदद से, ग्राहकों को जवाब भेजने होंगे.