इस गाइड में, Google Drive API का इस्तेमाल करके शेयर की गई ड्राइव मैनेज करने से जुड़े टास्क दिए गए हैं. जैसे, शेयर की गई ड्राइव बनाना, सदस्यों और अनुमतियों को मैनेज करना.
अगर आपको रिस्पॉन्स में दिखाए जाने वाले फ़ील्ड तय करने हैं, तो drives रिसॉर्स के किसी भी तरीके के साथ, fields system
parameter सेट करें. अगर आपने fields पैरामीटर तय नहीं किया है, तो सर्वर, तरीके के हिसाब से फ़ील्ड का डिफ़ॉल्ट सेट दिखाता है. उदाहरण के लिए, list तरीके से, हर शेयर की गई ड्राइव के लिए सिर्फ़ kind, id, और name फ़ील्ड दिखते हैं. ज़्यादा जानकारी के लिए, चुनिंदा फ़ील्ड की वैल्यू वापस पाना लेख पढ़ें.
शेयर की गई ड्राइव में फ़ोल्डर की सीमाओं के बारे में ज़्यादा जानने के लिए, शेयर की गई ड्राइव में फ़ोल्डर की सीमाएं लेख पढ़ें.
शेयर की गई ड्राइव बनाना
शेयर की गई ड्राइव बनाने के लिए, drives रिसॉर्स पर create तरीके का इस्तेमाल करें. साथ ही, requestId पैरामीटर का इस्तेमाल करें.
requestId पैरामीटर, शेयर की गई ड्राइव को एक बार बनाने के लिए लॉजिकल कोशिश की पहचान करता है. अगर अनुरोध का समय खत्म हो जाता है या बैकएंड से कोई ऐसी गड़बड़ी मिलती है जिसके बारे में जानकारी नहीं है, तो उसी अनुरोध को दोहराया जा सकता है. इससे डुप्लीकेट नहीं बनेंगे. अनुरोध का requestId और मुख्य हिस्सा एक जैसा होना चाहिए.
नीचे दिए गए कोड के सैंपल में, शेयर की गई ड्राइव बनाने का तरीका बताया गया है:
Java
Python
Node.js
PHP
.NET
create तरीके को कॉल करने पर, एक ही नतीजा मिलता है.
अगर पिछले अनुरोध पर या फिर से कोशिश करने पर, शेयर की गई ड्राइव बन जाती है, तो यह तरीका drives संसाधन का इंस्टेंस दिखाता है. कभी-कभी, जैसे कि लंबे समय के बाद या अनुरोध के मुख्य हिस्से में बदलाव होने पर, 409 गड़बड़ी दिख सकती है. इससे पता चलता है कि requestId को खारिज कर दिया जाना चाहिए.
शेयर की गई ड्राइव पाना
किसी शेयर की गई ड्राइव का मेटाडेटा पाने के लिए, driveId पाथ पैरामीटर के साथ drives रिसॉर्स पर get तरीके का इस्तेमाल करें. अगर आपको ड्राइव आईडी नहीं पता है, तो list तरीके का इस्तेमाल करके, शेयर की गई सभी ड्राइव की सूची बनाएं.
get वाला तरीका, शेयर की गई ड्राइव को drives संसाधन के इंस्टेंस के तौर पर दिखाता है.
डोमेन एडमिन के तौर पर अनुरोध करने के लिए, useDomainAdminAccess क्वेरी पैरामीटर को true पर सेट करें. ज़्यादा जानकारी के लिए, डोमेन एडमिन के तौर पर शेयर की गई ड्राइव मैनेज करना लेख पढ़ें.
शेयर की गई ड्राइव की सूची बनाना
किसी उपयोगकर्ता की शेयर की गई ड्राइव की सूची बनाने के लिए, drives संसाधन पर list तरीके का इस्तेमाल करें. यह तरीका, शेयर की गई ड्राइव की सूची दिखाता है.
शेयर की गई ड्राइव के पेज नंबर को पसंद के मुताबिक बनाने या उन्हें फ़िल्टर करने के लिए, ये क्वेरी पैरामीटर पास करें:
pageSize: हर पेज पर, ज़्यादा से ज़्यादा कितनी शेयर की गई ड्राइव वापस लाई जा सकती हैं.pageToken: यह एक पेज टोकन है, जो सूची बनाने के लिए किए गए पिछले कॉल से मिला है. अगला पेज पाने के लिए, यह टोकन दें.q: शेयर की गई ड्राइव को खोजने के लिए क्वेरी स्ट्रिंग. ज़्यादा जानकारी के लिए, शेयर की गई ड्राइव खोजना लेख पढ़ें.useDomainAdminAccess: इस पैरामीटर कोuseDomainAdminAccessपर सेट करें, ताकि डोमेन एडमिन के तौर पर अनुरोध किया जा सके. इससे उस डोमेन की सभी शेयर की गई ड्राइव वापस मिल जाएंगी जिसमें अनुरोध करने वाला व्यक्ति एडमिन है.trueज़्यादा जानकारी के लिए, डोमेन एडमिन के तौर पर शेयर की गई ड्राइव मैनेज करना लेख पढ़ें.
शेयर की गई ड्राइव को अपडेट करना
शेयर की गई ड्राइव का मेटाडेटा अपडेट करने के लिए, drives रिसॉर्स पर update तरीके का इस्तेमाल करें. इसके लिए, driveId पाथ पैरामीटर का इस्तेमाल करें.
यह तरीका, शेयर की गई ड्राइव को drives संसाधन के इंस्टेंस के तौर पर दिखाता है.
डोमेन एडमिन के तौर पर अनुरोध करने के लिए, useDomainAdminAccess क्वेरी पैरामीटर को true पर सेट करें. ज़्यादा जानकारी के लिए, डोमेन एडमिन के तौर पर शेयर की गई ड्राइव मैनेज करना लेख पढ़ें.
शेयर की गई ड्राइव को छिपाना और दिखाना
डिफ़ॉल्ट व्यू से किसी शेयर की गई ड्राइव को छिपाने के लिए, driveId पैरामीटर के साथ drives संसाधन पर hide तरीके का इस्तेमाल करें.
किसी शेयर की गई ड्राइव को छिपाने पर, Drive उस ड्राइव के संसाधन को hidden=true के तौर पर मार्क करता है. छिपाई गई शेयर की गई ड्राइव, Drive के यूज़र इंटरफ़ेस (यूआई) या वापस लाई गई फ़ाइलों की सूची में नहीं दिखती हैं.
शेयर की गई ड्राइव को डिफ़ॉल्ट व्यू में वापस लाने के लिए, driveId पैरामीटर के साथ drives संसाधन पर unhide तरीके का इस्तेमाल करें.
दोनों तरीकों से, शेयर की गई ड्राइव को drives संसाधन के इंस्टेंस के तौर पर दिखाया जाता है.
शेयर की गई ड्राइव मिटाना
किसी शेयर की गई ड्राइव को हमेशा के लिए मिटाने के लिए, driveId पैरामीटर के साथ drives रिसॉर्स पर delete तरीके का इस्तेमाल करें.
किसी शेयर की गई ड्राइव को मिटाने से पहले, उसमें मौजूद सारा कॉन्टेंट ट्रैश में ले जाना या मिटाना ज़रूरी है. उपयोगकर्ता के पास, शेयर की गई ड्राइव के फ़ोल्डर पर role=organizer भी होना चाहिए. ज़्यादा जानकारी के लिए, फ़ाइलों और फ़ोल्डर को ट्रैश में डालना या मिटाना लेख पढ़ें.
शेयर की गई ड्राइव को फ़िल्टर करने के लिए, यहां दिए गए क्वेरी पैरामीटर पास करें:
useDomainAdminAccess: इस पैरामीटर कोuseDomainAdminAccessपर सेट करें, ताकि डोमेन एडमिन के तौर पर अनुरोध किया जा सके. इससे उस डोमेन की सभी शेयर की गई ड्राइव वापस मिल जाएंगी जिसमें अनुरोध करने वाला व्यक्ति एडमिन है.trueज़्यादा जानकारी के लिए, डोमेन एडमिन के तौर पर शेयर की गई ड्राइव मैनेज करना लेख पढ़ें.allowItemDeletion: शेयर की गई ड्राइव में मौजूद आइटम मिटाने के लिए, इसेtrueपर सेट करें. इस वैल्यू का इस्तेमाल सिर्फ़ तब किया जा सकता है, जबuseDomainAdminAccessको भीtrueपर सेट किया गया हो.
शेयर की गई ड्राइव के सदस्यों को जोड़ना या हटाना
permissions रिसॉर्स का इस्तेमाल करके, शेयर की गई ड्राइव के सदस्यों को जोड़ें या हटाएं.
किसी सदस्य को जोड़ने के लिए, शेयर की गई ड्राइव पर अनुमति बनाएं. शेयर की गई ड्राइव में मौजूद अलग-अलग फ़ाइलों के लिए भी अनुमतियों के तरीकों का इस्तेमाल किया जा सकता है. इससे सदस्यों को अतिरिक्त सुविधाएं दी जा सकती हैं या उन लोगों को कुछ आइटम पर मिलकर काम करने की अनुमति दी जा सकती है जो शेयर की गई ड्राइव के सदस्य नहीं हैं.
ज़्यादा जानकारी और सैंपल कोड के लिए, फ़ाइलें, फ़ोल्डर, और ड्राइव शेयर करना लेख पढ़ें.
डोमेन एडमिन के तौर पर शेयर की गई ड्राइव मैनेज करना
किसी संगठन में शेयर की गई ड्राइव को मैनेज करने के लिए, drives और permissions संसाधनों के साथ useDomainAdminAccess पैरामीटर लागू करें.
useDomainAdminAccess=true के साथ इन तरीकों को कॉल करने वाले उपयोगकर्ताओं के पास, Drive and Docs एडमिन के खास अधिकार होने चाहिए.
एडमिन, शेयर की गई ड्राइव खोज सकते हैं. इसके अलावा, वे अपने संगठन के मालिकाना हक वाली शेयर की गई ड्राइव के लिए अनुमतियां अपडेट कर सकते हैं. भले ही, एडमिन किसी शेयर की गई ड्राइव का सदस्य हो या न हो.
सेवा खातों का इस्तेमाल करते समय, आपको सेवा खाते के डुप्लीकेट के तौर पर काम करने की सुविधा का इस्तेमाल करके, पुष्टि किए गए एडमिन के डुप्लीकेट के तौर पर काम करना पड़ सकता है. ध्यान दें कि सेवा खाते, उपयोगकर्ता खातों की तरह आपके 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 पर सेट करने से, DownloadRestriction ऑब्जेक्ट के restrictedForReaders बूलियन फ़ील्ड को true पर अपडेट किया जाता है. इससे यह पता चलता है कि पढ़ने वालों के लिए, डाउनलोड और कॉपी, दोनों पर पाबंदी है.
copyRequiresWriterPermission फ़ील्ड को false पर सेट करने से, restrictedForWriters और restrictedForReaders, दोनों फ़ील्ड false पर अपडेट हो जाते हैं. इसका मतलब है कि सभी उपयोगकर्ताओं के लिए, डाउनलोड करने या कॉपी करने से जुड़ी पाबंदी की सेटिंग हटा दी जाती हैं.
डाउनलोड, प्रिंट, और कॉपी करने की सुविधाओं को कंट्रोल करने वाले फ़ील्ड
नीचे दी गई टेबल में, drives संसाधन फ़ील्ड दिए गए हैं. इनसे डाउनलोड, प्रिंट, और कॉपी करने की सुविधा पर असर पड़ता है:
| फ़ील्ड | ब्यौरा | वर्शन |
|---|---|---|
capabilities.canCopy |
इससे पता चलता है कि मौजूदा उपयोगकर्ता, शेयर की गई ड्राइव में मौजूद फ़ाइलों को कॉपी कर सकता है या नहीं. | v2 और v3 |
capabilities.canDownload |
इससे पता चलता है कि मौजूदा उपयोगकर्ता, शेयर की गई ड्राइव में मौजूद फ़ाइलें डाउनलोड कर सकता है या नहीं. | v2 और v3 |
capabilities.canChangeCopyRequiresWriterPermission |
इससे पता चलता है कि मौजूदा उपयोगकर्ता, शेयर की गई ड्राइव की 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 एचटीटीपी स्टेटस कोड रिस्पॉन्स मिलता है.