Python क्लाइंट लाइब्रेरी को GitHub पर होस्ट किया जाता है. साथ ही, यह पैकेज PyPI पर उपलब्ध है.
ज़रूरी शर्तें
लाइब्रेरी के लिए, Python 3.8 या इसके बाद का वर्शन ज़रूरी है.
ज़रूरी शर्तें
लाइब्रेरी इंस्टॉल करने से पहले, आपके पास डेवलपर टोकन और क्लाइंट ग्राहक आईडी होना चाहिए. इन्हें पाने का तरीका, ज़रूरी शर्तें सेक्शन में बताया गया है. ध्यान दें कि आपको बाद के चरणों में, ज़रूरी अन्य OAuth2 टोकन जनरेट करने होंगे.
रनटाइम और डिपेंडेंसी के साथ काम करने की सुविधा
Python क्लाइंट लाइब्रेरी, Python सॉफ़्टवेयर फ़ाउंडेशन के पब्लिश किए गए काम करने वाले वर्शन सेक्शन में मौजूद Python रनटाइम के साथ काम करती है. हालांकि, "सुविधा" या "प्री-रिलीज़" स्टेटस वाले वर्शन के साथ काम नहीं करती.
Python रनटाइम के नए वर्शन को अपनाते समय, हमारा मकसद Python क्लाइंट लाइब्रेरी का नया वर्शन रिलीज़ करना है. यह वर्शन, रिलीज़ होने के बाद की तिमाही के आखिर तक, नए रनटाइम के साथ काम करेगा. उदाहरण के लिए, अगर अक्टूबर में कोई नया रनटाइम रिलीज़ किया जाता है, तो अगले साल मार्च के आखिर तक Python क्लाइंट लाइब्रेरी का काम करने वाला वर्शन उपलब्ध हो जाएगा.
जिन Python रनटाइम के लिए, सेवा बंद होने की तारीख (ईओएल) तय की गई है उनके लिए, सेवा बंद होने की तारीख के बाद काम नहीं किया जा सकता. इस तारीख की जानकारी, python.org के काम न करने वाले वर्शन सेक्शन में दी गई है.
हम Python क्लाइंट लाइब्रेरी का ऐसा वर्शन रिलीज़ कर सकते हैं जो काम न करने वाले Python रनटाइम के साथ काम न करे. ऐसा, रनटाइम के ईओएल (इस्तेमाल की समयसीमा खत्म होने) के बाद कभी भी किया जा सकता है.
डिपेंडेंसी के लिए, हम उन पैकेज के साथ काम करना जारी रखेंगे जिन्हें Google मैनेज करता है. खास तौर पर, Python क्लाइंट लाइब्रेरी के ज़रूरी के तौर पर सूची में शामिल पैकेज. साथ ही, Google की ओएसएस में बदलाव से जुड़ी नीति के मुताबिक, "काम करने वाले" पैकेज के साथ भी काम करना जारी रखेंगे.
काम करने वाले Python रनटाइम और डिपेंडेंसी की पूरी सूची देखने के लिए, डिपेंडेंसी पेज देखें.
इंस्टॉल करना
PyPi से लाइब्रेरी इंस्टॉल करने के लिए, इंस्टॉलेशन के दस्तावेज़ में दिए गए निर्देशों का पालन करें और इस पेज पर वापस आएं.
कॉन्फ़िगरेशन
लाइब्रेरी इंस्टॉल करने के बाद, आपको इसके लिए कॉन्फ़िगरेशन सेट अप करना होगा. लाइब्रेरी को कॉन्फ़िगर करने के कई तरीके हैं. इनके बारे में, हमारे कॉन्फ़िगरेशन दस्तावेज़ में बताया गया है.
पुष्टि करना
कॉन्फ़िगरेशन टाइप चुनने के बाद, एपीआई से अनुरोध करने के लिए ज़रूरी बाकी OAuth2 टोकन जनरेट किए जा सकते हैं. OAuth2 के कई फ़्लो काम करते हैं. इनके बारे में नीचे दी गई सूची में बताया गया है. फ़्लो के बीच के अंतर के बारे में जानकारी पाने और यह तय करने में मदद पाने के लिए कि आपके ऐप्लिकेशन के लिए कौनसा फ़्लो सबसे सही है, OAuth से जुड़ा हमारा दस्तावेज़ देखें.
एपीआई अनुरोध करना
अपने कॉन्फ़िगरेशन में OAuth2 टोकन शामिल करने के बाद, एपीआई का अनुरोध किया जा सकता है. कैंपेन पाएं उदाहरण देखें. इससे, यह जांचने का आसान तरीका पता चलता है कि लाइब्रेरी को एपीआई अनुरोध करने के लिए सही तरीके से कॉन्फ़िगर किया गया है या नहीं.
get_campaigns.py सैंपल चलाने के लिए, स्थानीय तौर पर इंस्टॉल की गई googleads-python क्लाइंट लाइब्रेरी की रूट डायरेक्ट्री में, यह कमांड चलाएं:
$ python examples/basic_operations/get_campaigns.py -c \
INSERT_YOUR_CUSTOMER_ID_HERE
अन्य संसाधन
एपीआई अनुरोध करने के बाद, क्लाइंट लाइब्रेरी का इस्तेमाल इन कामों के लिए करें: