ज़रूरी शर्तें

अपने पहले क्लाइंट ऐप्लिकेशन के लिए कोडिंग की प्रक्रिया शुरू करने से पहले, कुछ ऐसी चीज़ें हैं जिन्हें आपने अभी तक नहीं किया है.

कोई Google खाता प्राप्त करें

Google API कंसोल में प्रोजेक्ट बनाने के लिए, आपके पास Google खाता होना चाहिए. अगर आपके पास पहले से कोई खाता है, तो आप पूरी तरह से तैयार हैं.

यह भी हो सकता है कि आपको जांच के लिए एक अलग Google खाते की ज़रूरत पड़े.

अपने क्लाइंट के लिए प्रोजेक्ट बनाना

'Google नॉलेज ग्राफ़ सर्च एपीआई' को अनुरोध भेजने से पहले, आपको Google को अपने क्लाइंट के बारे में बताना होगा. साथ ही, इस एपीआई का ऐक्सेस चालू करना होगा. ऐसा करने के लिए, आपको Google API Console का इस्तेमाल करके प्रोजेक्ट बनाना होगा. प्रोजेक्ट, सेटिंग और एपीआई के ऐक्सेस की जानकारी का नाम वाला कलेक्शन होता है. इसके बाद, अपना ऐप्लिकेशन रजिस्टर किया जाता है.

Google नॉलेज ग्राफ़ Search API का इस्तेमाल शुरू करने के लिए, आपको सबसे पहले सेटअप टूल इस्तेमाल करना होगा. यह आपको Google API Console में प्रोजेक्ट बनाने, एपीआई की सुविधा चालू करने, और क्रेडेंशियल बनाने के बारे में जानकारी देता है.

अगर आपने पहले से ऐसा नहीं किया है, तो क्रेडेंशियल बनाएं > API कुंजी क्लिक करके अपने ऐप्लिकेशन की API कुंजी बनाएं. इसके बाद, एपीआई पासकोड सेक्शन में, अपना एपीआई पासकोड खोजें.

REST के बारे में बुनियादी बातें जानें

एपीआई को शुरू करने के दो तरीके हैं:

अगर आपने क्लाइंट लाइब्रेरी का इस्तेमाल न करने का फ़ैसला किया है, तो आपको आरईएसटी की बुनियादी बातें जाननी होंगी.

REST, सॉफ़्टवेयर आर्किटेक्चर की एक स्टाइल है. यह डेटा का अनुरोध करने और उसमें बदलाव करने के लिए, आसान और एक जैसा तरीका उपलब्ध कराती है.

REST शब्द "रिप्रज़ेंटेशनल स्टेट ट्रांसफ़र" का छोटा रूप है. Google API के संदर्भ में, यह Google के सेव किए गए डेटा को दिखाने और उसमें बदलाव करने के लिए एचटीटीपी क्रियाओं का इस्तेमाल करता है.

RESTful सिस्टम में, संसाधनों को डेटा स्टोर में सेव किया जाता है. वहीं, क्लाइंट एक अनुरोध भेजता है कि सर्वर किसी खास काम (जैसे, संसाधन बनाना, वापस पाना, अपडेट करना या मिटाना) करता है. इसके बाद, सर्वर कार्रवाई करता है और जवाब देता है. आम तौर पर, यह अनुरोध, बताए गए संसाधन के तौर पर किया जाता है.

Google के RESTful एपीआई में, क्लाइंट एचटीटीपी कार्रवाई के बारे में बताता है, जैसे कि POST, GET, PUT या DELETE. यह ऐसे संसाधन के बारे में बताता है जो नीचे दिए गए फ़ॉर्म के दुनिया भर में मौजूद यूनीक यूआरआई की मदद से बनाया जाता है:

https://www.googleapis.com/apiName/apiVersion/resourcePath?parameters

सभी एपीआई संसाधनों में, एचटीटीपी से ऐक्सेस किए जा सकने वाले यूनीक यूआरआई होते हैं. इसलिए, REST डेटा कैश करने की सुविधा को चालू करती है. साथ ही, उसे वेब के डिस्ट्रिब्यूटेड इन्फ़्रास्ट्रक्चर के साथ काम करने के लिए ऑप्टिमाइज़ किया जाता है.

आपको एचटीटीपी 1.1 स्टैंडर्ड वाले दस्तावेज़ में तरीका की परिभाषाएं लग सकती हैं. इनमें GET, POST, PUT, और DELETE के लिए खास जानकारी शामिल होती है.

Google नॉलेज ग्राफ़ सर्च एपीआई में REST

Google नॉलेज ग्राफ़ खोज एपीआई की कार्रवाइयां, सीधे REST एचटीटीपी क्रियाओं पर मैप होती हैं.

Google नॉलेज ग्राफ़ के सर्च एपीआई के यूआरआई के लिए खास फ़ॉर्मैट ये हैं:

https://kgsearch.googleapis.com/v1/entities:search?query=your_query&parameters

एपीआई में काम करने वाली हर कार्रवाई के लिए इस्तेमाल किए गए यूआरआई के पूरे सेट की खास जानकारी Google नॉलेज ग्राफ़ सर्च एपीआई रेफ़रंस दस्तावेज़ में दी गई है.

JSON के बारे में बुनियादी बातें जानें

Google नॉलेज ग्राफ़ खोज एपीआई, JSON फ़ॉर्मैट में डेटा दिखाता है.

JSON (JavaScript ऑब्जेक्ट नोटेशन), आम तौर पर भाषा पर आधारित डेटा फ़ॉर्मैट है. यह आर्बिट्रेरी डेटा स्ट्रक्चर को टेक्स्ट में आसान तरीके से दिखाता है. ज़्यादा जानकारी के लिए, json.org पर जाएं.