REST Resource: drives

संसाधन: Drive

शेयर की गई ड्राइव की इमेज.

drives.update जैसे कुछ संसाधन के तरीकों के लिए, driveId की ज़रूरत होती है. शेयर की गई ड्राइव का आईडी पाने के लिए, drives.list तरीके का इस्तेमाल करें.

JSON के काेड में दिखाना 
{
  "id": string,
  "name": string,
  "colorRgb": string,
  "kind": string,
  "backgroundImageLink": string,
  "capabilities": {
    "canAddChildren": boolean,
    "canComment": boolean,
    "canCopy": boolean,
    "canDeleteDrive": boolean,
    "canDownload": boolean,
    "canEdit": boolean,
    "canListChildren": boolean,
    "canManageMembers": boolean,
    "canReadRevisions": boolean,
    "canRename": boolean,
    "canRenameDrive": boolean,
    "canChangeDriveBackground": boolean,
    "canShare": boolean,
    "canChangeCopyRequiresWriterPermissionRestriction": boolean,
    "canChangeDomainUsersOnlyRestriction": boolean,
    "canChangeDriveMembersOnlyRestriction": boolean,
    "canChangeSharingFoldersRequiresOrganizerPermissionRestriction": boolean,
    "canResetDriveRestrictions": boolean,
    "canDeleteChildren": boolean,
    "canTrashChildren": boolean
  },
  "themeId": string,
  "backgroundImageFile": {
    "id": string,
    "xCoordinate": number,
    "yCoordinate": number,
    "width": number
  },
  "createdDate": string,
  "hidden": boolean,
  "restrictions": {
    "copyRequiresWriterPermission": boolean,
    "domainUsersOnly": boolean,
    "driveMembersOnly": boolean,
    "adminManagedRestrictions": boolean,
    "sharingFoldersRequiresOrganizerPermission": boolean
  },
  "orgUnitId": string
}
फ़ील्ड
id

string

सिर्फ़ आउटपुट के लिए. इस शेयर की गई ड्राइव का आईडी, जो इस शेयर की गई ड्राइव के टॉप लेवल फ़ोल्डर का भी आईडी है.
name

string

शेयर की गई इस ड्राइव का नाम.
colorRgb

string

शेयर की गई इस ड्राइव का रंग, आरजीबी हेक्स स्ट्रिंग के तौर पर. इसे सिर्फ़ उस drive.drives.update अनुरोध पर सेट किया जा सकता है जिसमें themeId सेट नहीं किया गया है.
kind

string

सिर्फ़ आउटपुट के लिए. यह हमेशा drive#drive होता है
capabilities

object

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

boolean

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

boolean

सिर्फ़ आउटपुट के लिए. मौजूदा उपयोगकर्ता, शेयर की गई इस ड्राइव की फ़ाइलों पर टिप्पणी कर सकता है या नहीं.
capabilities.canCopy

boolean

सिर्फ़ आउटपुट के लिए. मौजूदा उपयोगकर्ता, इस शेयर की गई ड्राइव में मौजूद फ़ाइलों को कॉपी कर सकता है या नहीं.
capabilities.canDeleteDrive

boolean

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

boolean

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

boolean

सिर्फ़ आउटपुट के लिए. मौजूदा उपयोगकर्ता के पास, इस शेयर की गई ड्राइव में मौजूद फ़ाइलों में बदलाव करने का ऐक्सेस है या नहीं
capabilities.canListChildren

boolean

सिर्फ़ आउटपुट के लिए. मौजूदा उपयोगकर्ता, इस शेयर की गई ड्राइव में फ़ोल्डर के चाइल्ड फ़ोल्डर (सब-फ़ोल्डर) की सूची बना सकता है या नहीं.
capabilities.canManageMembers

boolean

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

boolean

सिर्फ़ आउटपुट के लिए. मौजूदा उपयोगकर्ता, शेयर की गई इस ड्राइव में मौजूद फ़ाइलों के बदलावों का संसाधन पढ़ सकता है या नहीं.
capabilities.canRename

boolean

सिर्फ़ आउटपुट के लिए. मौजूदा उपयोगकर्ता, इस शेयर की गई ड्राइव में फ़ाइलों या फ़ोल्डर का नाम बदल सकता है या नहीं.
capabilities.canRenameDrive

