सेवा खाते, Google के खास खाते होते हैं. इनका इस्तेमाल, ऐप्लिकेशन, OAuth 2.0 के ज़रिए प्रोग्राम के हिसाब से Google APIs को ऐक्सेस करने के लिए कर सकते हैं. सेवा खाते में, OAuth 2.0 के ऐसे फ़्लो का इस्तेमाल किया जाता है जिसके लिए, उपयोगकर्ता की अनुमति की ज़रूरत नहीं होती. इसके बजाय, इसमें कुंजी वाली फ़ाइल का इस्तेमाल किया जाता है. इसे सिर्फ़ आपका ऐप्लिकेशन ऐक्सेस कर सकता है. इस गाइड में, सेवा खातों की मदद से Content API for Shopping को ऐक्सेस करने का तरीका बताया गया है.
ध्यान दें: सेवा खातों का इस्तेमाल करके पुष्टि करने वाले ऐप्लिकेशन, सिर्फ़ आपके Merchant Center खाते को ऐक्सेस कर सकते हैं. अगर आपने तीसरे पक्ष का कोई ऐसा ऐप्लिकेशन बनाया है जिसे आपके क्लाइंट के Merchant Center खातों को ऐक्सेस करने की ज़रूरत है, तो कृपया इसके बजाय, अनुरोधों को अनुमति देना गाइड देखें.
ज़रूरी शर्तें
- एक Merchant Center खाता.
Content API for Shopping को ऐक्सेस करने के लिए, सेवा खाते का इस्तेमाल करने का तरीका
- सेवा खाते के क्रेडेंशियल जनरेट करें या पहले से जनरेट किए गए सार्वजनिक क्रेडेंशियल ऐक्सेस करें. आपको OAuth 2.0 क्लाइंट आईडी बनाना होगा और *.json फ़ॉर्मैट वाली निजी कुंजी की फ़ाइल हासिल करनी होगी:
- Google API Console पर जाएं.
- पेज पर सबसे ऊपर मौजूद ड्रॉप-डाउन मेन्यू में, कोई प्रोजेक्ट चुनें. अगर आपके पास कोई प्रोजेक्ट नहीं है, तो नया प्रोजेक्ट पर क्लिक करके एक प्रोजेक्ट बनाएं.
- अगर आपने इस प्रोजेक्ट के लिए, Content API for Shopping को पहले से चालू नहीं किया है, तो Google APIs की सूची में इसे खोजें और चालू करें.
- सबसे ऊपर बाएं कोने में मौजूद नेविगेशन मेन्यू (☰) पर क्लिक करें. इसके बाद, एपीआई और सेवाएं को चुनें. फिर क्रेडेंशियल को चुनें.
- सेवा खाता सेट अप करने के लिए, क्रेडेंशियल बनाएं को चुनें. इसके बाद, सेवा खाता को चुनें.
- नए सेवा खाते को कोई नाम दें. यह सेवा खाते के आईडी के लिए, डिफ़ॉल्ट उपयोगकर्ता नाम के तौर पर भी काम करता है. सेवा खाते का आईडी रिकॉर्ड करें. इसमें '@' वर्ण के बाद वाला हिस्सा भी शामिल करें, ताकि इसका इस्तेमाल बाद में किया जा सके. बनाएं पर क्लिक करें. इसके बाद, प्रोजेक्ट और उपयोगकर्ताओं को ऐक्सेस देने के लिए,
वैकल्पिक चरणों को पूरा करें. आखिर में, हो गया पर क्लिक करें.
सेवा खाते के लिए चुनी गई भूमिका का, Content API को किए जा सकने वाले कॉल पर कोई असर नहीं पड़ेगा. ऐसा इसलिए, क्योंकि Content API के तरीकों को ऐक्सेस करने की अनुमति, Merchant Center में सेवा खाते के आईडी से जुड़ी भूमिका के आधार पर तय की जाती है. अगर आपको यह तय करने में मुश्किल हो रही है कि कौनसी भूमिका चुनी जाए, तो प्रोजेक्ट > व्यूअर को चुनें.
- आपको सेवा खाते वाले पेज पर रीडायरेक्ट किया जाएगा. यहां आपके नए सेवा खाते को ऐक्सेस किया जा सकता है.
- JSON फ़ॉर्मैट वाली निजी कुंजी पाने के लिए, सेवा खाते पर क्लिक करें. इसके बाद, कुंजियां टैब पर क्लिक करें. कुंजी जोड़ें > नई कुंजी बनाएं पर क्लिक करें. इसके बाद, कुंजी के टाइप के तौर पर JSON को चुनें. अपने कंप्यूटर पर निजी कुंजी डाउनलोड करने के लिए, बनाएं पर क्लिक करें.
- अपने Merchant Center खाते में, नए सेवा खाते को उपयोगकर्ता के तौर पर जोड़ें. अगर आप तीसरे पक्ष के डेवलपर हैं, तो आपको अपने क्लाइंट से यह चरण पूरा कराना होगा.
- अपने Merchant Center खाते पर जाएं.
- अपने Merchant Center खाते की सेटिंग में, खाते का ऐक्सेस पर जाएं.
- + उपयोगकर्ता जोड़ें पर क्लिक करें. इसके बाद, नए उपयोगकर्ता के ईमेल
पते के तौर पर, सेवा खाते के आईडी का इस्तेमाल करें.
अगर आपने पहले सेवा खाते का आईडी नोट नहीं किया है, तो सेवा खातों के एडमिन पेज पर जाएं और बनाया गया प्रोजेक्ट चुनें.
- सेवा खाते के लिए, उपयोगकर्ता का ऐक्सेस और ईमेल सूचनाएं की प्राथमिकताएं तय करें. ध्यान दें कि
Accountsसेवा का इस्तेमाल करने के लिए, एडमिन ऐक्सेस ज़रूरी है. - प्राथमिकताएं सेव करने और उपयोगकर्ताओं की सूची पर वापस जाने के लिए, उपयोगकर्ता जोड़ें पर क्लिक करें. सेवा खाते का आईडी, चुनी गई उपयोगकर्ता की भूमिका के साथ दिखना चाहिए.
- यह प्रोसेस, उन सभी सेवा खातों के लिए दोहराएं जिन्हें आपको जोड़ना है.
- अब सेवा खाते का इस्तेमाल करके, अपने Merchant Center खाते को ऐक्सेस किया जा सकता है. इसके लिए, Google Application Default Credentials फ़्लो का इस्तेमाल किया जा सकता है या सीधे सेवा खाते के फ़्लो का इस्तेमाल किया जा सकता है. Content API for Shopping के सैंपल में, सेवा खाते के क्रेडेंशियल के लिए, दोनों फ़्लो का इस्तेमाल करने का तरीका दिखाया गया है. यह तरीका, हर उस प्रोग्रामिंग भाषा के लिए दिखाया गया है जो Content API for Shopping के साथ काम करती है. कृपया कोड के सैंपल देखें, ताकि अपने नए सेवा खाते को आज़माया जा सके. साथ ही, यह भी जाना जा सके कि अपने कोड में सेवा खातों का इस्तेमाल करने के लिए, आपको कौनसे बदलाव करने होंगे.
अक्सर पूछे जाने वाले सवाल
- क्या मैं अपने सेवा खाते से, Merchant Center के यूज़र इंटरफ़ेस (यूआई) में साइन इन कर सकता/सकती हूं?
- नहीं, सेवा खाते, Google के सामान्य खाते नहीं होते. इसलिए, इनसे Merchant Center के यूज़र इंटरफ़ेस (यूआई) को ऐक्सेस नहीं किया जा सकता.
- मुझे सेवा खाते के ऐक्सेस टोकन को कितनी बार रीफ़्रेश करना होगा?
- Google OAuth 2.0 ऑथराइज़ेशन सर्वर से जारी किए जाने के एक घंटे बाद, ऐक्सेस टोकन की समयसीमा खत्म हो जाती है. जब किसी ऐक्सेस टोकन की समयसीमा खत्म हो जाती है, तो ऐप्लिकेशन को क्लाइंट लाइब्रेरी का इस्तेमाल करके, दूसरा ऐक्सेस टोकन फ़ेच करना चाहिए.