क्लाइंट लाइब्रेरी सेट अप करना

हमारा सुझाव है कि Content API for Shopping को सेट अप करने के लिए, Google API की क्लाइंट लाइब्रेरी का इस्तेमाल करें. इस गाइड में, Python के लिए Content API की क्लाइंट लाइब्रेरी को उदाहरण के तौर पर इस्तेमाल किया गया है. हालांकि, यह कई लोकप्रिय प्रोग्रामिंग भाषाओं के लिए उपलब्ध है. साथ ही, यह एपीआई से जुड़े सामान्य टास्क को आसान बनाती है. जैसे, पुष्टि करना, अनुरोध भेजना, और जवाबों को पार्स करना. अन्य भाषाओं के लिए क्लाइंट लाइब्रेरी सेट अप करने में मदद पाने के लिए, GitHub पर googleads/googleads-shopping-samples रिपो में, भाषा के लिए README.md देखें.

Python के लिए Google API की क्लाइंट लाइब्रेरी सेट अप करने के लिए, यह तरीका अपनाएं:

1. क्लाइंट लाइब्रेरी के कॉन्फ़िगरेशन और पुष्टि करने वाली फ़ाइलों के लिए एक डायरेक्ट्री बनाएं. अपनी होम डायरेक्ट्री में, ये डायरेक्ट्री बनाएं:

   ~/shopping-samples/content/

2. अपने सेवा खाते के क्रेडेंशियल डाउनलोड करने के लिए, यह तरीका अपनाएं:

   1. Google API लाइब्रेरी पर जाएं.
   2. पेज पर सबसे ऊपर मौजूद मेन्यू में, कोई प्रोजेक्ट चुनें. अगर आपके पास कोई प्रोजेक्ट नहीं है, तो नया प्रोजेक्ट पर क्लिक करके एक प्रोजेक्ट बनाएं.
   3. अगर आपने इस प्रोजेक्ट के लिए, Content API for Shopping को पहले से चालू नहीं किया है, तो Google के एपीआई की सूची में इसे खोजें और चालू करें.
   4. सबसे ऊपर बाईं ओर मौजूद नेविगेशन मेन्यू (☰) पर क्लिक करें. इसके बाद, एपीआई और सेवाएं को चुनें. फिर, क्रेडेंशियल को चुनें.
   5. सेवा खाता सेट अप करने के लिए, क्रेडेंशियल बनाएं को चुनें. इसके बाद, सेवा खाता को चुनें.
   6. नए सेवा खाते को नाम दें. यह सेवा खाते के आईडी के लिए डिफ़ॉल्ट उपयोगकर्ता नाम के तौर पर भी काम करता है. सेवा खाते का आईडी रिकॉर्ड करें. इसमें '@' वर्ण के बाद वाला हिस्सा भी शामिल करें, ताकि आने वाले समय में इसका इस्तेमाल किया जा सके. बनाएं पर क्लिक करें. इसके बाद, प्रोजेक्ट और उपयोगकर्ताओं को ऐक्सेस देने के वैकल्पिक चरणों को पूरा करें. फिर, हो गया पर क्लिक करें.
   7. आपको सेवा खाते वाले पेज पर रीडायरेक्ट किया जाएगा. यहां आपके नए सेवा खाते को ऐक्सेस किया जा सकता है.

3. JSON फ़ॉर्मैट में निजी कुंजी पाने के लिए, सेवा खाते पर क्लिक करें. इसके बाद, कुंजियां टैब पर क्लिक करें. कुंजी जोड़ें > नई कुंजी बनाएं पर क्लिक करें. इसके बाद, कुंजी के टाइप के तौर पर JSON को चुनें. निजी कुंजी को अपने कंप्यूटर पर डाउनलोड करने के लिए, बनाएं पर क्लिक करें. नई कुंजी अपने-आप डाउनलोड हो जाती है.

4. डाउनलोड की गई क्रेडेंशियल फ़ाइल का नाम बदलकर service-account.json करें.

5. service-account.json फ़ाइल को अपनी home directory/shopping-samples/content/ में ले जाएं.

6. अपनी home directory/shopping-samples/content/ में, एक खाली merchant-info.json फ़ाइल बनाएं.

7. merchant-info.json में, यह टेक्स्ट जोड़ें:

   {
   "merchantId": your Merchant Center merchant ID,
   "accountSampleUser": "the email address associated with your Merchant Center account"
   }
   

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

   1. अपने Merchant Center खाते पर जाएं.
   2. अपने Merchant Center खाते की सेटिंग में, लोग और ऐक्सेस को चुनें.

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

   4. Accounts सेवा का इस्तेमाल करने के लिए, एडमिन का ऐक्सेस ज़रूरी है. इसलिए, एडमिन को चुनें.

   5. वरीयताएं सेव करने और उपयोगकर्ताओं की सूची पर वापस जाने के लिए, उपयोगकर्ता जोड़ें पर क्लिक करें. सेवा खाते का आईडी, चुनी गई उपयोगकर्ता की भूमिका के साथ दिखता है.

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

9. googleads/googleads-shopping-samples GitHub रिपो को अपने कंप्यूटर पर किसी भी जगह क्लोन करें. इसके अलावा, इसे डाउनलोड और अनज़िप भी किया जा सकता है. यह ज़रूरी नहीं है कि यह आपकी होम डायरेक्ट्री या ~/shopping-samples/content/ में हो.

10. अगर आपने रिपो को क्लोन करने के बजाय डाउनलोड और अनज़िप किया है, तो अनज़िप की गई डायरेक्ट्री का नाम बदलकर googleads-shopping-samples करें.

11. सैंपल की ज़रूरी डिपेंडेंसी इंस्टॉल करने के लिए, टर्मिनल विंडो में googleads-shopping-samples/python/ पर जाएं और यह कमांड चलाएं:

    pip install -r requirements.txt
    

अब Python के लिए Google API की क्लाइंट लाइब्रेरी कॉन्फ़िगर हो गई है. अब इसका इस्तेमाल Content API के साथ किया जा सकता है. अगले सेक्शन में, नया प्रॉडक्ट जोड़ने के लिए अनुरोध बनाया और भेजा जाएगा.