boolean

सिर्फ़ आउटपुट के लिए. मौजूदा उपयोगकर्ता, शेयर की गई इस ड्राइव का नाम बदल सकता है या नहीं.
capabilities.canChangeDriveBackground

boolean

सिर्फ़ आउटपुट के लिए. मौजूदा उपयोगकर्ता, शेयर की गई इस ड्राइव का बैकग्राउंड बदल सकता है या नहीं.
capabilities.canShare

boolean

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

boolean

सिर्फ़ आउटपुट के लिए. मौजूदा उपयोगकर्ता, शेयर की गई इस ड्राइव की copyRequiresWriterPermission पाबंदी को बदल सकता है या नहीं.
capabilities.canChangeDomainUsersOnlyRestriction

boolean

सिर्फ़ आउटपुट के लिए. मौजूदा उपयोगकर्ता, शेयर की गई इस ड्राइव की domainUsersOnly पाबंदी को बदल सकता है या नहीं.
capabilities.canChangeDriveMembersOnlyRestriction

boolean

सिर्फ़ आउटपुट के लिए. मौजूदा उपयोगकर्ता, शेयर की गई इस ड्राइव की driveMembersOnly पाबंदी को बदल सकता है या नहीं.
capabilities.canChangeSharingFoldersRequiresOrganizerPermissionRestriction

boolean

सिर्फ़ आउटपुट के लिए. मौजूदा उपयोगकर्ता, शेयर की गई इस ड्राइव की sharingFoldersRequiresOrganizerPermission पाबंदी को बदल सकता है या नहीं.
capabilities.canResetDriveRestrictions

boolean

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

boolean

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

boolean

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

string

उस थीम का आईडी जिससे बैकग्राउंड इमेज और रंग सेट किया जाएगा. drive.about.get जवाब से, संभावित driveThemes का सेट वापस पाया जा सकता है. अगर drive.drives.insert अनुरोध में कोई थीम नहीं चुनी जाती है, तो कोई भी थीम चुनी जाती है. इस थीम से बैकग्राउंड इमेज और रंग सेट किया जाता है. यह सिर्फ़ रीड-ओनली फ़ील्ड है. इसे सिर्फ़ उन अनुरोधों पर सेट किया जा सकता है जिनमें colorRgb या backgroundImageFile सेट नहीं किया गया है.
backgroundImageFile

object

इमेज फ़ाइल और काट-छांट करने के पैरामीटर, जिनसे इस शेयर की गई ड्राइव के लिए बैकग्राउंड इमेज सेट की जाती है. यह सिर्फ़ लिखने के लिए है. इसे सिर्फ़ उन drive.drives.update अनुरोधों पर सेट किया जा सकता है जो themeId सेट नहीं करते. अगर backgroundImageFile की वैल्यू दी गई है, तो इसके सभी फ़ील्ड सेट होने चाहिए.
backgroundImageFile.id

string

Google Drive में मौजूद इमेज फ़ाइल का आईडी, जिसका इस्तेमाल बैकग्राउंड इमेज के तौर पर किया जाएगा.
backgroundImageFile.xCoordinate

number

बैकग्राउंड इमेज में, काटे जाने वाले हिस्से के ऊपरी बाएं कोने का X निर्देशांक. यह वैल्यू 0 से 1 के बीच होती है. यह वैल्यू, पूरी इमेज की बाईं ओर से काटे गए हिस्से की बाईं ओर की हॉरिज़ॉन्टल दूरी को पूरी इमेज की चौड़ाई से भाग देने पर मिलती है.
backgroundImageFile.yCoordinate

number

बैकग्राउंड इमेज में, काटे जाने वाले हिस्से के ऊपरी बाएं कोने का Y निर्देशांक. यह वैल्यू 0 से 1 के बीच होती है. यह वैल्यू, पूरी इमेज के ऊपरी हिस्से से काटे गए हिस्से के ऊपरी हिस्से तक की वर्टिकल दूरी को पूरी इमेज की ऊंचाई से भाग देने पर मिलती है.
backgroundImageFile.width

