इस दस्तावेज़ में, Google Drive API का इस्तेमाल करके शेयर की गई ड्राइव को मैनेज करने से जुड़े टास्क के बारे में बताया गया है. जैसे, शेयर की गई ड्राइव बनाना, सदस्यों और अनुमतियों को मैनेज करना वगैरह.
अगर आपको जवाब में दिखाए जाने वाले फ़ील्ड तय करने हैं, तो
fields system
parameter
को drives संसाधन के किसी भी तरीके के साथ सेट किया जा सकता है. अगर fields पैरामीटर तय नहीं किया जाता है, तो सर्वर, तरीके के हिसाब से फ़ील्ड का डिफ़ॉल्ट सेट दिखाता है. उदाहरण के लिए,
list तरीका, शेयर की गई हर ड्राइव के लिए सिर्फ़ kind, id,
और name फ़ील्ड दिखाता है. ज़्यादा जानकारी के लिए, खास फ़ील्ड दिखाना
लेख पढ़ें.
शेयर की गई ड्राइव में फ़ोल्डर की सीमाओं के बारे में ज़्यादा जानने के लिए, शेयर की गई ड्राइव में फ़ोल्डर की सीमाएं लेख पढ़ें.
ज़रूरी शर्तें
शेयर की गई ड्राइव बनाने और उन्हें मैनेज करने से पहले, पक्का करें कि आपने ये ज़रूरी शर्तें पूरी की हों:
- Google Workspace खाता: शेयर की गई ड्राइव, Google Workspace के उन वर्शन में उपलब्ध हैं जो इस सुविधा के साथ काम करते हैं. जैसे, Business Standard, Business Plus, Enterprise, और Education. निजी Google खातों (
@gmail.com) से शेयर की गई ड्राइव नहीं बनाई जा सकतीं. - बनाने की अनुमति: डोमेन एडमिन यह कॉन्फ़िगर कर सकते हैं कि उनके संगठन के उपयोगकर्ता, शेयर की गई ड्राइव बना सकते हैं या नहीं. पुष्टि किए गए उपयोगकर्ता का खाता, संगठन की ऐसी इकाई से जुड़ा होना चाहिए जिसे शेयर की गई ड्राइव बनाने की अनुमति मिली हो.
- OAuth 2.0 स्कोप: आपके ऐप्लिकेशन को
https://www.googleapis.com/auth/driveस्कोप के साथ अनुमति मिली होनी चाहिए. - भूमिकाएं: जब कोई उपयोगकर्ता शेयर की गई ड्राइव बनाता है, तो उसे उस शेयर की गई ड्राइव के लिए,
organizerकी भूमिका अपने-आप असाइन हो जाती है. ड्राइव की सेटिंग मैनेज करने, ड्राइव का नाम बदलने, सदस्यों को जोड़ने या हटाने, और शेयर की गई ड्राइव को मिटाने के लिए,organizerकी भूमिका होना ज़रूरी है. भूमिकाओं के बारे में ज़्यादा जानने के लिए, शेयर की गई ड्राइव के लिए भूमिकाएं लेख पढ़ें. - डोमेन एडमिन का ऐक्सेस: डोमेन एडमिन, अपने संगठन में मौजूद किसी भी शेयर की गई ड्राइव को मैनेज कर सकते हैं. इसके लिए, उन्हें
useDomainAdminAccess=trueपास करना होगा. इससे फ़र्क़ नहीं पड़ता कि वे उस शेयर की गई ड्राइव के सदस्य हैं या नहीं. ज़्यादा जानकारी के लिए, डोमेन एडमिन के तौर पर शेयर की गई ड्राइव मैनेज करना लेख पढ़ें.
शेयर की गई ड्राइव बनाना
शेयर की गई ड्राइव बनाने के लिए, create
तरीके का इस्तेमाल drives संसाधन पर
requestId पैरामीटर के साथ करें.
requestId पैरामीटर, शेयर की गई ड्राइव को एक ही बार बनाने के लिए, लॉजिकल कोशिश की पहचान करता है. अगर अनुरोध का टाइम आउट हो जाता है या बैकएंड में कोई गड़बड़ी होती है, तो उसी अनुरोध को दोहराया जा सकता है. इससे डुप्लीकेट शेयर की गई ड्राइव नहीं बनेगी. requestId और अनुरोध का मुख्य हिस्सा एक ही होना चाहिए.
यहां दिए गए कोड के सैंपल में, शेयर की गई ड्राइव बनाने का तरीका बताया गया है:
Java
Python
Node.js
PHP
.NET
create तरीके को
एक से ज़्यादा बार कॉल किया जा सकता है.
अगर शेयर की गई ड्राइव, पिछले अनुरोध पर या फिर से कोशिश करने पर बन गई है, तो यह तरीका, drives संसाधन का एक इंस्टेंस दिखाता है. कभी-कभी, जैसे कि ज़्यादा समय बीत जाने पर या अनुरोध के मुख्य हिस्से में बदलाव होने पर, 409 गड़बड़ी दिख सकती है. इसका मतलब है कि requestId को खारिज करना होगा.
शेयर की गई ड्राइव की जानकारी पाना
शेयर की गई ड्राइव का मेटाडेटा पाने के लिए, get तरीके का इस्तेमाल
drives संसाधन पर driveId पाथ
पैरामीटर के साथ करें. अगर आपको ड्राइव का आईडी नहीं पता है, तो आप
शेयर की गई सभी ड्राइव की सूची list तरीके का इस्तेमाल करके देख सकते हैं.
get तरीका, शेयर की गई ड्राइव को drives संसाधन के इंस्टेंस के तौर पर दिखाता है.
डोमेन एडमिन के तौर पर अनुरोध जारी करने के लिए, useDomainAdminAccess क्वेरी पैरामीटर को true पर सेट करें. ज़्यादा जानकारी के लिए, डोमेन एडमिन के तौर पर
शेयर की गई ड्राइव मैनेज करना लेख पढ़ें.
शेयर की गई ड्राइव की सूची देखना
किसी उपयोगकर्ता की शेयर की गई ड्राइव की सूची देखने के लिए, list
तरीके का इस्तेमाल drives संसाधन पर करें. यह तरीका, शेयर की गई ड्राइव की सूची दिखाता है.
शेयर की गई ड्राइव के पेजों की संख्या तय करने या उन्हें फ़िल्टर करने के लिए, ये क्वेरी पैरामीटर पास करें:
pageSize: हर पेज पर, शेयर की गई ड्राइव की ज़्यादा से ज़्यादा संख्या.pageToken: पेज टोकन, जो सूची देखने के लिए किए गए पिछले कॉल से मिला हो. अगला पेज पाने के लिए, यह टोकन उपलब्ध कराएं.q: शेयर की गई ड्राइव खोजने के लिए क्वेरी स्ट्रिंग. ज़्यादा जानकारी के लिए, शेयर की गई ड्राइव खोजना लेख पढ़ें.useDomainAdminAccess: अनुरोध को डोमेन एडमिन के तौर पर जारी करने के लिए, इसेtrueपर सेट करें. इससे उस डोमेन की शेयर की गई सभी ड्राइव दिखेंगी जिसमें अनुरोध करने वाला व्यक्ति एडमिन है. ज़्यादा जानकारी के लिए, डोमेन एडमिन के तौर पर शेयर की गई ड्राइव मैनेज करना लेख पढ़ें.
शेयर की गई ड्राइव अपडेट करना
शेयर की गई ड्राइव का मेटाडेटा अपडेट करने के लिए, update तरीके का इस्तेमाल
drives संसाधन पर driveId पाथ
पैरामीटर के साथ करें.
यह तरीका, शेयर की गई ड्राइव को drives संसाधन के इंस्टेंस के तौर पर दिखाता है.
डोमेन एडमिन के तौर पर अनुरोध जारी करने के लिए, useDomainAdminAccess क्वेरी पैरामीटर को true पर सेट करें. ज़्यादा जानकारी के लिए, डोमेन एडमिन के तौर पर
शेयर की गई ड्राइव मैनेज करना लेख पढ़ें.
शेयर की गई ड्राइव को छिपाना और दिखाना
शेयर की गई ड्राइव को डिफ़ॉल्ट व्यू से छिपाने के लिए, hide तरीके का इस्तेमाल
drives संसाधन पर driveId पैरामीटर के साथ करें.
शेयर की गई ड्राइव को छिपाने पर, Drive, शेयर की गई ड्राइव के संसाधन को hidden=true के तौर पर मार्क करता है. छिपाई गई शेयर की गई ड्राइव, Drive के यूज़र इंटरफ़ेस (यूआई) में या दिखाई गई फ़ाइलों की सूची में नहीं दिखतीं.
शेयर की गई ड्राइव को डिफ़ॉल्ट व्यू में वापस लाने के लिए, unhide तरीके का इस्तेमाल
drives संसाधन पर driveId पैरामीटर के साथ करें.
ये दोनों तरीके, शेयर की गई ड्राइव को drives संसाधन के इंस्टेंस के तौर पर दिखाते हैं.
शेयर की गई ड्राइव मिटाना
शेयर की गई ड्राइव को हमेशा के लिए मिटाने के लिए, delete तरीके का इस्तेमाल
drives संसाधन पर driveId पैरामीटर के साथ करें.
शेयर की गई ड्राइव को मिटाने से पहले, उसमें मौजूद सभी कॉन्टेंट को ट्रैश में ले जाना या मिटाना होगा. उपयोगकर्ता के पास, शेयर की गई ड्राइव के फ़ोल्डर के लिए role=organizer की भूमिका भी होनी चाहिए. ज़्यादा जानकारी के लिए, फ़ाइलें और फ़ोल्डर ट्रैश में ले जाना या मिटाना लेख पढ़ें.
ये क्वेरी पैरामीटर पास करें:
useDomainAdminAccess: अनुरोध को डोमेन एडमिन के तौर पर जारी करने के लिए, इसेtrueपर सेट करें. ज़्यादा जानकारी के लिए, डोमेन एडमिन के तौर पर शेयर की गई ड्राइव मैनेज करना लेख पढ़ें.allowItemDeletion: शेयर की गई ड्राइव में मौजूद आइटम मिटाने के लिए, इसेtrueपर सेट करें. यह सुविधा सिर्फ़ तब काम करती है, जबuseDomainAdminAccessको भीtrueपर सेट किया गया हो.
शेयर की गई ड्राइव में सदस्यों को जोड़ना या हटाना
permissions संसाधन का इस्तेमाल करके, शेयर की गई ड्राइव में सदस्यों को जोड़ा या हटाया जा सकता है.
किसी सदस्य को जोड़ने के लिए, शेयर की गई ड्राइव पर अनुमति बनाएं. शेयर की गई ड्राइव में मौजूद अलग-अलग फ़ाइलों पर भी अनुमति के तरीकों का इस्तेमाल किया जा सकता है. इससे सदस्यों को अतिरिक्त विशेषाधिकार दिए जा सकते हैं या गैर-सदस्यों को खास आइटम पर मिलकर काम करने की अनुमति दी जा सकती है.
ज़्यादा जानकारी और सैंपल कोड के लिए, फ़ाइलें, फ़ोल्डर, और ड्राइव शेयर करना लेख पढ़ें.
डोमेन एडमिन के तौर पर शेयर की गई ड्राइव मैनेज करना
किसी संगठन में शेयर की गई
ड्राइव को मैनेज करने के लिए,
drives और
permissions संसाधनों के साथ useDomainAdminAccess पैरामीटर लागू करें.
useDomainAdminAccess=true के साथ इन तरीकों को कॉल करने वाले उपयोगकर्ताओं के पास,
Drive and Docs एडमिन
विशेषाधिकार होने चाहिए.
एडमिन, शेयर की गई ड्राइव खोज सकते हैं या अपने संगठन के मालिकाना हक वाली शेयर की गई
ड्राइव के लिए अनुमतियां अपडेट कर सकते हैं. इससे फ़र्क़ नहीं पड़ता कि एडमिन, शेयर की गई किसी ड्राइव का सदस्य है या नहीं
.
सेवा खातों का इस्तेमाल करते समय, आपको सेवा खाते के इंपर्सनेशन का इस्तेमाल करके, पुष्टि किए गए एडमिन के तौर पर काम करना पड़ सकता है. ध्यान दें कि सेवा खाते आपके Google Workspace डोमेन के नहीं होते. हालांकि, उपयोगकर्ता खाते आपके Google Workspace डोमेन के होते हैं. अगर Google Workspace के ऐसे ऐसेट शेयर किए जाते हैं जो आपके पूरे Google Workspace डोमेन के साथ शेयर किए गए हैं, तो वे सेवा खातों के साथ शेयर नहीं किए जाते. ज़्यादा जानकारी के लिए, सेवा खातों की खास जानकारी लेख पढ़ें.
ऐसी शेयर की गई ड्राइव को वापस पाना जिसका कोई आयोजक नहीं है
यहां दिए गए कोड के सैंपल में, ऐसी शेयर की गई ड्राइव को वापस पाने का तरीका बताया गया है जिनका कोई आयोजक नहीं है.
Java
Python
Node.js
PHP
.NET
उपयोगकर्ताओं को फ़ाइलें डाउनलोड, प्रिंट या कॉपी करने से रोकना
शेयर की गई ड्राइव में मौजूद फ़ाइलों को डाउनलोड, प्रिंट, और कॉपी करने की अनुमति सीमित की जा सकती है.
यह जानने के लिए कि उपयोगकर्ता, शेयर की गई ड्राइव पर आयोजक की ओर से लागू की गई डाउनलोड की पाबंदियों
में बदलाव कर सकता है या नहीं, capabilities.canChangeDownloadRestriction बूलियन फ़ील्ड देखें. अगर capabilities.canChangeDownloadRestriction को true पर सेट किया गया है, तो शेयर की गई ड्राइव पर डाउनलोड की पाबंदियां लागू की जा सकती हैं. ज़्यादा जानकारी के लिए, फ़ाइल की क्षमताओं के बारे में जानकारी लेख पढ़ें.
drives संसाधन में,
बूलियन restrictions
फ़ील्ड का कलेक्शन होता है. इसका इस्तेमाल यह बताने के लिए किया जाता है कि शेयर की गई ड्राइव पर कोई कार्रवाई की जा सकती है या नहीं.
पाबंदियां, शेयर की गई ड्राइव या उसमें मौजूद आइटम पर लागू होती हैं.
drives.update तरीके का इस्तेमाल करके, पाबंदियां सेट की जा सकती हैं.
शेयर की गई ड्राइव पर डाउनलोड की पाबंदियां लागू करने के लिए, शेयर की गई ड्राइव का मैनेजर,
DownloadRestriction ऑब्जेक्ट का इस्तेमाल करके, drives
संसाधन के restrictions.downloadRestriction फ़ील्ड को सेट कर सकता है.
restrictedForReaders बूलियन फ़ील्ड को true पर सेट करने का मतलब है कि पढ़ने वालों के लिए, डाउनलोड और कॉपी, दोनों पर पाबंदी है. restrictedForWriters बूलियन फ़ील्ड को true पर सेट करने का मतलब है कि लिखने वालों के लिए, डाउनलोड और कॉपी, दोनों पर पाबंदी है. ध्यान दें कि अगर restrictedForWriters फ़ील्ड true है, तो पढ़ने वालों के लिए भी डाउनलोड और कॉपी पर पाबंदी होगी. इसी तरह, restrictedForWriters को true और restrictedForReaders को false पर सेट करने का मतलब है कि restrictedForWriters और restrictedForReaders, दोनों को true पर सेट किया गया है.
पिछले वर्शन के गेम खेलने की सुविधा
DownloadRestriction ऑब्जेक्ट के लॉन्च होने के बाद, restrictions.copyRequiresWriterPermission
बूलियन फ़ील्ड की सुविधा अपडेट कर दी गई है.
अब, restrictions.copyRequiresWriterPermission को true पर सेट करने से,
restrictedForReaders बूलियन फ़ील्ड का DownloadRestriction ऑब्जेक्ट, true पर अपडेट हो जाता है. इसका मतलब है कि
पढ़ने वालों के लिए, डाउनलोड और कॉपी, दोनों पर पाबंदी है.
copyRequiresWriterPermission फ़ील्ड को false पर सेट करने से, restrictedForWriters और restrictedForReaders, दोनों फ़ील्ड false पर अपडेट हो जाते हैं. इसका मतलब है कि सभी उपयोगकर्ताओं के लिए, डाउनलोड या कॉपी की पाबंदी वाली सेटिंग हटा दी जाती हैं.
डाउनलोड, प्रिंट, और कॉपी की सुविधाओं को कंट्रोल करने वाले फ़ील्ड
यहां दी गई टेबल में, drives संसाधन के उन फ़ील्ड के बारे में बताया गया है
जो डाउनलोड, प्रिंट, और कॉपी की सुविधाओं पर असर डालते हैं:
| फ़ील्ड | ब्यौरा | वर्शन |
|---|---|---|
capabilities.canCopy |
मौजूदा उपयोगकर्ता, शेयर की गई ड्राइव में मौजूद फ़ाइलों को कॉपी कर सकता है या नहीं. | v2 और v3 |
capabilities.canDownload |
मौजूदा उपयोगकर्ता, शेयर की गई ड्राइव में मौजूद फ़ाइलों को डाउनलोड कर सकता है या नहीं. | v2 और v3 |
capabilities.canChangeCopyRequiresWriterPermissionRestriction |
मौजूदा उपयोगकर्ता, शेयर की गई ड्राइव की copyRequiresWriterPermission पाबंदी में बदलाव कर सकता है या नहीं. |
v2 और v3 |
capabilities.canResetDriveRestrictions |
मौजूदा उपयोगकर्ता, शेयर की गई ड्राइव की पाबंदियों को डिफ़ॉल्ट पर रीसेट कर सकता है या नहीं. | v2 और v3 |
capabilities.canChangeDownloadRestriction |
मौजूदा उपयोगकर्ता, शेयर की गई ड्राइव की डाउनलोड की पाबंदी में बदलाव कर सकता है या नहीं. | सिर्फ़ v3 |
restrictions.copyRequiresWriterPermission |
शेयर की गई ड्राइव में मौजूद फ़ाइलों को कॉपी, प्रिंट या डाउनलोड करने के विकल्प, पढ़ने वालों और टिप्पणी करने वालों के लिए बंद हैं या नहीं. जब यह true होता है, तो यह शेयर की गई ड्राइव में मौजूद किसी भी फ़ाइल के लिए, इसी नाम के फ़ील्ड को true पर सेट कर देता है. |
v2 और v3 |
restrictions.downloadRestriction |
शेयर की गई ड्राइव के मैनेजर की ओर से लागू की गई डाउनलोड की पाबंदियां. | सिर्फ़ v3 |
फ़ोल्डर की सीमाएं
शेयर की गई ड्राइव में, आइटम और फ़ोल्डर की गहराई की सीमाएं होती हैं. इसके अलावा, स्टोरेज के इस्तेमाल को संगठन के पूल किए गए स्टोरेज के हिसाब से मैनेज किया जाता है. न कि किसी उपयोगकर्ता के निजी 'मेरी ड्राइव' के स्टोरेज कोटा के हिसाब से. ज़्यादा जानकारी के लिए, देखें Google Drive में शेयर की गई ड्राइव की सीमाएं.
आइटम की सीमा
शेयर की गई ड्राइव में ज़्यादा से ज़्यादा 5,00, 000 आइटम हो सकते हैं. इनमें फ़ाइलें, फ़ोल्डर, और शॉर्टकट शामिल हैं.
सीमा पूरी होने के बाद, शेयर की गई ड्राइव में आइटम सेव नहीं किए जा सकते. फ़ाइलें सेव करने की सुविधा फिर से पाने के लिए, उपयोगकर्ताओं को शेयर की गई ड्राइव से आइटम हमेशा के लिए मिटाने होंगे. ध्यान दें कि ट्रैश में मौजूद आइटम, सीमा में गिने जाते हैं. हालांकि, हमेशा के लिए मिटाए गए आइटम नहीं गिने जाते. ज़्यादा जानकारी के लिए, फ़ाइलें और फ़ोल्डर ट्रैश में ले जाना या मिटाना लेख पढ़ें.
फ़ोल्डर की गहराई की सीमा
शेयर की गई ड्राइव में मौजूद किसी फ़ोल्डर में, नेस्ट किए गए 100 से ज़्यादा फ़ोल्डर नहीं हो सकते. इसका मतलब है कि चाइल्ड फ़ोल्डर को ऐसे फ़ोल्डर में सेव नहीं किया जा सकता जो 99 से ज़्यादा लेवल गहरा हो. यह सीमा सिर्फ़ चाइल्ड फ़ोल्डर पर लागू होती है.
100 से ज़्यादा लेवल के फ़ोल्डर जोड़ने की कोशिश करने पर,
teamDriveHierarchyTooDeep
एचटीटीपी स्टेटस कोड का जवाब मिलता है.
मिलते-जुलते विषय
- शेयर की गई ड्राइव की खास जानकारी
- शेयर की गई ड्राइव की सुविधा लागू करना
- इस्तेमाल की सीमाएं
- फ़ाइलों में फ़ाइल और फ़ोल्डर की सीमाएं
- भूमिकाएं और अनुमतियां