शेयर की गई ड्राइव, संगठन, शेयर करने, और मालिकाना हक के अलग-अलग मॉडल का पालन करती हैं. ये मॉडल, मेरी ड्राइव से अलग होते हैं. इसलिए, 'मेरी ड्राइव' में मौजूद कॉन्टेंट के लिए कुछ कार्रवाइयां, शेयर की गई ड्राइव में मौजूद कॉन्टेंट के लिए नहीं की जा सकतीं. इस दस्तावेज़ में, शेयर की गई ड्राइव के लिए एपीआई में होने वाले अंतर के बारे में बताया गया है.
फ़ाइल रिसॉर्स
File संसाधन में मौजूद ये फ़ील्ड, सिर्फ़ शेयर की गई ड्राइव में मौजूद फ़ाइलों के लिए भरे जाते हैं:
hasAugmentedPermissions: इस फ़ाइल पर किसी उपयोगकर्ता को सीधे तौर पर फ़ाइल का ऐक्सेस दिया गया है या नहीं.capabilities/canAddFolderFromAnotherDrive: इससे पता चलता है कि मौजूदा उपयोगकर्ता, किसी दूसरे ड्राइव (शेयर की गई कोई दूसरी ड्राइव या मेरी ड्राइव) से कोई फ़ोल्डर इस फ़ोल्डर में जोड़ सकता है या नहीं.capabilities/canDeleteChildren: मौजूदा उपयोगकर्ता इस फ़ोल्डर के चाइल्ड आइटम मिटा सकता है या नहीं.capabilities/canMoveChildrenOutOfDrive: मौजूदा उपयोगकर्ता इस फ़ोल्डर के चाइल्ड फ़ोल्डर को शेयर की गई ड्राइव से बाहर ले जा सकता है या नहीं.capabilities/canMoveChildrenWithinDrive: इससे पता चलता है कि मौजूदा उपयोगकर्ता, शेयर की गई ड्राइव में इस फ़ोल्डर के चाइल्ड आइटम को मूव कर सकता है या नहीं.capabilities/canMoveItemWithinDrive: इससे पता चलता है कि मौजूदा उपयोगकर्ता, शेयर की गई ड्राइव के इस आइटम को शेयर की गई ड्राइव में ले जा सकता है या नहीं.capabilities/canReadDrive: इससे पता चलता है कि मौजूदा उपयोगकर्ता के पास, उस शेयर किए गए ड्राइव को पढ़ने का ऐक्सेस है या नहीं जिसमें यह फ़ाइल मौजूद है.capabilities/canTrashChildren: मौजूदा उपयोगकर्ता इस फ़ोल्डर के चाइल्ड आइटम को ट्रैश कर सकता है या नहीं.driveId: शेयर की गई उस ड्राइव का आईडी जिसमें फ़ाइल मौजूद है.trashingUser: अगर फ़ाइल को ट्रैश किया गया है, तो उसे ट्रैश करने वाले उपयोगकर्ता का नाम.trashedTime: आइटम को ट्रैश में डालने का समय. अगर Drive API v2 का इस्तेमाल किया जा रहा है, तो इस फ़ील्ड कोtrashedDateकहा जाता है.
शेयर की गई ड्राइव में मौजूद फ़ाइलों के लिए, इन फ़ील्ड में जानकारी नहीं भरी जाती:
permissions: शेयर की गई ड्राइव के ACL का साइज़ बड़ा हो सकता है. इसलिए, अनुमतियां फ़ाइलों के हिस्से के तौर पर नहीं दिखाई जाती हैं. शेयर की गई ड्राइव या शेयर की गई ड्राइव के फ़ोल्डर में मौजूद किसी फ़ाइल के लिए अनुमतियों की सूची बनाने के लिए,permissions.list()तरीके का इस्तेमाल करें. इसमें पेज नंबर डालने की सुविधा होती है.owners,ownerNames,ownedByMe: शेयर किए गए ड्राइव में मौजूद फ़ाइलों का मालिकाना हक, शेयर किए गए ड्राइव के पास होता है, न कि किसी व्यक्ति के पास.folderColorRgb: फ़ोल्डर को अलग-अलग रंग नहीं दिया जा सकता.shared: शेयर की गई ड्राइव में मौजूद सभी आइटम शेयर किए जाते हैं.writersCanShare: शेयर की गई ड्राइव में, भूमिका के हिसाब से शेयर करने पर पाबंदी नहीं लगाई जा सकती.
ये फ़ील्ड सिर्फ़ तब सेट किए जाते हैं, जब उपयोगकर्ता को किसी आइटम पर फ़ाइल ऐक्सेस करने की अनुमतियां दी गई हों:
sharedWithMeDatesharingUser
शेयर की गई ड्राइव के साथ इन फ़ील्ड का इस्तेमाल करते समय, खास ध्यान रखना ज़रूरी है:
parents.isRoot: यह फ़ील्ड सिर्फ़ 'मेरी ड्राइव' के रूट फ़ोल्डर के लिए सही है. शेयर की गई ड्राइव के टॉप-लेवल फ़ोल्डर के लिए यह गलत है.parents: अगर अनुरोध करने वाला व्यक्ति, शेयर की गई ड्राइव का सदस्य नहीं है और उसके पास माता-पिता के खाते का ऐक्सेस नहीं है, तो माता-पिता का नाम माता-पिता की सूची में नहीं दिखेगा. इसके अलावा, अगर फ़ाइल किसी शेयर की गई ड्राइव में मौजूद है, तो पैरंट फ़ोल्डर की सूची में सिर्फ़ एक आइटम होना चाहिए. हालांकि, टॉप लेवल फ़ोल्डर के लिए यह ज़रूरी नहीं है.capabilities/canRemoveChildren:capabilities/canDeleteChildrenयाcapabilities/canTrashChildrenका इस्तेमाल करें.
अनुमति संसाधन
Permission संसाधन में मौजूद permissionDetails फ़ील्ड सिर्फ़ शेयर की गई ड्राइव में मौजूद फ़ाइलों के लिए भरा जाता है. इस फ़ील्ड में, शेयर की गई ड्राइव की फ़ाइल के लिए सेट की गई अनुमतियों की सूची होती है. ये अनुमतियां, फ़ाइल के लिए सेट की गई हैं या फ़ाइल को इनहेरिट की गई हैं. यह फ़ील्ड, सिर्फ़ आउटपुट वाला फ़ील्ड है. यह सिर्फ़ शेयर की गई ड्राइव के आइटम के लिए मौजूद होता है. इसके अलावा,
organizerऔरfileOrganizerकी दो नई भूमिकाएं तय की गई हैं.permissions.list()तरीके में पेज नंबर डालने की सुविधा काम करती है.
संसाधन बदलना
शेयर की गई ड्राइव के लिए, Change संसाधन में ये नए फ़ील्ड उपलब्ध हैं:
changeType: बदलाव का टाइप.fileऔरdriveको वैल्यू के तौर पर इस्तेमाल किया जा सकता है.driveId: इस बदलाव से जुड़ी शेयर की गई ड्राइव का आईडी.drive: शेयर की गई ड्राइव की अपडेट की गई स्थिति. यह तब मौजूद होता है, जबchangeTypedriveहो और उपयोगकर्ता अब भी शेयर की गई ड्राइव का सदस्य हो.
जिन ऐप्लिकेशन को शेयर की गई ड्राइव के साथ कॉन्टेंट सिंक करना होता है या गतिविधि को ट्रैक करना होता है उनके लिए, अतिरिक्त बदलाव करने पड़ सकते हैं. ज़्यादा जानकारी के लिए, उपयोगकर्ताओं और शेयर की गई ड्राइव के लिए बदलावों को ट्रैक करना लेख पढ़ें.