REST Resource: files

संसाधन: फ़ाइल

किसी फ़ाइल का मेटाडेटा.

कुछ संसाधन तरीकों (जैसे कि files.update) के लिए fileId की ज़रूरत होती है. किसी फ़ाइल का आईडी पाने के लिए, files.list तरीके का इस्तेमाल करें.

जेएसओएन के काेड में दिखाना
{
  "kind": string,
  "driveId": string,
  "fileExtension": string,
  "copyRequiresWriterPermission": boolean,
  "md5Checksum": string,
  "contentHints": {
    "indexableText": string,
    "thumbnail": {
      "image": string,
      "mimeType": string
    }
  },
  "writersCanShare": boolean,
  "viewedByMe": boolean,
  "mimeType": string,
  "exportLinks": {
    string: string,
    ...
  },
  "parents": [
    string
  ],
  "thumbnailLink": string,
  "iconLink": string,
  "shared": boolean,
  "lastModifyingUser": {
    object (User)
  },
  "owners": [
    {
      object (User)
    }
  ],
  "headRevisionId": string,
  "sharingUser": {
    object (User)
  },
  "webViewLink": string,
  "webContentLink": string,
  "size": string,
  "viewersCanCopyContent": boolean,
  "permissions": [
    {
      object (Permission)
    }
  ],
  "hasThumbnail": boolean,
  "spaces": [
    string
  ],
  "folderColorRgb": string,
  "id": string,
  "name": string,
  "description": string,
  "starred": boolean,
  "trashed": boolean,
  "explicitlyTrashed": boolean,
  "createdTime": string,
  "modifiedTime": string,
  "modifiedByMeTime": string,
  "viewedByMeTime": string,
  "sharedWithMeTime": string,
  "quotaBytesUsed": string,
  "version": string,
  "originalFilename": string,
  "ownedByMe": boolean,
  "fullFileExtension": string,
  "properties": {
    string: value,
    ...
  },
  "appProperties": {
    string: value,
    ...
  },
  "isAppAuthorized": boolean,
  "teamDriveId": string,
  "capabilities": {
    "canChangeViewersCanCopyContent": boolean,
    "canMoveChildrenOutOfDrive": boolean,
    "canReadDrive": boolean,
    "canEdit": boolean,
    "canCopy": boolean,
    "canComment": boolean,
    "canAddChildren": boolean,
    "canDelete": boolean,
    "canDownload": boolean,
    "canListChildren": boolean,
    "canRemoveChildren": boolean,
    "canRename": boolean,
    "canTrash": boolean,
    "canReadRevisions": boolean,
    "canReadTeamDrive": boolean,
    "canMoveTeamDriveItem": boolean,
    "canChangeCopyRequiresWriterPermission": boolean,
    "canMoveItemIntoTeamDrive": boolean,
    "canUntrash": boolean,
    "canModifyContent": boolean,
    "canMoveItemWithinTeamDrive": boolean,
    "canMoveItemOutOfTeamDrive": boolean,
    "canDeleteChildren": boolean,
    "canMoveChildrenOutOfTeamDrive": boolean,
    "canMoveChildrenWithinTeamDrive": boolean,
    "canTrashChildren": boolean,
    "canMoveItemOutOfDrive": boolean,
    "canAddMyDriveParent": boolean,
    "canRemoveMyDriveParent": boolean,
    "canMoveItemWithinDrive": boolean,
    "canShare": boolean,
    "canMoveChildrenWithinDrive": boolean,
    "canModifyContentRestriction": boolean,
    "canAddFolderFromAnotherDrive": boolean,
    "canChangeSecurityUpdateEnabled": boolean,
    "canAcceptOwnership": boolean,
    "canReadLabels": boolean,
    "canModifyLabels": boolean,
    "canModifyEditorContentRestriction": boolean,
    "canModifyOwnerContentRestriction": boolean,
    "canRemoveContentRestriction": boolean
  },
  "hasAugmentedPermissions": boolean,
  "trashingUser": {
    object (User)
  },
  "thumbnailVersion": string,
  "trashedTime": string,
  "modifiedByMe": boolean,
  "permissionIds": [
    string
  ],
  "imageMediaMetadata": {
    "flashUsed": boolean,
    "meteringMode": string,
    "sensor": string,
    "exposureMode": string,
    "colorSpace": string,
    "whiteBalance": string,
    "width": integer,
    "height": integer,
    "location": {
      "latitude": number,
      "longitude": number,
      "altitude": number
    },
    "rotation": integer,
    "time": string,
    "cameraMake": string,
    "cameraModel": string,
    "exposureTime": number,
    "aperture": number,
    "focalLength": number,
    "isoSpeed": integer,
    "exposureBias": number,
    "maxApertureValue": number,
    "subjectDistance": integer,
    "lens": string
  },
  "videoMediaMetadata": {
    "width": integer,
    "height": integer,
    "durationMillis": string
  },
  "shortcutDetails": {
    "targetId": string,
    "targetMimeType": string,
    "targetResourceKey": string
  },
  "contentRestrictions": [
    {
      object (ContentRestriction)
    }
  ],
  "resourceKey": string,
  "linkShareMetadata": {
    "securityUpdateEligible": boolean,
    "securityUpdateEnabled": boolean
  },
  "labelInfo": {
    "labels": [
      {
        object (Label)
      }
    ]
  },
  "sha1Checksum": string,
  "sha256Checksum": string
}
फ़ील्ड
kind

