Goo.gl क्लाइंट क्लास और API कॉन्फ़िगरेशन

UPD: रिपॉजिटरी अब गितुब पर है।

नमस्कार साथियों!

मुझे याद है कि एक समय मैं इस खबर से बहुत खुश था कि Google URL शॉर्टनर के पास आधिकारिक APIs थे। उस समय, मैं सिर्फ एक एप्लिकेशन विकसित कर रहा था जिसे अक्सर फ़ीड लिंक को छोटा करने की आवश्यकता थी। मैंने अभी-अभी बिट स्क्रू किया, लेकिन Google से एक नई सेवा का प्रयास करने के लिए लुभाया गया। प्रलेखन का उपयोग करते हुए, कुछ घंटों में मैंने बुनियादी कार्यक्षमता को छोड़ दिया और परियोजना में स्क्रिप्ट का निर्माण किया।

समय के साथ, स्क्रिप्ट में बदलाव किए गए, और आखिरकार, मैंने कोड में टिप्पणी जोड़ने, सरल प्रलेखन लिखने और Google कोड में सब कुछ डालने का फैसला किया।

मुख्य विशेषताएं और प्रतियोगियों से वर्ग की विशेषताएं:

• छोटे आकार (150 लाइनें), सभी एक मॉड्यूल में, एक भारी आधिकारिक अजगर ग्राहक को जोड़ने की आवश्यकता नहीं है;
• पूर्ण एपीआई कवरेज, एक समान परियोजना के विपरीत;
• कोड में टिप्पणियाँ और प्रलेखन;
• इसे प्राप्त करने के लिए ClientLogin + फ़ंक्शन के माध्यम से प्राधिकरण समर्थन;
• यदि आपका एपीआई रेफ़र या आईपी पर प्रतिबंध है तो अतिरिक्त आरंभीकरण पैरामीटर;

तीन महीने से अधिक समय तक मैं लगभग 12,000 अद्वितीय लिंक को कम करने में कामयाब रहा और कुल मिलाकर मैं इस सेवा से बहुत प्रसन्न हूं। नीचे मैं कोड उदाहरण देना चाहता हूं और अधिकतम प्रदर्शन के लिए एपीआई को ट्यून करने के बारे में बात करना चाहता हूं।

वर्ग का उपयोग करने के लिए, आपको सबसे पहले एपीआई कुंजी प्राप्त करनी होगी। सामान्य तौर पर, आप एक कुंजी के बिना संक्षिप्त नाम का उपयोग कर सकते हैं, लेकिन तब आपकी सीमाएं बहुत छोटी हैं। हम एपीआई कंसोल पेज पर जाते हैं, "प्रोजेक्ट जोड़ें" पर क्लिक करें और उपलब्ध सेवाओं की सूची में URL शॉर्टनर एपीआई (सूची में अंतिम) शामिल हैं।



टैब पर "प्रोजेक्ट होम" उप-आइटम "एपीआई एक्सेस" में आपकी कुंजी लिखी जाएगी:



अभी के लिए, आइए प्रमाणीकरण और क्वेरी प्रतिबंधों का वर्णन छोड़ें, चलिए कक्षा को देखते हैं:

import googl client = googl.Googl("MyAPIAccessKey") result = client.shorten("http://code.google.com/p/python-googl-client/") print result >>> {u'kind': u'urlshortener#url', u'id': u'http://goo.gl/67TaW', u'longUrl': u'http://code.google.com/p/python-googl-client/'} print client.expand(result["id"]) >>> {u'status': u'OK', u'kind': u'urlshortener#url', u'id': u'http://goo.gl/67TaW', u'longUrl': u'http://code.google.com/p/python-googl-client/'} 

हमने सबसे सरल क्रियाएं कीं: एक लंबी कड़ी से हमें एक छोटा मिला और इसके विपरीत: हमने मूल के बारे में एक छोटी जानकारी निकाली।

क्लिक और समयावधि पर अतिरिक्त आंकड़े प्राप्त करने के लिए, हम विस्तार () विधि के लिए एक अतिरिक्त पैरामीटर प्रोजेक्शन पास करते हैं, इसका मान PROJ_ उपसर्ग के साथ स्थिरांक में से एक हो सकता है:

 info = client.expand('http://goo.gl/67TaW', projection=googl.PROJ_FULL) 

यह हमारे लिए कुछ इस तरह लौटेगा:

 { u'status': u'OK', u'kind': u'urlshortener#url', u'created': u'2011-05-19T05:47:13.058+00:00', u'analytics': { u'week': { u'shortUrlClicks': u'0', u'longUrlClicks': u'1' }, u'allTime': { u'shortUrlClicks': u'0', u'longUrlClicks': u'1' }, u'twoHours': { u'shortUrlClicks': u'0', u'longUrlClicks': u'1' }, u'day': { u'shortUrlClicks': u'0', u'longUrlClicks': u'1' }, u'month': { u'shortUrlClicks': u'0', u'longUrlClicks': u'1' } }, u'longUrl': u'http://code.google.com/p/python-googl-client/', u'id': u'http://goo.gl/67TaW' } 

प्रलेखन में प्रत्येक क्षेत्र के अर्थ मूल्यों का वर्णन किया गया है ।

अब प्राधिकरण पर विचार करें। Google को यह सुनिश्चित करने के लिए प्राधिकरण की आवश्यकता है कि यह अनुरोध पुपकिन द्वारा पूरा किया गया था, सुमकिन ने नहीं। सबसे पहले, यह आंकड़ों तक पहुंच देता है, और दूसरी बात, यह काफी हद तक सीमा को बढ़ाता है। प्राधिकरण दो तरीकों से किया जा सकता है: OAuth और ClientLogin । अब तक, मैंने दूसरी विधि लागू की है, जैसा कि यह सरल है (मैं OAuth को बाद में उपवास करूंगा)। एक टोकन का अनुरोध करने के लिए, आपको gdata-python-client लाइब्रेरी को स्थापित करने और get_client_login () फ़ंक्शन को कॉल करने की आवश्यकता है, इसे अपने खाते से उपयोगकर्ता नाम और पासवर्ड पास करें। प्राप्त किए गए टोकन को वर्ग आरंभीकरण में सेट करें, जिसके बाद प्रत्येक अनुरोध अधिकृत हो जाएगा:

 import googl client_login = googl.get_client_login("login", "pass") client = googl.Googl("MyAPIAccessKey", client_login=client_login) 

महत्वपूर्ण: टोकन का जीवनकाल लगभग एक सप्ताह है, जिसके बाद इसे अपडेट करने की आवश्यकता है। मेरी परियोजना में, मैं दिन में एक बार मुकुट को टोकन अपडेट फ़ंक्शन सेट करता हूं।

यदि आप बैचों में लिंक को छोटा करते हैं, तो जल्दी या बाद में "दर सीमा" अपवाद को पकड़ लें। ऐसा इसलिए है क्योंकि डिफ़ॉल्ट रूप से आपके कंसोल में 1.0 अनुरोध / सेकंड / उपयोगकर्ता की सीमा होती है:



1000 मानों को इस मान को एक स्वीकार्य, बढ़ाएँ।

अंत में, क्वेरी फ़िल्टरिंग पर विचार करें। सभी एपीआई अनुरोधों को दो तरीकों से फ़िल्टर किया जा सकता है: आईपी और डोमेन द्वारा। "ट्रैफिक कंट्रोल" टैब पर, आप किसी एक प्रकार को निर्दिष्ट कर सकते हैं:



यदि आपने "ब्राउज़र-एम्बेडेड स्क्रिप्ट्स" का चयन किया है, तो टेक्स्ट फ़ील्ड में वह एड्रेस मास्क निर्दिष्ट करें जिससे अनुरोध "" .example.com / * के लिए आएगा। कक्षा को प्रारंभ करते समय, आपको उस संदर्भ पैरामीटर को निर्दिष्ट करना होगा जो इस मास्क को संतुष्ट करता है:

 import googl client = googl.Googl("MyAPIAccessKey", referer="http://www.example.com") 

आईपी ​​प्रतिबंध निम्नानुसार काम करता है। आप IP पते का मुखौटा निर्दिष्ट करते हैं। उपयोगकर्ता अनुरोध पैरामीटर के लिए प्रत्येक अनुरोध (पता बार से) खोजता है। यदि यह नहीं पाया जाता है, तो इसे उस मशीन का वास्तविक आईपी पता सौंपा जाता है जिससे कॉल किया गया था। इस प्रकार प्राप्त उपयोगकर्ता की तुलना निर्दिष्ट मास्क से की जाती है। वर्ग प्रारंभ होने पर उपयोगकर्ता पैरामीटर निर्धारित किया जा सकता है:

 import googl client = googl.Googl("MyAPIAccessKey", userip="127.0.0.1") 

संदर्भ:

• गिथब प्रोजेक्ट पेज;
• आधिकारिक दस्तावेज
• Urlshorter समर्थन के साथ आधिकारिक google-api- python- क्लाइंट , उदाहरण ।