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