शेयर की गई ड्राइव, संगठन, शेयर करने, और मालिकाना हक के अलग-अलग मॉडल का इस्तेमाल करती हैं. इसलिए, 'मेरी ड्राइव' में मौजूद कुछ कार्रवाइयों को, शेयर की गई ड्राइव में मौजूद कॉन्टेंट के लिए अनुमति नहीं है. इस दस्तावेज़ में, शेयर की गई ड्राइव के हिसाब से एपीआई के अंतर के बारे में बताया गया है.
फ़ाइल रिसॉर्स
File संसाधन के इन फ़ील्ड में जानकारी, सिर्फ़ शेयर की गई ड्राइव में मौजूद फ़ाइलों के लिए भरी जाती है:
hasAugmentedPermissions: क्या किसी उपयोगकर्ता को सीधे इस फ़ाइल का ऐक्सेस दिया गया है.capabilities/canAddFolderFromAnotherDrive: क्या मौजूदा उपयोगकर्ता, किसी अन्य ड्राइव (किसी अन्य शेयर की गई ड्राइव या 'मेरी ड्राइव') से इस फ़ोल्डर में कोई फ़ोल्डर जोड़ सकता है.capabilities/canDeleteChildren: क्या मौजूदा उपयोगकर्ता, इस फ़ोल्डर के चाइल्ड फ़ोल्डर मिटा सकता है.capabilities/canMoveChildrenOutOfDrive: क्या मौजूदा उपयोगकर्ता, इस फ़ोल्डर के चाइल्ड फ़ोल्डर को 'शेयर की गई ड्राइव' से बाहर ले जा सकता है.capabilities/canMoveChildrenWithinDrive: क्या मौजूदा उपयोगकर्ता, इस फ़ोल्डर के चाइल्ड फ़ोल्डर को 'शेयर की गई ड्राइव' में ले जा सकता है.capabilities/canMoveItemWithinDrive: क्या मौजूदा उपयोगकर्ता, शेयर की गई ड्राइव में मौजूद इस आइटम को शेयर की गई ड्राइव में ले जा सकता है.capabilities/canReadDrive: क्या मौजूदा उपयोगकर्ता के पास उस शेयर किए गए ड्राइव का ऐक्सेस है जिसमें यह फ़ाइल मौजूद है.capabilities/canTrashChildren: क्या मौजूदा उपयोगकर्ता, इस फ़ोल्डर के बच्चों को ट्रैश में डाल सकता है.driveId: शेयर की गई उस ड्राइव का आईडी जहां फ़ाइल मौजूद है.trashingUser: अगर फ़ाइल को साफ़ तौर पर ट्रैश में डाला गया है, तो वह उपयोगकर्ता जिसने उसे ट्रैश में डाला है.trashedTime: आइटम को ट्रैश में डालने का समय. अगर Drive API के पुराने वर्शन का इस्तेमाल किया जा रहा है, तो इस फ़ील्ड कोtrashedDateकहा जाता है.
शेयर की गई ड्राइव में मौजूद फ़ाइलों के लिए, इन फ़ील्ड में जानकारी अपने-आप नहीं भरती:
permissions: शेयर की गई ड्राइव के ACLs के संभावित साइज़ की वजह से, अनुमतियां फ़ाइलों के हिस्से के तौर पर नहीं दी जाती हैं. शेयर की गई ड्राइव या शेयर की गई ड्राइव के फ़ोल्डर में मौजूद किसी फ़ाइल के लिए अनुमतियों की सूची बनाने के लिए,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हो और उपयोगकर्ता अब भी शेयर की गई ड्राइव का सदस्य हो.
जिन ऐप्लिकेशन को शेयर की गई ड्राइव के साथ कॉन्टेंट सिंक करना है या गतिविधि को ट्रैक करना है उनके लिए, कुछ और बदलाव करने पड़ सकते हैं. ज़्यादा जानकारी के लिए, उपयोगकर्ताओं और शेयर की गई ड्राइव के लिए बदलावों को ट्रैक करना लेख पढ़ें.