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
  },
  "createdTime": 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.create के अनुरोध पर कोई थीम न होने पर, बिना किसी क्रम वाली थीम चुनी जाती है जिससे बैकग्राउंड की इमेज और रंग सेट किए जाते हैं. इस फ़ील्ड में सिर्फ़ लिखा जा सकता है. इसे सिर्फ़ उन अनुरोधों पर सेट किया जा सकता है जिन पर 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 पिक्सल ऊंची होनी चाहिए.
createdTime

string

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

boolean

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

object

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

string

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

तरीके

create

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

delete

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

get

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

hide

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

list

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

unhide

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

update

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