string

सिर्फ़ आउटपुट के लिए. बताता है कि यह किस तरह का संसाधन है. मान: तय स्ट्रिंग "drive#file".

driveId

string

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

fileExtension

string

सिर्फ़ आउटपुट के लिए. fullFileExtension का फ़ाइनल कॉम्पोनेंट. यह सुविधा, Google Drive में सिर्फ़ बाइनरी कॉन्टेंट वाली फ़ाइलों के लिए उपलब्ध है.

copyRequiresWriterPermission

boolean

यह विकल्प पढ़ने वाले और टिप्पणी करने वाले लोगों के लिए, इस फ़ाइल को कॉपी करने, प्रिंट करने या डाउनलोड करने की सुविधा बंद होनी चाहिए.

md5Checksum

string

सिर्फ़ आउटपुट के लिए. फ़ाइल के कॉन्टेंट के लिए MD5 चेकसम. यह सिर्फ़ Google Drive में बाइनरी कॉन्टेंट वाली फ़ाइलों पर लागू होता है.

contentHints

object

फ़ाइल के कॉन्टेंट के बारे में ज़्यादा जानकारी. इन फ़ील्ड का डेटा, जवाबों में कभी नहीं भरा जाता.

contentHints.indexableText

string

FullText क्वेरी को बेहतर बनाने के लिए फ़ाइल का इंडेक्स किया जाने वाला टेक्स्ट. इसकी लंबाई 128 केबी तक है और इसमें एचटीएमएल एलिमेंट हो सकते हैं.

contentHints.thumbnail

object

फ़ाइल के लिए थंबनेल. इसका इस्तेमाल सिर्फ़ तब किया जाएगा, जब Google Drive स्टैंडर्ड थंबनेल जनरेट नहीं कर पाएगा.

contentHints.thumbnail.image

string (bytes format)

यूआरएल-सुरक्षित Base64 (RFC 4648 सेक्शन 5) की मदद से एन्कोड किया गया थंबनेल डेटा.

base64 कोड में बदली गई स्ट्रिंग.

contentHints.thumbnail.mimeType

string

थंबनेल का MIME टाइप.

writersCanShare

boolean

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

viewedByMe

boolean

सिर्फ़ आउटपुट के लिए. इस उपयोगकर्ता ने फ़ाइल को देखा है या नहीं.

mimeType

string

फ़ाइल का MIME टाइप.

अगर कोई वैल्यू नहीं दी जाती है, तो Google Drive, अपलोड किए गए कॉन्टेंट की सही वैल्यू का अपने-आप पता लगाने की कोशिश करता है. जब तक कोई नया पुनरीक्षण अपलोड नहीं किया जाता, तब तक मान को बदला नहीं जा सकता.

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

parents[]

string

उन पैरंट फ़ोल्डर के आईडी जिनमें फ़ाइल मौजूद है.

अगर इस अनुरोध में फ़ाइल के बारे में नहीं बताया गया है, तो फ़ाइल सीधे उपयोगकर्ता के 'मेरी ड्राइव' फ़ोल्डर में चली जाती है. अगर कॉपी करने के अनुरोध के रूप में तय नहीं किया गया है, तो फ़ाइल, सोर्स फ़ाइल के खोजे जाने लायक किसी भी पैरंट खाते को इनहेरिट कर लेती है. फ़ाइलों.update के अनुरोधों में पैरंट की सूची में बदलाव करने के लिए, addParents और removeParents पैरामीटर का इस्तेमाल किया जाना चाहिए.

