REST Resource: drives

संसाधन: Drive

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

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

जेएसओएन के काेड में दिखाना 
{
  "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

उस थीम का आईडी जिससे बैकग्राउंड की इमेज और रंग सेट किया जाएगा. संभावित driveThemes के सेट को drive.about.get रिस्पॉन्स से फिर से पाया जा सकता है. अगर 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

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

boolean

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

object

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

boolean

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

boolean

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

boolean

इस 'शेयर की गई ड्राइव' में मौजूद आइटम का ऐक्सेस, इसके सदस्यों के पास है या नहीं.
restrictions.adminManagedRestrictions

boolean

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

boolean

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

string

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

तरीके

delete

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

get

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

hide

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

insert

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

list

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

unhide

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

update

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