API (एपीआई) एक्सप्लोरर' के क्रेडेंशियल सेक्शन से आप अलग-अलग क्रेडेंशियल और दायरों के साथ परीक्षण कर सकते हैं. यह सुविधा, यह पक्का करने में काम आती है कि आप एपीआई एंडपॉइंट को शुरू करने के लिए, कम से कम ज़रूरी क्रेडेंशियल और दायरे का इस्तेमाल कर रहे हैं.
अलग-अलग क्रेडेंशियल की मदद से जांच करना
डिफ़ॉल्ट रूप से, OAuth 2 और एपीआई कुंजी के क्रेडेंशियल के टाइप पर सही का निशान लगाया जाता है. अगर आप सिर्फ़ एक क्रेडेंशियल के साथ टेस्ट करना चाहते हैं, तो इस्तेमाल करने के लिए क्रेडेंशियल के टाइप पर जाएं (और दूसरे क्रेडेंशियल टाइप से सही का निशान हटाएं). इन क्रेडेंशियल की जांच करने के लिए, आम तौर पर इन नियमों का पालन किया जाता है:
अगर आप Google Maps डेटा जैसे, सार्वजनिक डेटा को ऐक्सेस करने के लिए किसी तरीके का इस्तेमाल कर रहे हैं, तो अपने क्रेडेंशियल के तौर पर एपीआई कुंजी का इस्तेमाल कर सकते हैं. एपीआई कुंजी चुनें और Google OAuth 2.0 से सही का निशान हटाएं.
अगर आप उपयोगकर्ता के डेटा को निजी तौर पर ऐक्सेस करने के लिए कोई तरीका इस्तेमाल कर रहे हैं, जैसे कि उपयोगकर्ता का डेटा, तो Google OAuth 2 क्रेडेंशियल का इस्तेमाल करें. एपीआई कुंजी से सही का निशान हटाएं और Google OAuth 2.0 को चुनें.
अगर आपको 200 का नतीजा मिलता है, तो डेटा ऐक्सेस करने के लिए क्रेडेंशियल काफ़ी है. अगर आपको 401 का नतीजा मिलता है, तो डेटा ऐक्सेस करने के लिए आपको OAuth 2 क्रेडेंशियल का इस्तेमाल करना होगा.
अलग-अलग दायरों के साथ टेस्ट करना
दायरा एक स्ट्रिंग होती है, जैसे कि https://www.googleapis.com/auth/drive.metadata.readonly, जो आपके ऐप्लिकेशन के लिए ज़रूरी संसाधनों के ऐक्सेस का लेवल तय करती है, जैसे कि उपयोगकर्ताओं के मालिकाना हक वाले डेटा का ऐक्सेस. आम तौर पर, आप चाहते हैं कि आपके ऐप्लिकेशन को उपयोगकर्ता के डेटा के सीमित ऐक्सेस वाले दायरे का इस्तेमाल करना चाहिए. अलग-अलग तरीकों के लिए
अलग-अलग दायरों की ज़रूरत हो सकती है. उदाहरण के लिए, किसी एपीआई में ऐसा तरीका इस्तेमाल किया जा सकता है
जो सिर्फ़ पढ़ने के लिए दायरे का हो, जबकि दूसरे तरीकों में पढ़ने का दायरा
जोड़ना पड़ सकता है.
डिफ़ॉल्ट रूप से, एपीआई के लिए Google OAuth 2.0 के सभी दायरे एपीआई में चालू होते हैं. किसी खास दायरे के साथ टेस्ट करने के लिए:
- क्रेडेंशियल Google OAuth 2.0 सेक्शन में, दायरे दिखाएं पर क्लिक करें.
- मेथड को लागू करने के दौरान, इस्तेमाल किए जाने वाले दायरे की जांच करें.
- सिर्फ़ चुने गए दायरे का इस्तेमाल करके, एपीआई को लागू करने के लिए, लागू करें पर क्लिक करें. APIs एक्सप्लोरर, अनुमति देने वाली एक स्क्रीन दिखाता है जिसमें आपसे दायरे का इस्तेमाल करने का ऐक्सेस दिया जाता है.
- अनुमति दें पर क्लिक करें. नतीजे, एक्ज़ीक्यूट बटन के नीचे दिखते हैं.
अगर एपीआई एक्सप्लोरर किसी "application/json" के तहत 200 का नतीजा दिखाता है, तो इस तरीके को शुरू करने के लिए दायरा काफ़ी है. अगर एपीआई एक्सप्लोरर 403 का नतीजा दिखाता है, तो आपने इस तरीके को लागू करने के लिए, ज़रूरी विकल्प नहीं चुना है. कोई बड़ा दायरा आज़माकर देखें.
दायरे को चुनने के बारे में ज़्यादा जानकारी के लिए, अपने खास Google API के दस्तावेज़ की पुष्टि और अनुमति देने का सेक्शन देखें.
नए दायरों के साथ, जांच करने के लिए अनुमति वाले ऐक्सेस को निरस्त करना
जब आप अनुमति देने की अनुमति देने के लिए Google की अनुमति देने वाली स्क्रीन का इस्तेमाल कर लेते हैं, तब एपीआई एक्सप्लोरर तब तक पुष्टि किए गए अनुरोध करने के लिए अधिकृत रहता है, जब तक क्रेडेंशियल की अवधि खत्म नहीं हो जाती. दायरों से सही का निशान हटाने से, पहले स्वीकार किए गए क्रेडेंशियल और दायरे रीसेट नहीं होते. अगर आप किसी नए स्कोप कॉन्फ़िगरेशन के साथ परीक्षण करना चाहते हैं, तो आपको पहले स्वीकार किए गए क्रेडेंशियल निरस्त करने होंगे.
API एक्सप्लोरर के इस्तेमाल किए गए क्रेडेंशियल को निरस्त करने के लिए:
- ऐसे ऐप्लिकेशन जिनके पास आपके खाते का ऐक्सेस है पर जाएं.
- खाते के ऐक्सेस वाले तीसरे पक्ष के ऐप्लिकेशन में जाकर, Google API एक्सप्लोरर पर क्लिक करें.
- ऐक्सेस हटाएं पर क्लिक करें.
- (ज़रूरी नहीं) एपीआई एक्सप्लोरर को रीसेट करने के लिए, दस्तावेज़ वाले पेज को फिर से लोड करें.