number

काटी गई इमेज की चौड़ाई, जो 0 से 1 के बीच होनी चाहिए. इस वैल्यू से पता चलता है कि काटी गई इमेज की चौड़ाई को पूरी इमेज की चौड़ाई से भाग देने पर क्या मिलेगा. ऊंचाई का हिसाब लगाने के लिए, चौड़ाई-ऊंचाई के आसपेक्ट रेशियो को 80:9 पर सेट किया जाता है. इमेज की चौड़ाई कम से कम 1280 पिक्सल और ऊंचाई कम से कम 144 पिक्सल होनी चाहिए.
createdDate

string

सिर्फ़ आउटपुट के लिए. शेयर की गई ड्राइव बनाने का समय (RFC 3339 तारीख-समय).
hidden

boolean

शेयर की गई ड्राइव को डिफ़ॉल्ट व्यू से छिपाया गया है या नहीं.
restrictions

object

पाबंदियों का एक सेट, जो इस शेयर की गई ड्राइव या इस शेयर की गई ड्राइव में मौजूद आइटम पर लागू होता है.
restrictions.copyRequiresWriterPermission

boolean

क्या इस शेयर की गई ड्राइव में मौजूद फ़ाइलों को कॉपी करने, प्रिंट करने या डाउनलोड करने के विकल्प, रीडर और टिप्पणी करने वालों के लिए बंद किए जाने चाहिए. इस पाबंदी को true पर सेट करने पर, इस शेयर की गई ड्राइव में मौजूद किसी भी फ़ाइल के लिए, मिलते-जुलते नाम वाले फ़ील्ड को true पर बदल दिया जाएगा.
restrictions.domainUsersOnly

boolean

इस शेयर की गई ड्राइव और उसमें मौजूद आइटम का ऐक्सेस, उस डोमेन के उपयोगकर्ताओं के लिए ही उपलब्ध है जिससे यह शेयर की गई ड्राइव जुड़ी है. इस पाबंदी को, शेयर की गई इस ड्राइव से बाहर की जाने वाली शेयर करने की अन्य नीतियों से बदला जा सकता है.
restrictions.driveMembersOnly

boolean

इस शेयर की गई ड्राइव में मौजूद आइटम का ऐक्सेस, सिर्फ़ उसके सदस्यों के लिए उपलब्ध है या नहीं.
restrictions.adminManagedRestrictions

boolean

इस शेयर की गई ड्राइव पर, पाबंदियों में बदलाव करने के लिए एडमिन के खास अधिकारों की ज़रूरत है या नहीं.
restrictions.sharingFoldersRequiresOrganizerPermission

boolean

अगर यह सेटिंग चालू है, तो सिर्फ़ व्यवस्थापक की भूमिका वाले उपयोगकर्ता फ़ोल्डर शेयर कर सकते हैं. अगर यह फ़ील्ड 'गलत' पर सेट है, तो फ़ोल्डर शेयर करने की अनुमति, ऑर्गनाइज़र या फ़ाइल ऑर्गनाइज़र की भूमिका वाले उपयोगकर्ताओं के पास होती है.
orgUnitId

string

सिर्फ़ आउटपुट के लिए. इस शेयर की गई ड्राइव की संगठन की इकाई. यह फ़ील्ड सिर्फ़ drives.list जवाबों पर तब पॉप्युलेट होता है, जब useDomainAdminAccess पैरामीटर को true पर सेट किया गया हो.

तरीके

delete

 उस शेयर की गई ड्राइव को हमेशा के लिए मिटा देता है जिसमें उपयोगकर्ता organizer है.

get

 आईडी के हिसाब से, शेयर की गई ड्राइव का मेटाडेटा पाता है.

hide

 शेयर की गई ड्राइव को डिफ़ॉल्ट व्यू से छिपाता है.

insert

 नई 'शेयर की गई ड्राइव' बनाई जाती है.

list

उपयोगकर्ता की शेयर की गई ड्राइव की सूची दिखाता है.

unhide

 शेयर की गई ड्राइव को डिफ़ॉल्ट व्यू पर वापस लाता है.

update

 शेयर की गई ड्राइव का मेटाडेटा अपडेट करता है.