पूर्वापेक्षाएं

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

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

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

इसके अलावा, आपके पास टेस्ट करने के लिए भी कोई अलग Google खाता हो सकता है.

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

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

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

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

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

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

अगर आप क्लाइंट लाइब्रेरी इस्तेमाल नहीं करने का फ़ैसला लेते हैं, तो आपको 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 देखें.