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

पेश है Merchant API, जो Content API for Shopping का आधिकारिक उत्तराधिकारी है. Merchant API, बीटा वर्शन में है.

Merchant API की नई सुविधाओं, दस्तावेज़ से जुड़े बड़े अपडेट, गड़बड़ी ठीक करने, और रिलीज़ से जुड़े अपडेट के बारे में जानने के लिए, हाल ही की घोषणाएं देखें.

Google पर अपने कारोबार और प्रॉडक्ट को दिखाने का तरीका मैनेज करने और बड़े पैमाने पर डेटा, अहम जानकारी, और खास सुविधाओं का प्रोग्राम के हिसाब से ऐक्सेस पाने का तरीका जानने के लिए, Merchant API का इस्तेमाल शुरू करना लेख पढ़ें.

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

ध्यान दें: Python में सैंपल कोड का इस्तेमाल करने के लिए, आपको कई ज़रूरी लाइब्रेरी इंस्टॉल करनी होंगी. इसलिए, हमारा सुझाव है कि आगे बढ़ने से पहले, Python वर्चुअल एनवायरमेंट बनाएं. ज़्यादा जानकारी के लिए, pip और वर्चुअल एनवायरमेंट का इस्तेमाल करके पैकेज इंस्टॉल करना लेख पढ़ें.

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

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

   ~/shopping-samples/content/

   ध्यान दें: यह पाथ और पांचवें चरण में बनाई गई merchant-info.json फ़ाइल का फ़ाइल नाम, सातवें चरण में डाउनलोड की गई Content API सैंपल डायरेक्ट्री में मौजूद python/shopping/content/common.py फ़ाइल में बताया गया है.

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

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

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

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

   ध्यान दें: इस फ़ाइल का नाम, _constants.py फ़ाइल में बताया गया है. यह फ़ाइल, सातवें चरण में डाउनलोड की गई Content API सैंपल डायरेक्ट्री में python/shopping/content/ में मौजूद है.

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 के साथ इस्तेमाल के लिए तैयार है. अगले सेक्शन में, आपको नया प्रॉडक्ट डालने के लिए अनुरोध बनाना और भेजना होगा.