शेयर की गई ड्राइव और 'मेरी ड्राइव' एपीआई में अंतर

शेयर की गई ड्राइव, 'मेरी ड्राइव' से अलग संगठन, शेयर करने, और मालिकाना हक के मॉडल का इस्तेमाल करती हैं. इसलिए, 'मेरी ड्राइव' में मौजूद कुछ कार्रवाइयों को 'शेयर की गई ड्राइव' में मौजूद कॉन्टेंट पर लागू नहीं किया जा सकता. इस दस्तावेज़ में, शेयर की गई ड्राइव के लिए एपीआई के अंतर के बारे में बताया गया है.

Files संसाधन

यहां दिए गए फ़ील्ड, सिर्फ़ शेयर की गई ड्राइव में मौजूद फ़ाइलों के लिए जानकारी से भरते हैं:

  • hasAugmentedPermissions — क्या किसी उपयोगकर्ता को सीधे इस फ़ाइल का ऐक्सेस दिया गया है.
  • capabilities/canAddFolderFromAnotherDrive — क्या मौजूदा उपयोगकर्ता, किसी दूसरे ड्राइव (शेयर की गई किसी दूसरी ड्राइव या 'मेरी ड्राइव') से इस फ़ोल्डर में कोई फ़ोल्डर जोड़ सकता है.
  • capabilities/canDeleteChildren — क्या मौजूदा उपयोगकर्ता, इस फ़ोल्डर के चाइल्ड फ़ोल्डर मिटा सकता है.
  • capabilities/canMoveChildrenOutOfDrive — क्या मौजूदा उपयोगकर्ता, इस फ़ोल्डर के चाइल्ड फ़ोल्डर (सब-फ़ोल्डर) को 'शेयर की गई ड्राइव' से बाहर ले जा सकता है.
  • capabilities/canMoveChildrenWithinDrive — क्या मौजूदा उपयोगकर्ता, इस फ़ोल्डर के चाइल्ड फ़ोल्डर को शेयर की गई ड्राइव में ले जा सकता है.
  • capabilities/canMoveItemWithinDrive — क्या मौजूदा उपयोगकर्ता, शेयर की गई ड्राइव में मौजूद इस आइटम को शेयर की गई ड्राइव में कहीं और ले जा सकता है.
  • capabilities/canReadDrive — क्या मौजूदा उपयोगकर्ता के पास उस शेयर की गई ड्राइव का रीड ऐक्सेस है जिसमें यह फ़ाइल मौजूद है.
  • capabilities/canTrashChildren — मौजूदा उपयोगकर्ता, इस फ़ोल्डर के चाइल्ड फ़ोल्डर को ट्रैश में डाल सकता है या नहीं.
  • driveId — उस शेयर की गई ड्राइव का आईडी जिसमें फ़ाइल मौजूद है.
  • trashingUser — अगर फ़ाइल को साफ़ तौर पर ट्रैश में डाला गया है, तो वह उपयोगकर्ता जिसने उसे ट्रैश में डाला है.
  • trashedTime — आइटम को ट्रैश में डालने का समय.

शेयर की गई ड्राइव में मौजूद फ़ाइलों के लिए, इन फ़ील्ड में जानकारी अपने-आप नहीं भरती:

  • permissions — शेयर की गई ड्राइव के एसीएल के संभावित साइज़ की वजह से, अनुमतियां फ़ाइलों के हिस्से के तौर पर नहीं दी जाती हैं. शेयर की गई ड्राइव में मौजूद किसी फ़ाइल या शेयर की गई ड्राइव के लिए अनुमतियों की सूची बनाने के लिए, permissions.list तरीके का इस्तेमाल करें. यह तरीका पेजेशन के साथ काम करता है.
  • owners, ownerNames, ownedByMe — शेयर की गई ड्राइव में मौजूद फ़ाइलों का मालिकाना हक, शेयर की गई ड्राइव के पास होता है, न कि किसी व्यक्ति के पास.
  • folderColorRgb — फ़ोल्डर को अलग-अलग रंग नहीं दिया जा सकता
  • shared — शेयर की गई ड्राइव में मौजूद सभी आइटम शेयर किए जाते हैं.
  • writersCanShare — फ़िलहाल, शेयर की गई ड्राइव में भूमिका के हिसाब से, शेयर करने पर पाबंदी नहीं लगाई जा सकती.

ये फ़ील्ड सिर्फ़ तब सेट होते हैं, जब उपयोगकर्ता को किसी आइटम पर फ़ाइल ऐक्सेस करने की अनुमतियां दी गई हों:

  • sharedWithMeDate
  • sharingUser

शेयर की गई ड्राइव के साथ इन फ़ील्ड का इस्तेमाल करते समय, इन पर खास ध्यान देने की ज़रूरत है:

  • parents.isRoot — यह फ़ील्ड सिर्फ़ 'मेरी ड्राइव' के रूट फ़ोल्डर के लिए सही है. यह शेयर की गई ड्राइव के टॉप-लेवल फ़ोल्डर के लिए गलत है.
  • parents — अगर अनुरोध करने वाला उपयोगकर्ता, शेयर की गई ड्राइव का सदस्य नहीं है और उसके पास माता-पिता के खाते का ऐक्सेस नहीं है, तो माता-पिता की सूची में माता-पिता का नाम नहीं दिखता. इसके अलावा, अगर फ़ाइल किसी शेयर की गई ड्राइव में मौजूद है, तो टॉप लेवल फ़ोल्डर को छोड़कर, पैरंट की सूची में सिर्फ़ एक आइटम होना चाहिए.

  • capabilities/canRemoveChildrencapabilities/canDeleteChildren या capabilities/canTrashChildren का इस्तेमाल करें.

Permissions संसाधन

permissionDetails फ़ील्ड में सिर्फ़ शेयर की गई ड्राइव में मौजूद फ़ाइलों की जानकारी अपने-आप भर जाती है. यह फ़ील्ड, छोटी अनुमतियों की सूची है. ये अनुमतियां, शेयर की गई ड्राइव की इस फ़ाइल पर लागू होती हैं या इनका इनहेरिट किया जाता है. यह फ़ील्ड सिर्फ़ आउटपुट के लिए होता है और यह सिर्फ़ शेयर की गई ड्राइव के आइटम के लिए मौजूद होता है. इसके अलावा,

  • organizer और fileOrganizer की दो नई भूमिकाएं तय की गई हैं.
  • permissions.list अब पेजेशन की सुविधा के साथ काम करता है.

Changes संसाधन

शेयर किए गए ड्राइव के लिए, Changes संसाधन में ये नए फ़ील्ड उपलब्ध हैं:

  • changeType — बदलाव का टाइप. संभावित वैल्यू file और drive हैं.
  • driveId — इस बदलाव से जुड़ी शेयर की गई ड्राइव का आईडी.
  • drive — शेयर की गई ड्राइव की अपडेट की गई स्थिति. यह तब दिखता है, जब changeType drive हो और उपयोगकर्ता अब भी शेयर की गई ड्राइव का सदस्य हो.

जिन ऐप्लिकेशन को शेयर की गई ड्राइव के साथ कॉन्टेंट सिंक करना है या गतिविधि को ट्रैक करना है उनके लिए, कुछ और बदलाव करने पड़ सकते हैं. ज़्यादा जानकारी के लिए, उपयोगकर्ताओं और शेयर की गई ड्राइव के लिए बदलावों को ट्रैक करना लेख पढ़ें.