shared

boolean

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

lastModifyingUser

object (User)

सिर्फ़ आउटपुट के लिए. फ़ाइल में बदलाव करने वाला आखिरी उपयोगकर्ता.

owners[]

object (User)

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

headRevisionId

string

सिर्फ़ आउटपुट के लिए. फ़ाइल के हेड रिविज़न का आईडी. फ़िलहाल, यह सुविधा Google Drive में बाइनरी कॉन्टेंट वाली फ़ाइलों के लिए ही उपलब्ध है.

sharingUser

object (User)

सिर्फ़ आउटपुट के लिए. वह उपयोगकर्ता जिसने अनुरोध करने वाले उपयोगकर्ता के साथ फ़ाइल शेयर की थी, अगर लागू हो.

size

string (int64 format)

सिर्फ़ आउटपुट के लिए. ब्लॉब और पहले पक्ष की एडिटर फ़ाइलों का साइज़, बाइट में. उन फ़ाइलों के लिए अपने-आप जानकारी नहीं भरेगी जिनका कोई साइज़ नहीं है. जैसे, शॉर्टकट और फ़ोल्डर.

viewersCanCopyContent
(deprecated)

boolean

अब काम नहीं करता: इसके बजाय, copyRequiresWriterPermission का इस्तेमाल करें.

permissions[]

object (Permission)

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

hasThumbnail

boolean

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

spaces[]

string

सिर्फ़ आउटपुट के लिए. उन स्पेस की सूची जिनमें फ़ाइल मौजूद है. इस समय इस्तेमाल किए जा सकने वाले मान 'drive', 'appData Folder', और 'photos' हैं.

folderColorRgb

string

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

अगर कोई ऐसा रंग चुना गया है जो काम नहीं करता, तो उसकी जगह पटल में सबसे नज़दीकी रंग का इस्तेमाल किया जाता है.

id

string

फ़ाइल का आईडी.

name

string

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

description

string

फ़ाइल के बारे में कम शब्दों में जानकारी.

starred

boolean

उपयोगकर्ता ने फ़ाइल पर स्टार का निशान लगाया है या नहीं.

trashed

boolean

फ़ाइल को ट्रैश में भेजा गया है या यह पैरंट फ़ोल्डर से ट्रैश में भेजा गया है. सिर्फ़ फ़ाइल का मालिक ही उसे ट्रैश में डाल सकता है और दूसरे उपयोगकर्ता, मालिक के ट्रैश में मौजूद फ़ाइलें नहीं देख सकते.

explicitlyTrashed

boolean

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

createdTime

string

वह समय जब फ़ाइल बनाई गई थी (RFC 3339 तारीख-समय).

modifiedTime

string

वह तारीख जब किसी व्यक्ति ने फ़ाइल में पिछली बार बदलाव किया था (आरएफ़सी 3339 तारीख-समय).

ध्यान दें कि modifiedTime सेटिंग से उपयोगकर्ता के लिए modifiedByMeTime भी अपडेट हो जाता है.

modifiedByMeTime

string

सिर्फ़ आउटपुट के लिए. वह तारीख जब उपयोगकर्ता ने फ़ाइल में पिछली बार बदलाव किया था (आरएफ़सी 3339 तारीख-समय).

viewedByMeTime

string

वह तारीख जब उपयोगकर्ता ने पिछली बार फ़ाइल को देखा था (आरएफ़सी 3339 तारीख-समय).

sharedWithMeTime

string

सिर्फ़ आउटपुट के लिए. अगर लागू हो, तो वह समय जब फ़ाइल को उपयोगकर्ता के साथ शेयर किया गया था (आरएफ़सी 3339 तारीख-समय).

quotaBytesUsed

string (int64 format)

सिर्फ़ आउटपुट के लिए. फ़ाइल में स्टोरेज कोटा बाइट की संख्या. इसमें हेड रिविज़न और keepForever चालू किए गए पिछले रिविज़न शामिल हैं.

version

string (int64 format)

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

originalFilename

string

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

ownedByMe

boolean

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

fullFileExtension

string

