अनुरोधों को अनुमति देना

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

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

एपीआई कुंजी को पाना और उसका इस्तेमाल करना

एपीआई कुंजी पाने के लिए:

1. एपीआई कंसोल में क्रेडेंशियल पेज खोलें.
2. यह एपीआई दो तरह के क्रेडेंशियल के साथ काम करता है. अपने प्रोजेक्ट के लिए सही क्रेडेंशियल बनाएं:

   • OAuth 2.0: जब भी आपके ऐप्लिकेशन में उपयोगकर्ता के निजी डेटा के लिए अनुरोध किया जाता है, तब अनुरोध के साथ OAuth 2.0 टोकन भेजना ज़रूरी है. आपका ऐप्लिकेशन पहले एक क्लाइंट आईडी भेजता है और टोकन पाने के लिए एक क्लाइंट सीक्रेट शेयर करता है. वेब ऐप्लिकेशन, सेवा खातों या इंस्टॉल किए गए ऐप्लिकेशन के लिए, OAuth 2.0 क्रेडेंशियल जनरेट किए जा सकते हैं.

     ध्यान दें: इस एपीआई में OAuth 2.0 की अनुमति देने का कोई तरीका नहीं है. इसलिए, आपको सिर्फ़ एपीआई कुंजियां लेनी होंगी. इनके बारे में यहां बताया गया है. हालांकि, अगर आपका ऐप्लिकेशन ऐसे अन्य एपीआई को कॉल करता है जिनके लिए उपयोगकर्ता की अनुमति ज़रूरी है, तब भी आपको OAuth 2.0 क्रेडेंशियल की ज़रूरत होगी.

     ज़्यादा जानकारी के लिए, OAuth 2.0 दस्तावेज़ देखें.

   • एपीआई कुंजियां: OAuth 2.0 टोकन न देने वाले अनुरोध के लिए, एपीआई कुंजी भेजना ज़रूरी है. इस कुंजी से आपके प्रोजेक्ट की पहचान होती है. साथ ही, एपीआई का ऐक्सेस, कोटा, और रिपोर्ट मिलती हैं.

     एपीआई कुंजियों पर, कई तरह की पाबंदियां काम करती हैं. अगर आपके लिए ज़रूरी एपीआई कुंजी पहले से मौजूद नहीं है, तो Console में एपीआई कुंजी बनाएं. इसके लिए, क्रेडेंशियल बनाएं > API कुंजी पर क्लिक करें. कुंजी को प्रोडक्शन में इस्तेमाल करने से पहले, उसे सीमित करने के लिए, कुंजी पर पाबंदी लगाएं और पाबंदियों में से किसी एक को चुनें.

अपनी एपीआई कुंजियों को सुरक्षित रखने के लिए, एपीआई कुंजियों का सुरक्षित तरीके से इस्तेमाल करने के सबसे सही तरीके अपनाएं.

एपीआई कुंजी मिलने के बाद, आपका ऐप्लिकेशन, अनुरोध के सभी यूआरएल में क्वेरी पैरामीटर key=yourAPIKey जोड़ सकता है.

एपीआई कुंजी को यूआरएल में एम्बेड करने के लिए सुरक्षित है; इसके लिए किसी एन्कोडिंग की ज़रूरत नहीं होती.