इस पेज का अनुवाद Cloud Translation API से किया गया है.

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

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

ध्यान दें: इस उदाहरण में, python/shopping/content/Common.py मॉड्यूल का इस्तेमाल करके सर्विस ऑब्जेक्ट बनाया जाता है. यह ऑब्जेक्ट पुष्टि करने और Content API को कॉल करने के लिए इंटरफ़ेस उपलब्ध कराता है. सामान्य.py मॉड्यूल में सामान्य कार्रवाइयों के लिए दूसरे उपयोगी तरीके भी शामिल हैं, जैसे कि यूनीक आईडी जनरेट करना, यह देखना कि खाता एक से ज़्यादा क्लाइंट वाला खाता (एमसीए) है या नहीं, और फिर से अनुरोध करना.

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

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

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
```

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

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'
     }
}

कोई ऐसा फ़ंक्शन बनाएं जो स्क्रिप्ट के कमांड लाइन से चलने पर चले. फ़ंक्शन, 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)
```
स्क्रिप्ट चलाने और टर्मिनल विंडो से एपीआई कॉल चलाने के लिए, googleads-shopping-sample/python/ पर जाएं और यह चलाएं:
```
python -m shopping.content.products.my-insert
```
कॉल पूरा होने पर, सेवा टर्मिनल को यह मैसेज प्रिंट करती है: ऑफ़र आईडी "offerId" वाला प्रॉडक्ट बनाया गया.
प्रॉडक्ट की पुष्टि हो गई है या नहीं, यह पक्का करने के लिए, products.list तरीके का इस्तेमाल करके, अपने Merchant Center खाते में मौजूद सभी प्रॉडक्ट दिखाने के लिए, एपीआई एक्सप्लोरर का इस्तेमाल करें.

ध्यान दें: products.insert कॉल पूरा होने के बाद, products.list या Merchant Center में प्रॉडक्ट उपलब्ध होने में कुछ मिनट लग सकते हैं.

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

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

पीछे जाएं

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

आगे बढ़ें

Content API के बारे में ज़्यादा जानें