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