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
अन्य संसाधन
एपीआई अनुरोध करने के बाद, क्लाइंट लाइब्रेरी का इस्तेमाल इन कामों के लिए करें: