इस दस्तावेज़ में Google Drive API से जुड़ा खास अधिकार है और पुष्टि करने की जानकारी. इस दस्तावेज़ को पढ़ने से पहले, पक्का करें कि पुष्टि करने और अनुमति देने की सामान्य जानकारी पुष्टि करने और अनुमति देने के बारे में जानें.
अनुमति देने के लिए, OAuth 2.0 को कॉन्फ़िगर करें
उस स्क्रीन को कॉन्फ़िगर करना जहां OAuth के लिए सहमति दी जाती है और स्कोप चुनें ताकि यह तय किया जा सके कि उपयोगकर्ताओं और ऐप्लिकेशन की समीक्षा करने वाले लोगों को कौनसी जानकारी दिखाई जाए. ताकि आप इसे बाद में प्रकाशित कर सकें.
Drive API के दायरे
आपके ऐप्लिकेशन को दिए गए ऐक्सेस का लेवल तय करने के लिए, आपको अनुमति के दायरे के बारे में बताएं. अनुमति का स्कोप, OAuth 2.0 यूआरआई स्ट्रिंग है जिसमें Google Workspace ऐप्लिकेशन का नाम, यह किस तरह का डेटा ऐक्सेस करता है, और ऐक्सेस का लेवल तय कर सकते हैं. ये दायरे, आपके ऐप्लिकेशन के Google Workspace डेटा के साथ काम करने के अनुरोधों का दायरा तय करते हैं. इनमें ये दायरे शामिल हैं उपयोगकर्ताओं का Google खाते में मौजूद डेटा.
आपका ऐप्लिकेशन इंस्टॉल होने पर, उपयोगकर्ता से उन दायरों की पुष्टि करने के लिए कहा जाता है ऐप से. आम तौर पर, आपको सबसे सटीक और सटीक स्कोप चुनना चाहिए और ऐसे दायरों का अनुरोध करने से बचें जिनकी ज़रूरत आपके ऐप्लिकेशन में नहीं है. ज़्यादा उपयोगकर्ता सीमित और साफ़ तौर पर बताए गए दायरों का ऐक्सेस आसानी से देना.
हमारा सुझाव है कि जहां भी हो सके, गैर-संवेदनशील स्कोप का इस्तेमाल करें, क्योंकि यह हर फ़ाइल के लिए अनुमति देता है और किसी ऐप्लिकेशन के लिए ज़रूरी खास सुविधाओं के ऐक्सेस को सीमित करता है.
Drive API इन दायरों के साथ काम करता है:
| दायरा कोड | ब्यौरा | इस्तेमाल |
|---|---|---|
https://www.googleapis.com/auth/drive.appdata |
अपनी Google Drive में ऐप्लिकेशन के कॉन्फ़िगरेशन का डेटा देखें और उसे मैनेज करें. | सुझाया गया नॉन-सेंसिटिव |
https://www.googleapis.com/auth/drive.install |
ऐप्लिकेशन को "इसमें खोलें" विकल्प के तौर पर दिखने की अनुमति दें या "नया" मेन्यू. | सुझाया गया नॉन-सेंसिटिव |
https://www.googleapis.com/auth/drive.file |
नई Drive फ़ाइलें बनाएं या उन मौजूदा फ़ाइलों में बदलाव करें जिन्हें आपने किसी ऐप्लिकेशन के साथ खोला है या जिन्हें उपयोगकर्ता, Google पिकर एपीआई या ऐप्लिकेशन के फ़ाइल पिकर का इस्तेमाल करके किसी ऐप्लिकेशन के साथ शेयर करता है. | सुझाया गया नॉन-सेंसिटिव |
https://www.googleapis.com/auth/drive.apps.readonly |
आपकी डिस्क को ऐक्सेस करने के लिए अधिकृत ऐप्लिकेशन देखें. | संवेदनशील |
https://www.googleapis.com/auth/drive |
Drive में मौजूद अपनी सभी फ़ाइलों को देखें और मैनेज करें. | सभी देशों/इलाकों में उपलब्ध नहीं है |
https://www.googleapis.com/auth/drive.readonly |
Drive में मौजूद अपनी सभी फ़ाइलें देखें और डाउनलोड करें. | सभी देशों/इलाकों में उपलब्ध नहीं है |
https://www.googleapis.com/auth/drive.activity |
Drive में मौजूद फ़ाइलों का गतिविधि रिकॉर्ड देखें और जोड़ें. | सभी देशों/इलाकों में उपलब्ध नहीं है |
https://www.googleapis.com/auth/drive.activity.readonly |
अपनी Drive में फ़ाइलों का गतिविधि रिकॉर्ड देखें. | सभी देशों/इलाकों में उपलब्ध नहीं है |
https://www.googleapis.com/auth/drive.meet.readonly |
Drive में मौजूद उन फ़ाइलों को देखना जिन्हें Google Meet के ज़रिए बनाया गया है या जिनमें उससे बदलाव किया गया है. | सभी देशों/इलाकों में उपलब्ध नहीं है |
https://www.googleapis.com/auth/drive.metadata |
अपनी डिस्क में फ़ाइलों का मेटाडेटा देखें और प्रबंधित करें. | सभी देशों/इलाकों में उपलब्ध नहीं है |
https://www.googleapis.com/auth/drive.metadata.readonly |
अपनी Drive में मौजूद फ़ाइलों का मेटाडेटा देखें. | सभी देशों/इलाकों में उपलब्ध नहीं है |
https://www.googleapis.com/auth/drive.scripts |
अपनी Google Apps Script स्क्रिप्ट में बदलाव करें व्यवहार. | सभी देशों/इलाकों में उपलब्ध नहीं है |
ऊपर दी गई टेबल में मौजूद, इस्तेमाल कॉलम में हर दायरे की संवेदनशीलता के बारे में बताया गया है, नीचे दी गई परिभाषाओं के मुताबिक:
सुझाया गया / गैर-संवेदनशील: ये दायरे अनुमति देने का ऐक्सेस मिलता है. साथ ही, ऐप्लिकेशन की सिर्फ़ बुनियादी पुष्टि करने की ज़रूरत होती है. इसके लिए इस ज़रूरी शर्त के बारे में जानकारी, पुष्टि की जानकारी देखें ज़रूरी शर्तें.
सुझाए गए / संवेदनशील: ये दायरे खास Google को ऐक्सेस देते हैं उपयोगकर्ता का वह डेटा जिसे उपयोगकर्ता ने आपके ऐप्लिकेशन के लिए अनुमति दी है. इसके लिए आपको यह काम करना होगा पुष्टि करने का एक और तरीका है. इस ज़रूरी शर्त के बारे में जानकारी पाने के लिए, संवेदनशील और प्रतिबंधित दायरा देखें ज़रूरी शर्तें.
प्रतिबंधित: इन दायरों की मदद से, Google उपयोगकर्ता के डेटा को बड़े पैमाने पर ऐक्सेस किया जा सकता है और आपको प्रतिबंधित दायरे की पुष्टि करने की ज़रूरत होगी. इसके लिए इस ज़रूरी शर्त के बारे में जानकारी पाने के लिए, Google API सेवाओं के उपयोगकर्ता का डेटा देखें नीति और अन्य ज़रूरी शर्तें एपीआई के लिए स्कोप. अगर सर्वर पर, प्रतिबंधित स्कोप का डेटा सेव किया जाता है (या ट्रांसमिट किया जाता है), तो आपको सुरक्षा जांच की ज़रूरत है.
अगर आपके ऐप्लिकेशन को किसी अन्य Google API का ऐक्सेस चाहिए, तो उन दायरों को जोड़ा जा सकता है भी. Google API के दायरों के बारे में ज़्यादा जानकारी पाने के लिए, OAuth 2.0 का इस्तेमाल करके Google API ऐक्सेस करना.
खास OAuth 2.0 स्कोप के बारे में ज़्यादा जानकारी पाने के लिए, OAuth 2.0 के स्कोप देखें Google API.
OAuth से पुष्टि
कुछ OAuth दायरों का इस्तेमाल करने के लिए, आपके ऐप्लिकेशन को OAuth की मदद से प्रोसेस करना पड़ सकता है ऐप्लिकेशन की पुष्टि से जुड़ा सहायता केंद्र. OAuth ऐप्लिकेशन के बारे में अक्सर पूछे जाने वाले सवाल पढ़ें. यह तय करें कि आपके ऐप्लिकेशन की पुष्टि कब की जानी चाहिए और किस तरह की की पुष्टि करना ज़रूरी है. Google Drive की शर्तें सेवा.
पाबंदी वाले स्कोप का इस्तेमाल कब करना चाहिए
Drive के लिए, सिर्फ़ यहां दिए गए ऐप्लिकेशन टाइप को ऐक्सेस कर सकते हैं प्रतिबंधित दायरे:
- प्लैटफ़ॉर्म के हिसाब से और ऐसे वेब ऐप्लिकेशन जो लोकल सिंक या अपने-आप बैकअप लेने की सुविधा देते हैं उपयोगकर्ताओं का Drive की फ़ाइलें.
- उत्पादकता और शिक्षा से जुड़े ऐसे ऐप्लिकेशन जिनके यूज़र इंटरफ़ेस में ये शामिल हो सकते हैं Drive फ़ाइलों (या उनके मेटाडेटा या अनुमतियां). काम को आसान बनाने वाले ऐप्लिकेशन में टास्क मैनेजमेंट, नोट शामिल हैं और कक्षा में मिलकर काम करने के लिए इस्तेमाल किए जाने वाले टूल इस्तेमाल करना.
- रिपोर्टिंग और सुरक्षा से जुड़े ऐसे ऐप्लिकेशन जो उपयोगकर्ता या ग्राहक के बारे में अहम जानकारी उपलब्ध कराते हैं फ़ाइलें शेयर या ऐक्सेस की जा सकती हैं.
पाबंदी वाले दायरों का इस्तेमाल जारी रखने के लिए, आपको अपने ऐप्लिकेशन को पाबंदी वाले दायरे के लिए तैयार करना चाहिए दायरा पुष्टि की प्रक्रिया के लिए.
पाबंदी वाले स्कोप से मौजूदा ऐप्लिकेशन को माइग्रेट करना
अगर आपने प्रतिबंधित नियमों में से किसी एक का इस्तेमाल करके, Drive ऐप्लिकेशन बनाया है तो हमारा सुझाव है कि आप अपने ऐप्लिकेशन को प्रति फ़ाइल ऐक्सेस दायरा देता है और एक ऐप्लिकेशन. कई ऐप्लिकेशन बिना किसी बदलाव के प्रति-फ़ाइल ऐक्सेस के साथ काम करते हैं. अगर इसका इस्तेमाल किया जा रहा है, तो अगर आपको अपना फ़ाइल पिकर इस्तेमाल करना है, तो हमारा सुझाव है कि आप Google पिकर एपीआई पर जाएं. अलग-अलग दायरे में काम करता है.
drive.file OAuth के दायरे के फ़ायदे
drive.file OAuth दायरे और Google पिकर एपीआई का इस्तेमाल करने से, दोनों उपयोगकर्ता ऑप्टिमाइज़ हो जाते हैं
आपके ऐप्लिकेशन को सुरक्षित रखने का बेहतरीन तरीक़ा क्या है.
drive.file के OAuth दायरे की मदद से, उपयोगकर्ता चुन सकते हैं कि उन्हें कौनसी फ़ाइलें शेयर करनी हैं
को कैसे ट्रैक करें. इससे उन्हें इस बात पर ज़्यादा कंट्रोल और भरोसा मिलता है कि आपका ऐप्लिकेशन
उनकी फ़ाइलों का ऐक्सेस सीमित और ज़्यादा सुरक्षित होता है. इसके उलट, समाचार संगठनों के लिए
Drive की सभी फ़ाइलों को ऐक्सेस करने से, उपयोगकर्ता इंटरैक्ट नहीं कर पाएंगे
को कैसे ट्रैक करें. drive.file का इस्तेमाल करने की कुछ वजहें नीचे दी गई हैं
दायरा:
उपयोगिता:
drive.fileस्कोप सभी Drive API के साथ काम करता है REST रिसॉर्स का मतलब है कि इसे उसी तरह से करें जिस तरह से OAuth के बड़े दायरों का इस्तेमाल किया जाता है.सुविधाएं: Google पिकर एपीआई की सुविधा, Drive का यूज़र इंटरफ़ेस (यूआई). इसमें कई ऐसे व्यू शामिल हैं जो झलक दिखाते हैं और के थंबनेल और इनलाइन, मॉडल विंडो को उपयोगकर्ता मुख्य ऐप्लिकेशन से कभी नहीं जाते.
सुविधा: ऐप्लिकेशन कुछ Drive के लिए फ़िल्टर लगा सकते हैं फ़ाइल टाइप (जैसे कि Google Docs, Sheets, और फ़ोटो) को एक्सपोर्ट करने के लिए Google पिकर पर फ़िल्टर का इस्तेमाल करके फ़ाइलें शामिल हैं.
साथ ही, चूंकि drive.file असंवेदनशील है, इसलिए यह ज़्यादा अच्छी तरह
पुष्टि की प्रक्रिया पूरी होती है.
रीफ़्रेश टोकन सेव करें
रीफ़्रेश टोकन को सुरक्षित और लंबे समय के लिए उपलब्ध स्टोरेज में सेव करें. साथ ही, उनका इस्तेमाल जब तक वे मान्य हैं.