सिर्फ़ आउटपुट के लिए. name फ़ील्ड से पूरा फ़ाइल एक्सटेंशन निकाला गया. इसमें एक साथ कई एक्सटेंशन हो सकते हैं, जैसे कि "tar.gz". यह सुविधा, Google Drive में सिर्फ़ बाइनरी कॉन्टेंट वाली फ़ाइलों के लिए उपलब्ध है.

name फ़ील्ड में बदलाव होने पर, यह अपने-आप अपडेट हो जाता है. हालांकि, नए नाम में कोई मान्य एक्सटेंशन न होने पर, इसे मिटाया नहीं जाता.

properties

map (key: string, value: value (Value format))

आर्बिट्रेरी की-वैल्यू पेयर का कलेक्शन, जो सभी ऐप्लिकेशन पर दिखते हैं.

अपडेट और कॉपी करने के अनुरोधों में, शून्य वैल्यू वाली एंट्री मिटा दी जाती हैं.

एक ऑब्जेक्ट जिसमें "key": value पेयर की सूची है. उदाहरण: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

appProperties

map (key: string, value: value (Value format))

आर्बिट्रेरी कुंजी-वैल्यू पेयर का कलेक्शन, जो अनुरोध करने वाले ऐप्लिकेशन के लिए निजी होते हैं.

अपडेट और कॉपी करने के अनुरोधों में, शून्य वैल्यू वाली एंट्री मिटा दी जाती हैं.

इन प्रॉपर्टी को सिर्फ़ ऐसे अनुरोध का इस्तेमाल करके वापस लाया जा सकता है जिसकी पुष्टि हो चुकी है. पुष्टि किया गया अनुरोध, OAuth 2 क्लाइंट आईडी से मिले ऐक्सेस टोकन का इस्तेमाल करता है. निजी प्रॉपर्टी वापस पाने के लिए, एपीआई पासकोड का इस्तेमाल नहीं किया जा सकता.

एक ऑब्जेक्ट जिसमें "key": value पेयर की सूची है. उदाहरण: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

isAppAuthorized

boolean

सिर्फ़ आउटपुट के लिए. फ़ाइल को अनुरोध करने वाले ऐप्लिकेशन ने बनाया या खोला था.

teamDriveId
(deprecated)

string

अब काम नहीं करता: सिर्फ़ आउटपुट के लिए. इसके बजाय, driveId का इस्तेमाल करें.

capabilities

object

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

capabilities.canChangeViewersCanCopyContent
(deprecated)

boolean

अब काम नहीं करता: सिर्फ़ आउटपुट के लिए.

capabilities.canMoveChildrenOutOfDrive

boolean

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

capabilities.canReadDrive

boolean

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

capabilities.canEdit

boolean

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

capabilities.canCopy

boolean

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

capabilities.canComment

boolean

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

capabilities.canAddChildren

boolean

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

capabilities.canDelete

boolean

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

capabilities.canDownload

boolean

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

capabilities.canListChildren

boolean

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

capabilities.canRemoveChildren

boolean

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

capabilities.canRename

boolean

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

capabilities.canTrash

boolean

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

capabilities.canReadRevisions

boolean

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

capabilities.canReadTeamDrive
(deprecated)

boolean

अब काम नहीं करता: सिर्फ़ आउटपुट के लिए. इसके बजाय, canReadDrive का इस्तेमाल करें.

capabilities.canMoveTeamDriveItem
(deprecated)

boolean

अब काम नहीं करता: सिर्फ़ आउटपुट के लिए. इसके बजाय, canMoveItemWithinDrive या canMoveItemOutOfDrive का इस्तेमाल करें.

capabilities.canChangeCopyRequiresWriterPermission

boolean

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

capabilities.canMoveItemIntoTeamDrive
(deprecated)

boolean

अब काम नहीं करता: सिर्फ़ आउटपुट के लिए. इसके बजाय, canMoveItemOutOfDrive का इस्तेमाल करें.

capabilities.canUntrash

boolean

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

capabilities.canModifyContent

boolean

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

capabilities.canMoveItemWithinTeamDrive
(deprecated)

boolean

अब काम नहीं करता: सिर्फ़ आउटपुट के लिए. इसके बजाय, canMoveItemWithinDrive का इस्तेमाल करें.

capabilities.canMoveItemOutOfTeamDrive
(deprecated)

boolean

अब काम नहीं करता: सिर्फ़ आउटपुट के लिए. इसके बजाय, canMoveItemOutOfDrive का इस्तेमाल करें.

