एपीआई कॉल करें

GitHub पर मौजूद googleads/googleads-shopping-samples रिपॉज़िटरी में, हर क्लाइंट लाइब्रेरी के लिए सामान्य ऑपरेशन का सैंपल कोड मौजूद है. उदाहरण के लिए, googleads-shopping-samples/python/shopping/content/products/ में मौजूद सैंपल, Python के साथ products संसाधन का इस्तेमाल करके, सामान्य ऑपरेशन के लिए कोड उपलब्ध कराते हैं. इस गाइड में, आपको एक खाली फ़ाइल से शुरू करके, एक उदाहरण बनाना होगा. इस उदाहरण में, एक नया प्रॉडक्ट डाला जाएगा. इससे, आपको Content API के साथ इंटिग्रेट किए गए ऐप्लिकेशन के बुनियादी स्ट्रक्चर और ज़रूरी कॉम्पोनेंट के बारे में पता चलेगा. आखिर में, नतीजा products/insert.py सैंपल फ़ाइल में दिए गए उदाहरण जैसा ही होगा. इसके बाद, products.list तरीके के लिए एपीआई एक्सप्लोरर का इस्तेमाल करके, यह पुष्टि की जा सकती है कि प्रॉडक्ट जोड़ दिया गया है.

अपना पहला कॉल करने के लिए, यह तरीका अपनाएं:

1. googleads-shopping-samples/python/shopping/content/products/ डायरेक्ट्री में, एक खाली my-insert.py फ़ाइल बनाएं. इस फ़ाइल में, नीचे दिए गए सभी चरणों में मौजूद कोड जोड़ें.

2. ज़रूरी मॉड्यूल के लिए इंपोर्ट स्टेटमेंट जोड़ें.

   my-insert.py की शुरुआत में, यह कोड जोड़ें:

   from __future__ import print_function
   import sys
   
   # The common module provides setup functionality used by the samples,
   # such as authentication and unique id generation.
   from shopping.content import common
   

3. प्रॉडक्ट का यूनीक आईडी तय करें और प्रॉडक्ट की परिभाषा के साथ एक डिक्शनरी बनाएं.

   my-insert.py के आखिर में, यह कोड जोड़ें:

   offer_id = 'book#%s' % common.get_unique_id()
   product = {
        'offerId':
            offer_id,
        'title':
            'A Tale of Two Cities',
        'description':
            'A classic novel about the French Revolution',
        'link':
            'http://my-book-shop.com/tale-of-two-cities.html',
        'imageLink':
            'http://my-book-shop.com/tale-of-two-cities.jpg',
        'contentLanguage':
            'en',
        'targetCountry':
            'US',
        'channel':
            'online',
        'availability':
            'in stock',
        'condition':
            'new',
        'googleProductCategory':
            'Media > Books',
        'gtin':
            '9780007350896',
        'price': {
            'value': '2.50',
            'currency': 'USD'
        },
        'shipping': [{
            'country': 'US',
            'service': 'Standard shipping',
            'price': {
                'value': '0.99',
                'currency': 'USD'
            }
        }],
        'shippingWeight': {
            'value': '200',
            'unit': 'grams'
        }
   }
   

4. ऐसा फ़ंक्शन बनाएं जो कमांड लाइन से स्क्रिप्ट चलाने पर काम करे. यह फ़ंक्शन, Content API के साथ इंटरैक्ट करने के लिए एक सेवा ऑब्जेक्ट बनाता है. साथ ही, कॉन्फ़िगरेशन फ़ाइल से व्यापारी/कंपनी/कारोबारी का आईडी पाता है, अनुरोध बनाता है, और एपीआई कॉल करने के लिए अनुरोध को पूरा करता है.

   my-insert.py के आखिर में, यह कोड जोड़ें:

   def main(argv):
     # Construct the service object to interact with the Content API.
     service, config, _ = common.init(argv, __doc__)
   
     # Get the merchant ID from merchant-info.json.
     merchant_id = config['merchantId']
   
     # Create the request with the merchant ID and product object.
     request = service.products().insert(merchantId=merchant_id, body=product)
   
     # Execute the request and print the result.
     result = request.execute()
     print('Product with offerId "%s" was created.' % (result['offerId']))
   
   # Allow the function to be called with arguments passed from the command line.
   if __name__ == '__main__':
     main(sys.argv)
   
   

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

   python -m shopping.content.products.my-insert
   

   कॉल पूरा होने पर, सेवा टर्मिनल पर यह मैसेज प्रिंट करती है: offerId "offerId" वाला प्रॉडक्ट बनाया गया.

6. प्रॉडक्ट सही तरीके से जोड़ा गया है या नहीं, इसकी पुष्टि करने के लिए products.list तरीके के लिए API एक्सप्लोरर का इस्तेमाल करें. इससे, आपको अपने Merchant Center खाते में मौजूद सभी प्रॉडक्ट दिखेंगे.

   products.list तरीके के लिए एपीआई एक्सप्लोरर में, ये वैल्यू डालें:

   1. अपना merchantId डालें.
   1. क्रेडेंशियल सेक्शन में, Google OAuth 2.0 और एपीआई पासकोड चुनें.
   2. लागू करें बटन पर क्लिक करें.
   3. अगर कहा जाए, तो अपने Merchant Center खाते से जुड़े Google खाते से साइन इन करें.

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

व्यापारियों या कंपनियों को शॉपिंग विज्ञापनों और मुफ़्त में दिखाई जाने वाली लिस्टिंग की नीतियों का पालन करना होगा. Google Shopping, इन नीतियों को लागू करने का अधिकार सुरक्षित रखता है. साथ ही, अगर हमें इन नीतियों का उल्लंघन करने वाला कॉन्टेंट या व्यवहार मिलता है, तो हम ज़रूरत के हिसाब से कार्रवाई करेंगे.