Python की क्लाइंट लाइब्रेरी GitHub पर होस्ट की जाती है. साथ ही, पैकेज PyPI पर उपलब्ध है.
ज़रूरी शर्तें
इस लाइब्रेरी के लिए, Python 3.9 या इसके बाद का वर्शन ज़रूरी है.
ज़रूरी शर्तें
इस गाइड को पढ़ने से पहले, आपके पास Google Ads API के लिए डेवलपर टोकन और अपने Google Ads खाते के लिए 10 अंकों का क्लाइंट ग्राहक आईडी होना चाहिए.
रनटाइम और डिपेंडेंसी के साथ काम करने की सुविधा
Python क्लाइंट लाइब्रेरी, Python Software Foundation की ओर से पब्लिश किए गए सपोर्ट किए गए वर्शन सेक्शन में दिए गए Python रनटाइम के साथ काम करती है. हालांकि, "सुविधा" या "प्रीरिलीज़" स्टेटस वाले वर्शन के साथ काम नहीं करती.
हमारा लक्ष्य, Python रनटाइम के नए वर्शन रिलीज़ होने के तुरंत बाद उन्हें इस्तेमाल करना है. हालांकि, इसके लिए ज़रूरी है कि Python Software Foundation आधिकारिक तौर पर इन वर्शन को सपोर्ट करता हो.
जिन Python रनटाइम का इस्तेमाल अब नहीं किया जा सकता वे EOL की तारीख के बाद काम नहीं करते. EOL की तारीख, 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
अन्य संसाधन
एपीआई अनुरोध करने के बाद, क्लाइंट लाइब्रेरी का इस्तेमाल इन कामों के लिए करें: