Python क्लाइंट लाइब्रेरी को GitHub पर होस्ट किया जाता है. साथ ही, पैकेज PyPI पर उपलब्ध है.
ज़रूरी शर्तें
इस लाइब्रेरी के लिए, Python 3.9 या इसके बाद का वर्शन ज़रूरी है.
ज़रूरी शर्तें
इस गाइड को पढ़ने से पहले, आपके पास Google Ads API के लिए डेवलपर टोकन और अपने Google Ads खाते के लिए 10 अंकों का क्लाइंट ग्राहक आईडी होना चाहिए.
रनटाइम और डिपेंडेंसी के साथ काम करने की सुविधा
Python क्लाइंट लाइब्रेरी, Python Software Foundation की ओर से पब्लिश किए गए सपोर्ट किए गए वर्शन सेक्शन में दिए गए Python रनटाइम के साथ काम करती है. हालांकि, "सुविधा" या "प्रीरिलीज़" स्टेटस वाले वर्शन के साथ काम नहीं करती.
हमारा लक्ष्य, Python रनटाइम के नए वर्शन को रिलीज़ होने के तुरंत बाद इस्तेमाल करना है. साथ ही, हम यह भी पक्का करते हैं कि Python Software Foundation, आधिकारिक तौर पर इन वर्शन के साथ काम करता हो.
जिन Python रनटाइम का इस्तेमाल अब नहीं किया जा सकता वे python.org के इस्तेमाल नहीं किए जा सकने वाले वर्शन सेक्शन में, इस्तेमाल बंद होने की तारीख के बाद काम नहीं करते. हम ईओएल रनटाइम के साथ काम करने की गारंटी नहीं दे सकते. ऐसा इसलिए, क्योंकि हम लाइब्रेरी का ऐसा वर्शन रिलीज़ कर सकते हैं जो ईओएल की तारीख के बाद किसी भी समय उनके साथ काम न करे.
डिपेंडेंसी के लिए, (खास तौर पर, Google के रखरखाव वाले ऐसे पैकेज जो Python क्लाइंट लाइब्रेरी के लिए ज़रूरी के तौर पर लिस्ट किए गए हैं), हम Google के रखरखाव वाले पैकेज के साथ काम करने की सुविधा बनाए रखेंगे. साथ ही, Google की ओएसएस ब्रेकिंग चेंज पॉलिसी के मुताबिक, "सपोर्ट किए गए" पैकेज के साथ काम करने की सुविधा बनाए रखेंगे.
इस्तेमाल किए जा सकने वाले Python रनटाइम और डिपेंडेंसी की पूरी सूची देखने के लिए, डिपेंडेंसी पेज देखें.
इंस्टॉल करना
हमारी इंस्टॉलेशन गाइड में, लाइब्रेरी को इंस्टॉल करने के सभी अलग-अलग तरीके बताए गए हैं. अपने ऐप्लिकेशन में लाइब्रेरी इंस्टॉल करने का सबसे आसान (और सुझाया गया) तरीका pip का इस्तेमाल करना है:
$ python -m pip install google-ads
कॉन्फ़िगरेशन
लाइब्रेरी इंस्टॉल करने के बाद, आपको इसके लिए कॉन्फ़िगरेशन सेट अप करना होगा. लाइब्रेरी को कॉन्फ़िगर करने के कई तरीके हैं. इनके बारे में हमारी कॉन्फ़िगरेशन गाइड में बताया गया है.
पुष्टि करना
कॉन्फ़िगरेशन का तरीका चुनने के बाद, पुष्टि करने के लिए कॉन्फ़िगरेशन सेट अप किया जा सकता है. सिलसिलेवार निर्देशों के लिए, Python क्लाइंट लाइब्रेरी की पुष्टि करने से जुड़ी गाइड देखें. साथ ही, ज़्यादा सामान्य जानकारी के लिए, OAuth की खास जानकारी देखें.
एपीआई अनुरोध करना
पुष्टि करने से जुड़ा कॉन्फ़िगरेशन सेट अप करने के बाद, एपीआई अनुरोध किया जा सकता है. लाइब्रेरी को एपीआई अनुरोध करने के लिए सही तरीके से कॉन्फ़िगर किया गया है या नहीं, यह जांचने के लिए get campaigns उदाहरण देखें.
get_campaigns.py सैंपल चलाने के लिए, स्थानीय तौर पर इंस्टॉल की गई googleads-python क्लाइंट लाइब्रेरी की रूट डायरेक्ट्री में, यह कमांड चलाएं:
$ python examples/basic_operations/get_campaigns.py -c INSERT_YOUR_CUSTOMER_ID_HERE
अन्य संसाधन
एपीआई अनुरोध करने के बाद, क्लाइंट लाइब्रेरी का इस्तेमाल इन कामों के लिए करें: