Manufacturer Center API के साथ, OAuth 2.0 सेवा खातों का इस्तेमाल करना

सेवा खाते, खास Google खाते होते हैं. इनका इस्तेमाल ऐप्लिकेशन, OAuth 2.0 के ज़रिए प्रोग्राम के हिसाब से Google API को ऐक्सेस करने के लिए कर सकते हैं. सेवा खाता, ऐसे OAuth 2.0 फ़्लो का इस्तेमाल करता है. इसके लिए, अलग से अनुमति लेने की ज़रूरत नहीं होती. इसके बजाय, यह एक मुख्य फ़ाइल का इस्तेमाल करता है, जिसे सिर्फ़ आपका ऐप्लिकेशन ऐक्सेस कर सकता है. इस गाइड में, सेवा खातों से Manufacturer Center API को ऐक्सेस करने के तरीके के बारे में बताया गया है.

ध्यान दें: पुष्टि करने के लिए सेवा खातों का इस्तेमाल करने वाले ऐप्लिकेशन, सिर्फ़ आपका Manufacturer Center खाता ऐक्सेस कर सकते हैं. अगर आपको तीसरे पक्ष का कोई ऐसा ऐप्लिकेशन लिखना है जिसे आपके क्लाइंट के Manufacturer Center खातों का ऐक्सेस चाहिए, तो अनुरोध स्वीकार करने की अनुमति देने वाली गाइड देखें.

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

• Manufacturer Center खाता.

Manufacturer Center API को ऐक्सेस करने के लिए, सेवा खाते का इस्तेमाल करने का तरीका

1. सेवा खाते के क्रेडेंशियल जनरेट करें या पहले से जनरेट किए गए सार्वजनिक क्रेडेंशियल को ऐक्सेस करें. आपको एक OAuth 2.0 क्लाइंट आईडी बनानी होगी और एक *.json निजी कुंजी फ़ाइल पानी होगी:

   1. Google के एपीआई कंसोल पर जाएं.

   2. पेज पर सबसे ऊपर मौजूद ड्रॉप-डाउन मेन्यू में, कोई प्रोजेक्ट चुनें. अगर आपके पास अब तक कोई Google खाता नहीं है, तो प्रोजेक्ट बनाएं पर क्लिक करके, खाता बनाएं.

   3. अगर आपने इस प्रोजेक्ट के लिए पहले से Manufacturer Center API को चालू नहीं किया है, तो उसे Google API की सूची में खोजें और चालू करें.

   4. बाईं ओर साइडबार में, क्रेडेंशियल चुनें.

   5. सेवा खाता सेट अप करने के लिए, क्रेडेंशियल बनाएं चुनें. इसके बाद, सेवा खाता कुंजी चुनें.

   

   1. अगले पेज पर, ड्रॉप-डाउन सूची से नया सेवा खाता चुनें.

   2. नए सेवा खाते को नाम दें. यह सेवा खाता आईडी के लिए, डिफ़ॉल्ट उपयोगकर्ता नाम के तौर पर भी काम करता है. बाद में इस्तेमाल करने के लिए सेवा खाता आईडी को याद रखें.

   ध्यान दें: सेवा खाते के लिए भूमिका चुनने से इस बात पर कोई असर नहीं पड़ेगा कि Manufacturer Center API को कौनसे कॉल किए जा सकते हैं. इसकी वजह यह है कि Manufacturer Center में सेवा खाता आईडी का ऐक्सेस, इसके बजाय Manufacturer Center में मौजूद सेवा खाता आईडी से तय होने वाली भूमिका से तय होता है. अगर आपको नहीं पता कि क्या चुनना है, तो Project►Viewer चुनें.

   

   1. कुंजी के टाइप के लिए JSON चुनें. इसके बाद, बनाएं पर क्लिक करें.

   2. बनाएं बटन, बनाया जा रहा है... बटन में बदल जाएगा. कुंजी जनरेट हो जाने के बाद, यह निजी कुंजी को *.json फ़ाइल के तौर पर अपने-आप डाउनलोड कर देगा.

   अहम जानकारी: *.json कुंजी वाली फ़ाइल को सुरक्षित रखें. इससे, सेवा खाते को Google की उन सेवाओं को ऐक्सेस करने की अनुमति मिलती है जिनके लिए उसे अनुमति दी गई है. सेवा खातों को सिर्फ़ एक Google API को ऐक्सेस करने की अनुमति देना अच्छी बात है. इससे, सेवा खाते की *.json कुंजी वाली फ़ाइल के हैक होने की स्थिति में, हमलावर के डेटा को ऐक्सेस करने की सीमा को कम किया जा सकता है.
   1. आपको क्रेडेंशियल वाले पेज पर वापस भेज दिया जाएगा. साथ ही, आपको अपने खाते के लिए सेवा खाते की कुंजियों की सूची में, नया सेवा खाता दिखेगा.

