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

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

इस गाइड में, files और changes संसाधनों में, शेयर की गई ड्राइव के लिए एपीआई में होने वाले अंतर के बारे में बताया गया है.

फ़ाइल रिसॉर्स

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

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

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

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

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

  • sharedWithMeDate
  • sharingUser

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

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

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

संसाधन बदलना

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

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

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