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
  },
  "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

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

तरीके

create

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

delete

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

get

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

hide

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

list

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

unhide

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

update

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