capabilities.canDeleteChildren

boolean

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

capabilities.canMoveChildrenOutOfTeamDrive
(deprecated)

boolean

अब काम नहीं करता: सिर्फ़ आउटपुट के लिए. इसके बजाय, canMoveChildrenOutOfDrive का इस्तेमाल करें.

capabilities.canMoveChildrenWithinTeamDrive
(deprecated)

boolean

अब काम नहीं करता: सिर्फ़ आउटपुट के लिए. इसके बजाय, canMoveChildrenWithinDrive का इस्तेमाल करें.

capabilities.canTrashChildren

boolean

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

capabilities.canMoveItemOutOfDrive

boolean

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

capabilities.canAddMyDriveParent

boolean

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

capabilities.canRemoveMyDriveParent

boolean

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

capabilities.canMoveItemWithinDrive

boolean

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

capabilities.canShare

boolean

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

capabilities.canMoveChildrenWithinDrive

boolean

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

capabilities.canModifyContentRestriction
(deprecated)

boolean

अब काम नहीं करता: सिर्फ़ आउटपुट के लिए. canModifyEditorContentRestriction, canModifyOwnerContentRestriction या canRemoveContentRestriction में से किसी एक का इस्तेमाल करें.

capabilities.canAddFolderFromAnotherDrive

boolean

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

capabilities.canChangeSecurityUpdateEnabled

boolean

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

capabilities.canAcceptOwnership

boolean

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

capabilities.canReadLabels

boolean

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

capabilities.canModifyLabels

boolean

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

capabilities.canModifyEditorContentRestriction

boolean

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

capabilities.canModifyOwnerContentRestriction

boolean

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

capabilities.canRemoveContentRestriction

boolean

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

hasAugmentedPermissions

boolean

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

trashingUser

object (User)

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

thumbnailVersion

string (int64 format)

सिर्फ़ आउटपुट के लिए. थंबनेल कैश मेमोरी में इस्तेमाल करने के लिए थंबनेल का वर्शन अमान्य है.

trashedTime

string

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

modifiedByMe

boolean

सिर्फ़ आउटपुट के लिए. इस उपयोगकर्ता ने फ़ाइल में बदलाव किया है या नहीं.

permissionIds[]

string

सिर्फ़ आउटपुट. इस फ़ाइल का ऐक्सेस रखने वाले उपयोगकर्ताओं के लिए अनुमति आईडी की file.list.

imageMediaMetadata

object

सिर्फ़ आउटपुट के लिए. उपलब्ध होने पर, इमेज मीडिया के बारे में अतिरिक्त मेटाडेटा.

imageMediaMetadata.flashUsed

boolean

सिर्फ़ आउटपुट के लिए. क्या फ़ोटो को बनाने के लिए फ़्लैश का इस्तेमाल किया गया था.

imageMediaMetadata.meteringMode

string

सिर्फ़ आउटपुट के लिए. फ़ोटो बनाने के लिए इस्तेमाल किया गया मीटरिंग मोड.

imageMediaMetadata.sensor

string

सिर्फ़ आउटपुट के लिए. फ़ोटो बनाने के लिए इस्तेमाल किए गए सेंसर का टाइप.

imageMediaMetadata.exposureMode

string

सिर्फ़ आउटपुट के लिए. फ़ोटो बनाने के लिए इस्तेमाल किया जाने वाला एक्सपोज़र मोड.

imageMediaMetadata.colorSpace

string

सिर्फ़ आउटपुट के लिए. फ़ोटो का कलर स्पेस.

imageMediaMetadata.whiteBalance

string

सिर्फ़ आउटपुट के लिए. फ़ोटो बनाने के लिए इस्तेमाल किया जाने वाला व्हाइट बैलेंस मोड.

imageMediaMetadata.width

integer

सिर्फ़ आउटपुट के लिए. पिक्सल में इमेज की चौड़ाई.

imageMediaMetadata.height

integer

सिर्फ़ आउटपुट के लिए. पिक्सल में इमेज की ऊंचाई.

imageMediaMetadata.location

object

सिर्फ़ आउटपुट के लिए. इमेज में सेव की गई भौगोलिक जगह की जानकारी.

imageMediaMetadata.location.latitude

number

सिर्फ़ आउटपुट के लिए. इमेज में सेव किया गया अक्षांश.

imageMediaMetadata.location.longitude

