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