این صفحه به‌وسیله ‏Cloud Translation API‏ ترجمه شده است.

REST Resource: files

منبع: فایل
- نمایندگی JSON
  - نمایندگی JSON
- محدودیت محتوا
  - نمایندگی JSON
روش ها

منبع: فایل

فراداده برای یک فایل

برخی از روش‌های منبع (مانند files.update ) به یک fileId نیاز دارند. از روش files.list برای بازیابی شناسه یک فایل استفاده کنید.

نمایندگی JSON

نمایندگی JSON
{ "kind": string, "userPermission": { object (`Permission`) }, "fileExtension": string, "md5Checksum": string, "selfLink": string, "ownerNames": [ string ], "lastModifyingUserName": string, "editable": boolean, "writersCanShare": boolean, "downloadUrl": string, "mimeType": string, "exportLinks": { string: string, ... }, "driveId": string, "parents": [ { object (`ParentReference`) } ], "thumbnailLink": string, "appDataContents": boolean, "webViewLink": string, "iconLink": string, "shared": boolean, "lastModifyingUser": { object (`User`) }, "owners": [ { object (`User`) } ], "openWithLinks": { string: string, ... }, "defaultOpenWithLink": string, "headRevisionId": string, "properties": [ { object (`Property`) } ], "copyable": boolean, "etag": string, "sharingUser": { object (`User`) }, "alternateLink": string, "embedLink": string, "webContentLink": string, "fileSize": string, "copyRequiresWriterPermission": boolean, "permissions": [ { object (`Permission`) } ], "hasThumbnail": boolean, "spaces": [ string ], "folderColorRgb": string, "id": string, "title": string, "description": string, "labels": { "viewed": boolean, "restricted": boolean, "starred": boolean, "hidden": boolean, "trashed": boolean, "modified": boolean }, "explicitlyTrashed": boolean, "createdDate": string, "modifiedDate": string, "modifiedByMeDate": string, "lastViewedByMeDate": string, "markedViewedByMeDate": string, "sharedWithMeDate": string, "quotaBytesUsed": string, "version": string, "indexableText": { "text": string }, "originalFilename": string, "ownedByMe": boolean, "canComment": boolean, "shareable": boolean, "fullFileExtension": string, "isAppAuthorized": boolean, "teamDriveId": string, "capabilities": { "canChangeRestrictedDownload": 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`) }, "canReadRevisions": boolean, "thumbnailVersion": string, "trashedDate": string, "permissionIds": [ string ], "thumbnail": { "image": string, "mimeType": 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, "date": 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,
  "userPermission": {
    object (Permission)
  },
  "fileExtension": string,
  "md5Checksum": string,
  "selfLink": string,
  "ownerNames": [
    string
  ],
  "lastModifyingUserName": string,
  "editable": boolean,
  "writersCanShare": boolean,
  "downloadUrl": string,
  "mimeType": string,
  "exportLinks": {
    string: string,
    ...
  },
  "driveId": string,
  "parents": [
    {
      object (ParentReference)
    }
  ],
  "thumbnailLink": string,
  "appDataContents": boolean,
  "webViewLink": string,
  "iconLink": string,
  "shared": boolean,
  "lastModifyingUser": {
    object (User)
  },
  "owners": [
    {
      object (User)
    }
  ],
  "openWithLinks": {
    string: string,
    ...
  },
  "defaultOpenWithLink": string,
  "headRevisionId": string,
  "properties": [
    {
      object (Property)
    }
  ],
  "copyable": boolean,
  "etag": string,
  "sharingUser": {
    object (User)
  },
  "alternateLink": string,
  "embedLink": string,
  "webContentLink": string,
  "fileSize": string,
  "copyRequiresWriterPermission": boolean,
  "permissions": [
    {
      object (Permission)
    }
  ],
  "hasThumbnail": boolean,
  "spaces": [
    string
  ],
  "folderColorRgb": string,
  "id": string,
  "title": string,
  "description": string,
  "labels": {
    "viewed": boolean,
    "restricted": boolean,
    "starred": boolean,
    "hidden": boolean,
    "trashed": boolean,
    "modified": boolean
  },
  "explicitlyTrashed": boolean,
  "createdDate": string,
  "modifiedDate": string,
  "modifiedByMeDate": string,
  "lastViewedByMeDate": string,
  "markedViewedByMeDate": string,
  "sharedWithMeDate": string,
  "quotaBytesUsed": string,
  "version": string,
  "indexableText": {
    "text": string
  },
  "originalFilename": string,
  "ownedByMe": boolean,
  "canComment": boolean,
  "shareable": boolean,
  "fullFileExtension": string,
  "isAppAuthorized": boolean,
  "teamDriveId": string,
  "capabilities": {
    "canChangeRestrictedDownload": 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)
  },
  "canReadRevisions": boolean,
  "thumbnailVersion": string,
  "trashedDate": string,
  "permissionIds": [
    string
  ],
  "thumbnail": {
    "image": string,
    "mimeType": 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,
    "date": 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` است.
`userPermission`	`object ( Permission )` فقط خروجی مجوزهای کاربر احراز هویت شده در این فایل.
`fileExtension`	`string` فقط خروجی جزء نهایی `fullFileExtension` با متن انتهایی که به نظر نمی رسد بخشی از پسوند حذف شده باشد. این فیلد فقط برای فایل هایی با محتوای ذخیره شده در Google Drive پر شده است. برای ویرایشگرهای اسناد یا فایل های میانبر پر نشده است.
`md5Checksum`	`string` فقط خروجی یک چک جمع MD5 برای محتوای این فایل. این فیلد فقط برای فایل هایی با محتوای ذخیره شده در Google Drive پر شده است. برای ویرایشگرهای اسناد یا فایل های میانبر پر نشده است.
`selfLink`	`string` فقط خروجی لینک بازگشت به این فایل
`ownerNames[]`	`string` فقط خروجی نام(های) صاحب(های) این فایل. برای موارد موجود در درایوهای مشترک پر نشده است.
`lastModifyingUserName`	`string` فقط خروجی نام آخرین کاربری که این فایل را تغییر داده است.
`editable (deprecated)`	`boolean` این مورد منسوخ شده است! فقط خروجی منسوخ شده: به جای آن از `capabilities/canEdit` استفاده کنید.
`writersCanShare`	`boolean` آیا نویسندگان می توانند سند را با سایر کاربران به اشتراک بگذارند یا خیر. برای موارد موجود در درایوهای مشترک پر نشده است.
`downloadUrl`	`string` فقط خروجی URL دانلود کوتاه مدت برای فایل. این فیلد فقط برای فایل هایی با محتوای ذخیره شده در Google Drive پر شده است. برای Google Docs یا فایل های میانبر پر نشده است.
`mimeType`	`string` نوع MIME فایل. این فقط هنگام آپدیت در هنگام آپلود محتوای جدید قابل تغییر است. این قسمت را می توان خالی گذاشت و نوع mime از نوع MIME محتوای آپلود شده تعیین می شود.
`exportLinks`	`map (key: string, value: string)` فقط خروجی پیوندهایی برای صادرات فایل‌های ویرایشگر اسناد به فرمت‌های خاص. یک شی حاوی لیستی از `"key": value` . مثال: `{ "name": "wrench", "mass": "1.3kg", "count": "3" }` .
`driveId`	`string` فقط خروجی شناسه درایو مشترک که فایل در آن قرار دارد. فقط برای موارد موجود در درایوهای مشترک پر شده است.
`parents[]`	`object ( ParentReference )` شناسه پوشه والد حاوی فایل. یک فایل فقط می تواند یک پوشه والد داشته باشد. تعیین چند والدین پشتیبانی نمی شود. اگر به عنوان بخشی از درخواست درج مشخص نشده باشد، فایل مستقیماً در پوشه My Drive کاربر قرار می گیرد. اگر به عنوان بخشی از درخواست کپی مشخص نشده باشد، فایل هر والد قابل کشف فایل منبع را به ارث می برد. درخواست های files.update باید از پارامترهای `addParents` و `removeParents` برای اصلاح لیست والدین استفاده کنند.
`thumbnailLink`	`string` فقط خروجی یک پیوند کوتاه مدت به تصویر کوچک فایل، در صورت وجود. به طور معمول به ترتیب ساعت طول می کشد. به دلیل اشتراک‌گذاری منابع متقاطع (CORS) برای استفاده مستقیم در برنامه‌های وب در نظر گرفته نشده است، استفاده از سرور پراکسی را در نظر بگیرید. فقط زمانی پر می شود که برنامه درخواست کننده بتواند به محتوای فایل دسترسی داشته باشد. اگر فایل به‌صورت عمومی به اشتراک گذاشته نمی‌شود، URL بازگردانده شده در `Files.thumbnailLink` باید با استفاده از یک درخواست اعتبارسنجی واکشی شود.
`appDataContents`	`boolean` فقط خروجی آیا این فایل در پوشه Application Data قرار دارد یا خیر.
`webViewLink`	`string` فقط خروجی پیوندی فقط در پوشه‌های عمومی برای مشاهده دارایی‌های وب ثابت (HTML، CSS، JS، و غیره) از طریق میزبانی وب‌سایت Google Drive موجود است.
`iconLink`	`string` فقط خروجی پیوندی به نماد فایل
`shared`	`boolean` فقط خروجی اینکه آیا فایل به اشتراک گذاشته شده است. برای موارد موجود در درایوهای مشترک پر نشده است.
`lastModifyingUser`	`object ( User )` فقط خروجی آخرین کاربری که این فایل را تغییر داده است. این فیلد فقط زمانی پر می شود که آخرین تغییر توسط یک کاربر وارد شده انجام شده باشد.
`owners[]`	`object ( User )` فقط خروجی صاحب این فایل فقط برخی از فایل‌های قدیمی ممکن است بیش از یک مالک داشته باشند. این فیلد برای موارد موجود در درایوهای مشترک پر نشده است.
`openWithLinks`	`map (key: string, value: string)` فقط خروجی نقشه ای از شناسه هر یک از برنامه های کاربر به پیوندی برای باز کردن این فایل با آن برنامه. فقط زمانی پر می شود که از محدوده drive.apps.readonly استفاده شود. یک شی حاوی لیستی از `"key": value` . مثال: `{ "name": "wrench", "mass": "1.3kg", "count": "3" }` .
`defaultOpenWithLink`	`string` فقط خروجی پیوندی برای باز کردن این فایل با برنامه پیش‌فرض کاربر برای این فایل. فقط زمانی پر می شود که از محدوده drive.apps.readonly استفاده شود.
`headRevisionId`	`string` فقط خروجی شناسه ویرایش سر فایل. این فیلد فقط برای فایل هایی با محتوای ذخیره شده در Google Drive پر شده است. برای ویرایشگرهای اسناد یا فایل های میانبر پر نشده است.
`properties[]`	`object ( Property )` لیست املاک.
`copyable (deprecated)`	`boolean` این مورد منسوخ شده است! فقط خروجی منسوخ شده: به جای آن از `capabilities/canCopy` استفاده کنید.
`etag`	`string` فقط خروجی ETag فایل
`sharingUser`	`object ( User )` فقط خروجی کاربری که در صورت موجود بودن، مورد را با کاربر فعلی به اشتراک گذاشته است.
`alternateLink`	`string` فقط خروجی پیوندی برای باز کردن فایل در ویرایشگر یا نمایشگر مرتبط Google.
`embedLink`	`string` فقط خروجی لینکی برای جاسازی فایل
`webContentLink`	`string` فقط خروجی پیوندی برای دانلود محتوای فایل در مرورگر با استفاده از احراز هویت مبتنی بر کوکی. در مواردی که محتوا به صورت عمومی به اشتراک گذاشته می شود، محتوا را می توان بدون هیچ گونه اعتباری دانلود کرد.
`fileSize`	`string ( int64 format)` فقط خروجی اندازه در بایت حباب ها و فایل های ویرایشگر شخص اول. برای فایل‌هایی که اندازه ندارند، مانند میان‌برها و پوشه‌ها، پر نمی‌شود.
`copyRequiresWriterPermission`	`boolean` آیا گزینه‌های کپی، چاپ یا دانلود این فایل باید برای خوانندگان و نظر دهندگان غیرفعال باشد.
`permissions[]`	`object ( Permission )` فقط خروجی لیست مجوزهای کاربرانی که به این فایل دسترسی دارند. برای موارد موجود در درایوهای مشترک پر نشده است.
`hasThumbnail`	`boolean` فقط خروجی آیا این فایل یک تصویر کوچک دارد. این نشان نمی دهد که آیا برنامه درخواست کننده به تصویر کوچک دسترسی دارد یا خیر. برای بررسی دسترسی، به دنبال وجود قسمت thumbnailLink باشید.
`spaces[]`	`string` فقط خروجی لیست فضاهایی که حاوی فایل هستند. مقادیر پشتیبانی شده عبارتند از: `drive` ، `appDataFolder` و `photos` .
`folderColorRgb`	`string` اگر فایل یک پوشه یا میانبر برای یک پوشه باشد، پوشه به عنوان یک رشته هگز RGB رنگ می شود. لیست رنگ های پشتیبانی شده در قسمت folderColorPalette منبع About موجود است. اگر یک رنگ پشتیبانی نشده مشخص شده باشد، به نزدیکترین رنگ در پالت تغییر می کند.
`id`	`string` شناسه فایل
`title`	`string` عنوان این فایل توجه داشته باشید که برای موارد تغییر ناپذیر مانند پوشه های سطح بالای درایوهای مشترک، پوشه ریشه My Drive و پوشه Application Data عنوان ثابت است.
`description`	`string` شرح مختصری از فایل
`labels`	`object` گروهی از برچسب ها برای فایل.
`labels.viewed`	`boolean` آیا این فایل توسط این کاربر مشاهده شده است یا خیر.
`labels.restricted (deprecated)`	`boolean` فقط خروجی منسوخ شده: به جای آن از `copyRequiresWriterPermission` استفاده کنید.
`labels.starred`	`boolean` آیا این فایل توسط کاربر ستاره گذاری شده است یا خیر.
`labels.hidden (deprecated)`	`boolean` فقط خروجی منسوخ شده است.
`labels.trashed`	`boolean` آیا این فایل حذف شده است یا خیر. این برچسب برای همه کاربرانی که به فایل دسترسی دارند اعمال می شود. با این حال، فقط مالکان مجاز به دیدن و حذف فایل‌ها هستند.
`labels.modified`	`boolean` فقط خروجی آیا فایل توسط این کاربر اصلاح شده است یا خیر.
`explicitlyTrashed`	`boolean` فقط خروجی این که آیا این فایل به طور صریح در سطل زباله حذف شده است یا نه، در مقایسه با سطل زباله های بازگشتی.
`createdDate`	`string` فقط خروجی برای این فایل زمان ایجاد کنید (مهر زمانی RFC 3339 فرمت شده).
`modifiedDate`	`string` آخرین باری که این فایل توسط هر کسی اصلاح شد (مهر زمانی RFC 3339 با فرمت). این تنها زمانی قابل تغییر است که پارامتر setModifiedDate تنظیم شده باشد.
`modifiedByMeDate`	`string` فقط خروجی آخرین باری که این فایل توسط کاربر اصلاح شد (مهر زمانی RFC 3339 با فرمت). توجه داشته باشید که تنظیم modifiedDate تاریخ modifiedByMe را برای کاربری که تاریخ را تنظیم کرده است به روز می کند.
`lastViewedByMeDate`	`string` آخرین باری که کاربر این فایل را مشاهده کرده است (با فرمت RFC 3339 timestamp).
`markedViewedByMeDate (deprecated)`	`string` این مورد منسوخ شده است! فقط خروجی منسوخ شده است.
`sharedWithMeDate`	`string` فقط خروجی زمانی که این فایل با کاربر به اشتراک گذاشته شد (مهر زمانی RFC 3339 فرمت شده).
`quotaBytesUsed`	`string ( int64 format)` فقط خروجی تعداد بایت های سهمیه استفاده شده توسط این فایل.
`version`	`string ( int64 format)` فقط خروجی افزایش یکنواخت شماره نسخه برای فایل. این نشان دهنده هر تغییری است که در فایل روی سرور ایجاد شده است، حتی آنهایی که برای کاربر درخواست کننده قابل مشاهده نیستند.
`indexableText`	`object` ویژگی های متنی قابل نمایه سازی برای فایل (فقط می توان نوشت)
`indexableText.text`	`string` متنی که باید برای این فایل نمایه شود.
`originalFilename`	`string` نام فایل اصلی محتوای آپلود شده در صورت موجود بودن، یا مقدار اصلی فیلد `title` . این فقط برای فایل‌هایی با محتوای باینری در Google Drive در دسترس است.
`ownedByMe`	`boolean` فقط خروجی اینکه آیا فایل متعلق به کاربر فعلی است. برای موارد موجود در درایوهای مشترک پر نشده است.
`canComment (deprecated)`	`boolean` این مورد منسوخ شده است! فقط خروجی منسوخ شده: به جای آن از `capabilities/canComment` استفاده کنید.
`shareable (deprecated)`	`boolean` این مورد منسوخ شده است! فقط خروجی منسوخ شده: به جای آن از `capabilities/canShare` استفاده کنید.
`fullFileExtension`	`string` فقط خروجی پسوند کامل فایل؛ استخراج شده از عنوان ممکن است حاوی چندین پسوند به هم پیوسته باشد، مانند "tar.gz". حذف یک پسوند از عنوان این فیلد را پاک نمی کند. با این حال، تغییر پسوند در عنوان این فیلد را به روز می کند. این فیلد فقط برای فایل هایی با محتوای ذخیره شده در Google Drive پر شده است. برای ویرایشگرهای اسناد یا فایل های میانبر پر نشده است.
`isAppAuthorized`	`boolean` فقط خروجی اینکه آیا فایل توسط برنامه درخواست کننده ایجاد شده یا باز شده است.
`teamDriveId (deprecated)`	`string` این مورد منسوخ شده است! فقط خروجی منسوخ شده: به جای آن از `driveId` استفاده کنید.
`capabilities`	`object` فقط خروجی قابلیت هایی که کاربر فعلی روی این فایل دارد. هر قابلیت مربوط به یک اقدام دقیق است که کاربر ممکن است انجام دهد.
`capabilities.canChangeRestrictedDownload (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` فقط خروجی آیا کاربر فعلی می‌تواند پوشه‌ای را از درایو دیگری (درایو مشترک دیگر یا My Drive) به این پوشه اضافه کند. این نادرست است زمانی که مورد یک پوشه نیست. فقط برای موارد موجود در درایوهای مشترک پر شده است.
`capabilities.canChangeSecurityUpdateEnabled`	`boolean` فقط خروجی اینکه آیا کاربر فعلی می‌تواند فیلد SecurityUpdateEnabled را در ابرداده اشتراک پیوند تغییر دهد یا خیر.
`capabilities.canAcceptOwnership`	`boolean` فقط خروجی آیا کاربر فعلی مالک معلق فایل است. برای فایل‌های درایو مشترک پر نشده است.
`capabilities.canReadLabels`	`boolean` فقط خروجی آیا کاربر فعلی می‌تواند برچسب‌های روی فایل را بخواند یا خیر.
`capabilities.canModifyLabels`	`boolean` فقط خروجی اینکه آیا کاربر فعلی می‌تواند برچسب‌های روی فایل را تغییر دهد یا خیر.
`capabilities.canModifyEditorContentRestriction`	`boolean` فقط خروجی آیا کاربر فعلی می‌تواند محدودیت‌های محتوایی را در فایلی که ویرایشگر محدود شده است اضافه یا تغییر دهد.
`capabilities.canModifyOwnerContentRestriction`	`boolean` فقط خروجی اینکه آیا کاربر فعلی می‌تواند محدودیت‌های محتوایی را که محدود به مالک هستند اضافه یا تغییر دهد.
`capabilities.canRemoveContentRestriction`	`boolean` فقط خروجی آیا محدودیت محتوایی در فایل وجود دارد که می تواند توسط کاربر فعلی حذف شود.
`hasAugmentedPermissions`	`boolean` فقط خروجی اینکه آیا مجوزهای مستقیماً روی این فایل وجود دارد یا خیر. این فیلد فقط برای موارد موجود در درایوهای مشترک پر شده است.
`trashingUser`	`object ( User )` فقط خروجی اگر فایل به صراحت حذف شده باشد، کاربری که آن را حذف کرده است. فقط برای موارد موجود در درایوهای مشترک پر شده است.
`canReadRevisions (deprecated)`	`boolean` این مورد منسوخ شده است! فقط خروجی منسوخ شده: به جای آن از `capabilities/canReadRevisions` استفاده کنید.
`thumbnailVersion`	`string ( int64 format)` فقط خروجی نسخه ریز برای استفاده در باطل کردن حافظه پنهان تصاویر کوچک.
`trashedDate`	`string` فقط خروجی زمانی که مورد حذف شد (مهر زمانی RFC 3339 قالب‌بندی شده). فقط برای موارد موجود در درایوهای مشترک پر شده است.
`permissionIds[]`	`string` فقط خروجی files.list از شناسه‌های مجوز برای کاربرانی که به این فایل دسترسی دارند.
`thumbnail`	`object` یک تصویر کوچک برای فایل این تنها در صورتی استفاده می‌شود که یک تصویر کوچک استاندارد ایجاد نشود.
`thumbnail.image`	`string ( bytes format)` Base64 ایمن URL بایت های تصویر کوچک را رمزگذاری می کند. باید با RFC 4648 بخش 5 مطابقت داشته باشد. رشته ای با کد base64.
`thumbnail.mimeType`	`string` نوع MIME تصویر کوچک.
`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.date`	`string` فقط خروجی تاریخ و زمان گرفتن عکس (مهر زمانی با فرمت EXIF).
`imageMediaMetadata.cameraMake`	`string` فقط خروجی برند دوربینی که برای ایجاد عکس استفاده شده است.
`imageMediaMetadata.cameraModel`	`string` فقط خروجی مدل دوربین استفاده شده برای ایجاد عکس.
`imageMediaMetadata.exposureTime`	`number` فقط خروجی طول نوردهی، بر حسب ثانیه.
`imageMediaMetadata.aperture`	`number` فقط خروجی دیافراگم مورد استفاده برای ایجاد عکس (شماره f).
`imageMediaMetadata.focalLength`	`number` فقط خروجی فاصله کانونی استفاده شده برای ایجاد عکس، بر حسب میلی متر.
`imageMediaMetadata.isoSpeed`	`integer` فقط خروجی سرعت ISO استفاده شده برای ایجاد عکس.
`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.insert` قابل تنظیم است.
`shortcutDetails.targetId`	`string` شناسه فایلی که این میانبر به آن اشاره می کند. فقط روی درخواست‌های `files.insert` قابل تنظیم است.
`shortcutDetails.targetMimeType`	`string` فقط خروجی نوع MIME فایلی که این میانبر به آن اشاره می کند. مقدار این فیلد یک عکس فوری از نوع MIME هدف است که هنگام ایجاد میانبر گرفته می شود.
`shortcutDetails.targetResourceKey`	`string` فقط خروجی ResourceKey برای فایل هدف.
`contentRestrictions[]`	`object ( ContentRestriction )` محدودیت برای دسترسی به محتوای فایل. فقط در صورت وجود چنین محدودیتی پر جمعیت است.
`resourceKey`	`string` فقط خروجی کلید مورد نیاز برای دسترسی به مورد از طریق پیوند مشترک.
`linkShareMetadata`	`object` فقط خروجی جزئیات مرتبط LinkShare حاوی جزئیات مربوط به URL های پیوندی است که مشتریان برای ارجاع به این مورد استفاده می کنند.
`linkShareMetadata.securityUpdateEligible`	`boolean` فقط خروجی آیا فایل واجد شرایط به‌روزرسانی امنیتی است یا خیر.
`linkShareMetadata.securityUpdateEnabled`	`boolean` فقط خروجی آیا به‌روزرسانی امنیتی برای این فایل فعال است یا خیر.
`labelInfo`	`object` فقط خروجی نمای کلی از برچسب های روی فایل.
`labelInfo.labels[]`	`object ( Label )` فقط خروجی مجموعه ای از برچسب ها روی فایل که توسط شناسه های برچسب در پارامتر `includeLabels` درخواست شده است. به طور پیش فرض، هیچ برچسبی برگردانده نمی شود.
`sha1Checksum`	`string` فقط خروجی جمع چک SHA1 مرتبط با این فایل، در صورت وجود. این فیلد فقط برای فایل هایی با محتوای ذخیره شده در Google Drive پر شده است. برای ویرایشگرهای اسناد یا فایل های میانبر پر نشده است.
`sha256Checksum`	`string` فقط خروجی جمع چک SHA256 مرتبط با این فایل، در صورت وجود. این فیلد فقط برای فایل هایی با محتوای ذخیره شده در Google Drive پر شده است. برای ویرایشگرهای اسناد یا فایل های میانبر پر نشده است.

محدودیت محتوا

محدودیت برای دسترسی به محتوای فایل.

نمایندگی JSON
{ "readOnly": boolean, "reason": string, "type": string, "restrictingUser": { object (`User`) }, "restrictionDate": string, "ownerRestricted": boolean, "systemRestricted": boolean }

فیلدها
`readOnly`	`boolean` آیا محتوای فایل فقط خواندنی است یا خیر. اگر فایلی فقط خواندنی باشد، ممکن است ویرایش جدیدی از فایل اضافه نشود، نظرات ممکن است اضافه یا اصلاح نشود، و عنوان فایل ممکن است تغییر نکند.
`reason`	`string` دلیل محدودیت محتوای فایل این فقط در درخواست‌هایی قابل تغییر است که `readOnly=true` نیز تنظیم کنند.
`type`	`string` فقط خروجی نوع محدودیت محتوا در حال حاضر تنها مقدار ممکن `globalContentRestriction` است.
`restrictingUser`	`object ( User )` فقط خروجی کاربری که محدودیت محتوا را تعیین کرده است. فقط در صورتی پر می شود که `readOnly` درست باشد.
`restrictionDate`	`string` فقط خروجی زمانی که محدودیت محتوا تنظیم شد (مهر زمانی RFC 3339 قالب‌بندی شده). فقط در صورتی پر می شود که `readOnly` درست باشد.
`ownerRestricted`	`boolean` اینکه آیا محدودیت محتوا فقط توسط کاربری که مالک فایل است قابل تغییر یا حذف است. برای فایل‌های موجود در درایوهای مشترک، هر کاربری با قابلیت `organizer` می‌تواند این محدودیت محتوا را اصلاح یا حذف کند.
`systemRestricted`	`boolean` فقط خروجی آیا محدودیت محتوا توسط سیستم اعمال شده است یا خیر، برای مثال به دلیل یک امضا. کاربران نمی توانند محدودیت های محتوای محدود شده سیستم را اصلاح یا حذف کنند.

روش ها
`copy`	یک کپی از فایل مشخص شده ایجاد می کند.
`delete`	یک فایل متعلق به کاربر را بدون انتقال به سطل زباله برای همیشه حذف می کند.
`emptyTrash`	تمام فایل های حذف شده کاربر را برای همیشه حذف می کند.
`export`	یک سند Google Workspace را به نوع MIME درخواستی صادر می کند و محتوای بایت صادر شده را برمی گرداند.
`generateIds`	مجموعه ای از شناسه های فایل را ایجاد می کند که می توانند در درخواست های درج یا کپی ارائه شوند.
`get`	فراداده یا محتوای یک فایل را با شناسه دریافت می کند.
`insert`	یک فایل جدید درج می کند.
`list`	فایل های کاربر را لیست می کند.
`listLabels`	برچسب های روی یک فایل را فهرست می کند.
`modifyLabels`	مجموعه ای از برچسب های اعمال شده روی یک فایل را تغییر می دهد.
`patch`	فراداده و/یا محتوای یک فایل را به روز می کند.
`touch`	زمان به روز رسانی فایل را روی زمان سرور فعلی تنظیم کنید.
`trash`	یک فایل را به سطل زباله منتقل می کند.
`untrash`	یک فایل را از سطل زباله بازیابی می کند.
`update`	فراداده و/یا محتوای فایل را به روز می کند.
`watch`	برای تغییرات یک فایل مشترک می شود.

REST Resource: files

منبع: فایل

محدودیت محتوا

روش ها

`copy`

`delete`

`emptyTrash`

`export`

`generateIds`

`get`

`insert`

`list`

`listLabels`

`modifyLabels`

`patch`

`touch`

`trash`

`untrash`

`update`

`watch`