फ़ोल्डर ऐसी फ़ाइलें होती हैं जिनमें सिर्फ़ मेटाडेटा होता है. इनका इस्तेमाल, Google Drive में फ़ाइलों को व्यवस्थित करने के लिए किया जा सकता है. इनमें ये प्रॉपर्टी होती हैं:
- फ़ोल्डर एक ऐसी फ़ाइल होती है जिसका एमआईएमई टाइप
application/vnd.google-apps.folderहोता है और इसका कोई एक्सटेंशन नहीं होता. - फ़ाइल आईडी दिए जाने पर, रूट फ़ोल्डर को रेफ़र करने के लिए,
rootउपनाम का इस्तेमाल किया जा सकता है.
Drive फ़ोल्डर की सीमाओं के बारे में ज़्यादा जानने के लिए, फ़ाइल और फ़ोल्डर की सीमाएं देखें.
इस गाइड में, फ़ोल्डर से जुड़े कुछ बुनियादी टास्क करने का तरीका बताया गया है.
कोई फ़ोल्डर बनाएं
फ़ोल्डर बनाने के लिए, files.create() तरीके का इस्तेमाल करें. इसके साथ, application/vnd.google-apps.folder का mimeType और name का इस्तेमाल करें.
यहां दिए गए कोड सैंपल में, क्लाइंट लाइब्रेरी का इस्तेमाल करके फ़ोल्डर बनाने का तरीका बताया गया है:
Java
Python
Node.js
PHP
.NET
curl
curl -X POST 'https://www.googleapis.com/drive/v3/files' \
-H 'Authorization: Bearer ACCESS_TOKEN' \
-H 'Content-Type: application/json' \
-d '{
"name": "FOLDER_NAME",
"mimeType": "application/vnd.google-apps.folder"
}'
इनकी जगह ये डालें:
- ACCESS_TOKEN: आपके ऐप्लिकेशन का OAuth 2.0 टोकन.
- FOLDER_NAME: बनाए जाने वाले फ़ोल्डर का नाम.
किसी फ़ोल्डर में फ़ाइल बनाना
किसी फ़ोल्डर में फ़ाइल बनाने के लिए, files.create() तरीके का इस्तेमाल करें. साथ ही, फ़ाइल की parents प्रॉपर्टी में फ़ोल्डर आईडी डालें.
parents प्रॉपर्टी में, उस पैरंट फ़ोल्डर का आईडी होता है जिसमें फ़ाइल मौजूद है.
parents प्रॉपर्टी का इस्तेमाल, टॉप-लेवल फ़ोल्डर या किसी अन्य फ़ोल्डर में फ़ाइलें बनाते समय किया जा सकता है.
किसी फ़ाइल का सिर्फ़ एक पैरंट फ़ोल्डर हो सकता है. एक से ज़्यादा पैरंट इकाइयों के बारे में जानकारी देने की सुविधा उपलब्ध नहीं है. अगर parents फ़ील्ड के बारे में जानकारी नहीं दी गई है, तो फ़ाइल को सीधे तौर पर उपयोगकर्ता के मेरी ड्राइव फ़ोल्डर में रखा जाता है.
यहां दिए गए कोड सैंपल में, क्लाइंट लाइब्रेरी का इस्तेमाल करके किसी फ़ोल्डर में फ़ाइल बनाने का तरीका बताया गया है:
Java
Python
Node.js
PHP
.NET
curl
curl -X POST 'https://www.googleapis.com/drive/v3/files' \
-H 'Authorization: Bearer ACCESS_TOKEN' \
-H 'Content-Type: application/json' \
-d '{
"name": "photo.jpg",
"parents": [
"FOLDER_ID"
]
}'
इनकी जगह ये डालें:
- ACCESS_TOKEN: आपके ऐप्लिकेशन का OAuth 2.0 टोकन.
- FOLDER_ID: फ़ाइल बनाने के लिए फ़ोल्डर का आईडी.
फ़ोल्डर के बीच फ़ाइलें ले जाना
फ़ाइलें ट्रांसफ़र करने के लिए, आपको parents प्रॉपर्टी का आईडी अपडेट करना होगा.
किसी मौजूदा फ़ाइल के लिए माता-पिता को जोड़ने या हटाने के लिए, addParents और removeParents क्वेरी पैरामीटर के साथ files.update() तरीके का इस्तेमाल करें.
किसी फ़ाइल का सिर्फ़ एक पैरंट फ़ोल्डर हो सकता है. एक से ज़्यादा पैरंट इकाइयों के बारे में जानकारी देने की सुविधा उपलब्ध नहीं है.
लेख पढ़ेंयहां दिए गए कोड सैंपल में, क्लाइंट लाइब्रेरी का इस्तेमाल करके किसी फ़ाइल को एक फ़ोल्डर से दूसरे फ़ोल्डर में ले जाने का तरीका बताया गया है:
Java
Python
Node.js
PHP
.NET
curl
curl -X PATCH 'https://www.googleapis.com/drive/v3/files/FILE_ID?addParents=NEW_PARENT_ID&removeParents=PREVIOUS_PARENT_ID' \
-H 'Authorization: Bearer ACCESS_TOKEN' \
-H 'Accept: application/json'
इनकी जगह ये डालें:
- FILE_ID: उस फ़ाइल का आईडी जिसे दूसरी जगह ले जाना है.
- NEW_PARENT_ID: फ़ाइल को जिस फ़ोल्डर में ले जाना है उसका आईडी.
- PREVIOUS_PARENT_ID: कॉमा से अलग की गई उन पैरंट फ़ोल्डर की सूची जिनसे फ़ाइल को हटाना है.
- ACCESS_TOKEN: आपके ऐप्लिकेशन का OAuth 2.0 टोकन.
फ़ाइल और फ़ोल्डर की सीमाएं
Drive में मौजूद फ़ाइलों और फ़ोल्डर के लिए, स्टोरेज की कुछ सीमाएं तय की गई हैं.
उपयोगकर्ता-आइटम की सीमा
हर उपयोगकर्ता के पास, उस खाते से बनाए गए 50 करोड़ आइटम हो सकते हैं. सीमा पूरी हो जाने पर, उपयोगकर्ता Drive में आइटम नहीं बना सकता या अपलोड नहीं कर सकता. हालांकि, वे अब भी मौजूदा आइटम देख सकते हैं और उनमें बदलाव कर सकते हैं. फ़ाइलें फिर से बनाने के लिए, उपयोगकर्ताओं को आइटम हमेशा के लिए मिटाने होंगे या किसी दूसरे खाते का इस्तेमाल करना होगा. ज़्यादा जानकारी के लिए, फ़ाइलों और फ़ोल्डर को ट्रैश में ले जाना या मिटाना लेख पढ़ें.
इस सीमा में शामिल होने वाली चीज़ें ये हैं:
- Drive में उपयोगकर्ता की बनाई या अपलोड की गई फ़ाइलें
- ऐसे आइटम जिन्हें उपयोगकर्ता ने बनाया था, लेकिन अब उनका मालिकाना हक किसी और के पास है
- ट्रैश में मौजूद आइटम
- शॉर्टकट
- तीसरे पक्ष के शॉर्टकट
इस सीमा में इन ऑब्जेक्ट को नहीं गिना जाता:
- हमेशा के लिए मिटाए गए आइटम
- ऐसे आइटम जो उपयोगकर्ता के साथ शेयर किए गए हैं, लेकिन उनका मालिकाना हक किसी और के पास है
- ऐसे आइटम जिनका मालिकाना हक उपयोगकर्ता के पास है, लेकिन उन्हें किसी और ने बनाया है
50 करोड़ से ज़्यादा आइटम जोड़ने की कोशिश करने पर, activeItemCreationLimitExceeded एचटीटीपी स्टेटस कोड वाला जवाब मिलता है.
ध्यान दें कि सेवा खातों के पास किसी भी फ़ाइल का मालिकाना हक नहीं हो सकता. इसके बजाय, उन्हें शेयर की गई ड्राइव में फ़ाइलें और फ़ोल्डर अपलोड करने होंगे. इसके अलावा, वे किसी व्यक्ति की ओर से आइटम अपलोड करने के लिए, OAuth 2.0 का इस्तेमाल कर सकते हैं.
फ़ोल्डर में मौजूद आइटम की सीमा
किसी उपयोगकर्ता की 'मेरी ड्राइव' में मौजूद हर फ़ोल्डर में, ज़्यादा से ज़्यादा 5,00,000 आइटम हो सकते हैं. यह सीमा, 'मेरी ड्राइव' के रूट फ़ोल्डर पर लागू नहीं होती. इस सीमा में शामिल किए जाने वाले आइटम ये हैं:
- फ़ोल्डर
- फ़ाइलें. सभी फ़ाइल टाइप, भले ही फ़ाइल का मालिकाना हक किसी के पास हो.
- शॉर्टकट पर टैप करें। इसे फ़ोल्डर में मौजूद एक आइटम के तौर पर गिना जाता है. भले ही, यह जिस आइटम की ओर इशारा करता है वह उस फ़ोल्डर में मौजूद न हो. ज़्यादा जानकारी के लिए, Drive में मौजूद किसी फ़ाइल का शॉर्टकट बनाना लेख पढ़ें.
- तीसरे पक्ष के शॉर्टकट. इसे फ़ोल्डर में मौजूद एक आइटम के तौर पर गिना जाता है. भले ही, यह जिस आइटम की ओर इशारा करता है वह उस फ़ोल्डर में न हो. ज़्यादा जानकारी के लिए, अपने ऐप्लिकेशन में सेव किए गए कॉन्टेंट का शॉर्टकट बनाने वाली फ़ाइल बनाना लेख पढ़ें.
फ़ोल्डर की सीमाओं के बारे में ज़्यादा जानने के लिए, Google Drive में फ़ोल्डर की सीमाएं लेख पढ़ें.
फ़ोल्डर की डेप्थ की सीमा
किसी उपयोगकर्ता की'मेरी ड्राइव' में, नेस्ट किए गए 100 से ज़्यादा फ़ोल्डर नहीं हो सकते. इसका मतलब है कि किसी चाइल्ड फ़ोल्डर को ऐसे फ़ोल्डर में सेव नहीं किया जा सकता जो 99 लेवल से ज़्यादा डीप हो. यह पाबंदी सिर्फ़ चाइल्ड फ़ोल्डर पर लागू होती है. application/vnd.google-apps.folder के अलावा किसी अन्य एमआईएमई टाइप वाली चाइल्ड फ़ाइल पर यह पाबंदी लागू नहीं होती.
उदाहरण के लिए, इस डायग्राम में एक नया फ़ोल्डर, फ़ोल्डर नंबर 99 के अंदर नेस्ट किया जा सकता है. हालांकि, इसे फ़ोल्डर नंबर 100 के अंदर नेस्ट नहीं किया जा सकता. हालांकि, 100वें फ़ोल्डर में अन्य Drive फ़ोल्डर की तरह ही फ़ाइलें सेव की जा सकती हैं:
100 से ज़्यादा लेवल के फ़ोल्डर जोड़ने की कोशिश करने पर, myDriveHierarchyDepthLimitExceeded एचटीटीपी स्टेटस कोड रिस्पॉन्स मिलता है.
मिलते-जुलते विषय
- फ़ाइलें बनाना और उन्हें मैनेज करना
- फ़ाइल का मेटाडेटा मैनेज करना
- शेयर की गई ड्राइव में फ़ाइल और फ़ोल्डर की सीमाएं