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

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

जब भी आपका ऐप्लिकेशन हर अनुरोध के साथ एक एपीआई पासकोड शामिल करके, Google नॉलेज ग्राफ़ Search API को अनुरोध भेजता है, तो उसे हर बार अपनी पहचान की पुष्टि करनी होती है.

एपीआई पासकोड हासिल करना और उसका इस्तेमाल करना

एपीआई पासकोड हासिल करने के लिए:

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

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

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

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

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

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

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

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