2. अपने Manufacturer Center खाते में उपयोगकर्ता के तौर पर नया सेवा खाता जोड़ें. अगर आप तीसरे पक्ष के डेवलपर हैं, तो आपको यह चरण अपने क्लाइंट से करवाना होगा.

   1. अपने Manufacturer Center खाते पर जाएं.

   2. Manufacturer Center खाते की सेटिंग में 'उपयोगकर्ताओं' की सूची पर जाएं.

   3. +उपयोगकर्ता बटन पर क्लिक करें और नए उपयोगकर्ता के लिए ईमेल पते के तौर पर सेवा खाता आईडी का इस्तेमाल करें.

      

   4. फ़ॉर्म में सेवा खाता आईडी डालें और उपयोगकर्ता की पसंद के मुताबिक भूमिका(भूमिकाएं) चुनें. कम से कम किसी एक को चुनना ज़रूरी है. Accounts सेवा के इस्तेमाल के लिए, एडमिन की भूमिका ज़रूरी है.

   अगर आपने पहले सेवा खाता आईडी को नोट नहीं किया है, तो सेवा खाते एडमिन पेज पर जाएं और वह प्रोजेक्ट चुनें जिसे आपने बनाया है.

   

   1. सेव करें बटन पर क्लिक करें. आपको उपयोगकर्ताओं की सूची दिखेगी. साथ ही, उपयोगकर्ता की चुनी गई भूमिका(भूमिकाओं) के साथ सेवा खाता आईडी भी दर्ज होना चाहिए.

   2. उन सभी सेवा खातों के लिए यह प्रोसेस दोहराएं जिन्हें आपको जोड़ना है.

   3. 'उपयोगकर्ता' टैब में जाकर, सेवा खाते के मौजूदा उपयोगकर्ताओं को देखा जा सकता है. ये ऐसे उपयोगकर्ता होंगे जिनके ईमेल पते के आखिर में 'gserviceaccount.com' होगा.

3. अब आपके पास सेवा खाते का इस्तेमाल करके, अपना Manufacturer Center खाता ऐक्सेस करने का विकल्प है. खाता ऐक्सेस करने के लिए, Google ऐप्लिकेशन के डिफ़ॉल्ट क्रेडेंशियल फ़्लो का इस्तेमाल करें या फिर सीधे सेवा खाते के फ़्लो का इस्तेमाल करें. Manufacturer Center API के सैंपल में बताया गया है कि इस्तेमाल की जा सकने वाली हर प्रोग्रामिंग भाषा में, सेवा खाते के क्रेडेंशियल के लिए दोनों फ़्लो का इस्तेमाल कैसे किया जाए. अपने नए सेवा खाते को आज़माने के लिए और अपने कोड में सेवा खातों का इस्तेमाल करने के लिए, आपको किन बदलावों की ज़रूरत होगी, यह जानने के लिए कोड के नमूने देखें.

अक्सर पूछे जाने वाले सवाल

क्या Manufacturer Center के वेब यूज़र इंटरफ़ेस में, सेवा खाते से लॉग इन किया जा सकता है?

नहीं, सेवा खाते, सामान्य Google खाते नहीं हैं. इसलिए, Manufacturer Center के वेब यूज़र इंटरफ़ेस को ऐक्सेस नहीं किया जा सकता.

मुझे सेवा खाते के ऐक्सेस टोकन को कितनी बार रीफ़्रेश करना होगा?

Google OAuth 2.0 ऑथराइज़ेशन सर्वर से मिले ऐक्सेस टोकन की समयसीमा, एक घंटे में खत्म हो जाती है. ऐक्सेस टोकन की समयसीमा खत्म होने पर, ऐप्लिकेशन को दूसरा ऐक्सेस टोकन फ़ेच करने के लिए क्लाइंट लाइब्रेरी का इस्तेमाल करना चाहिए.