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