number

सिर्फ़ आउटपुट के लिए. इमेज में सेव किया गया देशांतर.

imageMediaMetadata.location.altitude

number

सिर्फ़ आउटपुट के लिए. इमेज में सेव की गई ऊंचाई.

imageMediaMetadata.rotation

integer

सिर्फ़ आउटपुट के लिए. चित्र के मूल अभिविन् यास से लागू किए गए घड़ी की सुई की दिशा में 90 डिग्री के घुमावों की संख्या.

imageMediaMetadata.time

string

सिर्फ़ आउटपुट के लिए. फ़ोटो लेने की तारीख और समय (EXIF DateTime).

imageMediaMetadata.cameraMake

string

सिर्फ़ आउटपुट के लिए. फ़ोटो बनाने के लिए इस्तेमाल किए गए कैमरे की बनावट.

imageMediaMetadata.cameraModel

string

सिर्फ़ आउटपुट के लिए. फ़ोटो बनाने के लिए इस्तेमाल किए गए कैमरे का मॉडल.

imageMediaMetadata.exposureTime

number

सिर्फ़ आउटपुट के लिए. एक्सपोज़र की अवधि, सेकंड में.

imageMediaMetadata.aperture

number

सिर्फ़ आउटपुट के लिए. फ़ोटो (f-number) को बनाने के लिए इस्तेमाल किया गया एपर्चर.

imageMediaMetadata.focalLength

number

सिर्फ़ आउटपुट के लिए. फ़ोटो बनाने के लिए इस्तेमाल की गई फ़ोकल लंबाई, मिलीमीटर में.

imageMediaMetadata.isoSpeed

integer

सिर्फ़ आउटपुट के लिए. फ़ोटो बनाने के लिए इस्तेमाल की गई आईएसओ की स्पीड.

imageMediaMetadata.exposureBias

number

सिर्फ़ आउटपुट के लिए. फ़ोटो का एक्सपोज़र बायस (APEX वैल्यू).

imageMediaMetadata.maxApertureValue

number

सिर्फ़ आउटपुट के लिए. फ़ोटो बनाने के लिए इस्तेमाल की गई फ़ोकल लंबाई पर, लेंस का सबसे छोटा f-नंबर (APEX वैल्यू).

imageMediaMetadata.subjectDistance

integer

सिर्फ़ आउटपुट के लिए. फ़ोटो में मौजूद ऑब्जेक्ट से, मीटर में दूरी.

imageMediaMetadata.lens

string

सिर्फ़ आउटपुट के लिए. फ़ोटो बनाने के लिए इस्तेमाल किया गया लेंस.

videoMediaMetadata

object

सिर्फ़ आउटपुट के लिए. वीडियो मीडिया के बारे में अतिरिक्त मेटाडेटा. ऐसा हो सकता है कि अपलोड करने के बाद, यह सुविधा तुरंत उपलब्ध न हो.

videoMediaMetadata.width

integer

सिर्फ़ आउटपुट के लिए. पिक्सल में वीडियो की चौड़ाई.

videoMediaMetadata.height

integer

सिर्फ़ आउटपुट के लिए. पिक्सल में वीडियो की ऊंचाई.

videoMediaMetadata.durationMillis

string (int64 format)

सिर्फ़ आउटपुट के लिए. मिलीसेकंड में वीडियो की अवधि.

shortcutDetails

object

शॉर्टकट फ़ाइल की जानकारी. सिर्फ़ उन शॉर्टकट फ़ाइलों के लिए जानकारी अपने-आप भर जाती है जिनमें mimeType फ़ील्ड को application/vnd.google-apps.shortcut पर सेट किया गया है. सिर्फ़ files.create अनुरोध पर सेट किया जा सकता है.

shortcutDetails.targetId

string

उस फ़ाइल का आईडी जिस पर यह शॉर्टकट ले जाता है. सिर्फ़ files.create अनुरोध पर सेट किया जा सकता है.

shortcutDetails.targetMimeType

string

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

shortcutDetails.targetResourceKey

string

सिर्फ़ आउटपुट के लिए. टारगेट फ़ाइल के लिए ResourceKey.

contentRestrictions[]

object (ContentRestriction)

फ़ाइल के कॉन्टेंट को ऐक्सेस करने से जुड़ी पाबंदियां. इस तरह की पाबंदी मौजूद होने पर ही जानकारी अपने-आप भर जाती है.

resourceKey

string

सिर्फ़ आउटपुट के लिए. शेयर किए गए लिंक से आइटम ऐक्सेस करने के लिए कुंजी की ज़रूरत है.

linkShareMetadata.securityUpdateEligible

boolean

सिर्फ़ आउटपुट के लिए. फ़ाइल, सुरक्षा से जुड़े अपडेट के लिए ज़रूरी शर्तें पूरी करती है या नहीं.

linkShareMetadata.securityUpdateEnabled

boolean

सिर्फ़ आउटपुट के लिए. इस फ़ाइल के लिए सुरक्षा से जुड़ा अपडेट चालू है या नहीं.

labelInfo

object

सिर्फ़ आउटपुट के लिए. फ़ाइल पर मौजूद लेबल के बारे में खास जानकारी.

labelInfo.labels[]

object (Label)

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

sha1Checksum

string

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

sha256Checksum

string

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

ContentRestriction

किसी फ़ाइल के कॉन्टेंट को ऐक्सेस करने पर पाबंदी लगाई गई है.

जेएसओएन के काेड में दिखाना
{
  "readOnly": boolean,
  "reason": string,
  "type": string,
  "restrictingUser": {
    object (User)
  },
  "restrictionTime": string,
  "ownerRestricted": boolean,
  "systemRestricted": boolean
}
फ़ील्ड
readOnly

boolean

फ़ाइल का कॉन्टेंट सिर्फ़ पढ़ने के लिए है या नहीं. अगर कोई फ़ाइल सिर्फ़ पढ़ने के लिए है, तो उसमें कोई नया बदलाव नहीं जोड़ा जा सकता. साथ ही, टिप्पणियों को जोड़ा या बदला नहीं जा सकता. साथ ही, फ़ाइल के टाइटल में बदलाव नहीं किया जा सकता.

reason

string

फ़ाइल के कॉन्टेंट पर पाबंदी क्यों लगाई गई है. यह सिर्फ़ उन अनुरोधों पर बदला जा सकता है जिनमें readOnly=true भी सेट है.

type

string

सिर्फ़ आउटपुट के लिए. कॉन्टेंट पर लगी पाबंदी किस तरह की है. फ़िलहाल, सिर्फ़ globalContentRestriction वैल्यू ही डाली जा सकती है.

restrictingUser

object (User)

सिर्फ़ आउटपुट के लिए. वह उपयोगकर्ता जिसने कॉन्टेंट पर पाबंदी लगाई है. readOnly के सही होने पर ही अपने-आप जानकारी भर जाती है.

restrictionTime

string

सिर्फ़ आउटपुट के लिए. वह समय जब कॉन्टेंट पर पाबंदी को सेट किया गया था (आरएफ़सी 3339 के फ़ॉर्मैट वाला टाइमस्टैंप). readOnly के सही होने पर ही अपने-आप जानकारी भर जाती है.

ownerRestricted

boolean

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

systemRestricted

boolean

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

तरीके

copy

यह फ़ाइल की एक कॉपी बनाता है और पैच सिमैंटिक के साथ अनुरोध किए गए अपडेट को लागू करता है.

create

एक नई फ़ाइल बनाता है.

delete

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

emptyTrash

उपयोगकर्ताओं की ट्रैश फ़ोल्डर में मौजूद सभी फ़ाइलें हमेशा के लिए मिटा दी जाती हैं.

export

Google Workspace दस्तावेज़ को, अनुरोध किए गए MIME टाइप में एक्सपोर्ट करता है और एक्सपोर्ट किए गए बाइट कॉन्टेंट को दिखाता है.

generateIds

फ़ाइल आईडी का एक सेट जनरेट करता है, जिसे अनुरोध बनाने या कॉपी करने के लिए दिया जा सकता है.

get

आईडी के हिसाब से फ़ाइल का मेटाडेटा या कॉन्टेंट दिखाता है.

list

उपयोगकर्ता की फ़ाइलों की सूची बनाता है.

listLabels

किसी फ़ाइल पर लेबल की सूची बनाता है.

modifyLabels

किसी फ़ाइल पर लागू किए गए लेबल के सेट में बदलाव करता है.

update

फ़ाइल का मेटाडेटा और/या कॉन्टेंट अपडेट करता है.

watch

इससे फ़ाइल में हुए बदलावों की सदस्यता ली जा सकती है.