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,
    "canChangeDownloadRestriction": 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,
    "downloadRestriction": {
      object (DownloadRestriction)
    }
  },
  "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

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

capabilities.canChangeDownloadRestriction

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

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

hidden

boolean

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

restrictions

object

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

restrictions.copyRequiresWriterPermission

boolean

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

restrictions.domainUsersOnly

boolean

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

restrictions.driveMembersOnly

boolean

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

restrictions.adminManagedRestrictions

boolean

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

restrictions.sharingFoldersRequiresOrganizerPermission

boolean

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

restrictions.downloadRestriction

object (DownloadRestriction)

शेयर की गई ड्राइव के मैनेजर की ओर से, डाउनलोड करने से जुड़ी पाबंदियां लागू की गई हैं.

orgUnitId

string

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

तरीके

create

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

delete

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

get

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

hide

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

list

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

unhide

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

update

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