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 Software Foundation की ओर से रिलीज़ और आधिकारिक तौर पर सहायता दिए जाने वाले Python रनटाइम के नए वर्शन को जल्द से जल्द अपनाने की कोशिश करती है.
python.org EOL वाले रनटाइम के साथ कंपैटबिलिटी की गारंटी नहीं दी जा सकती. ऐसा इसलिए, क्योंकि EOL की तारीख के बाद लाइब्रेरी के रिलीज़ होने पर, कंपैटबिलिटी टूट सकती है.
डिपेंडेंसी (खास तौर पर, Google के बनाए गए वे पैकेज जो Python क्लाइंट लाइब्रेरी के लिए ज़रूरी हैं) के लिए, Google के बनाए गए और Google की OSS ब्रेकिंग चेंज पॉलिसी के मुताबिक "सहायता वाले" पैकेज के साथ कंपैटबिलिटी बनाए रखी जाती है.
सहायता वाले 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
अन्य संसाधन
एपीआई अनुरोध करने के बाद, क्लाइंट लाइब्रेरी के इन इस्तेमाल के बारे में जानें: