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

REST Resource: files

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

منبع: فایل

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

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

نمایندگی JSON

نمایندگی JSON
{ "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,
  "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` متنی که باید برای فایل نمایه شود تا پرس و جوهای کامل متن را بهبود بخشد. این به 128 کیلوبایت محدود است و ممکن است حاوی عناصر HTML باشد.
`contentHints.thumbnail`	`object` یک تصویر کوچک برای فایل این تنها در صورتی استفاده خواهد شد که Google Drive نتواند یک تصویر کوچک استاندارد ایجاد کند.
`contentHints.thumbnail.image`	`string ( bytes format)` داده های تصویر کوچک با Base64 ایمن URL (RFC 4648 بخش 5) کدگذاری شده است. رشته ای با کد base64.
`contentHints.thumbnail.mimeType`	`string` نوع MIME تصویر کوچک.
`writersCanShare`	`boolean` این که آیا کاربرانی که فقط مجوز `writer` دارند می توانند مجوزهای فایل را تغییر دهند. برای موارد موجود در درایوهای مشترک پر نشده است.
`viewedByMe`	`boolean` فقط خروجی آیا فایل توسط این کاربر مشاهده شده است یا خیر.
`mimeType`	`string` نوع MIME فایل. اگر مقداری ارائه نشده باشد، Google Drive سعی می کند به طور خودکار مقدار مناسبی را از محتوای آپلود شده تشخیص دهد. مقدار را نمی توان تغییر داد مگر اینکه نسخه جدیدی آپلود شود. اگر فایلی با نوع Google Doc MIME ایجاد شده باشد، محتوای آپلود شده در صورت امکان وارد می شود. فرمت های واردات پشتیبانی شده در منبع About منتشر شده است.
`exportLinks`	`map (key: string, value: string)` فقط خروجی پیوندهایی برای صادرات فایل‌های ویرایشگر اسناد به فرمت‌های خاص. یک شی حاوی لیستی از `"key": value` . مثال: `{ "name": "wrench", "mass": "1.3kg", "count": "3" }` .
`parents[]`	`string` شناسه پوشه والد حاوی فایل. یک فایل فقط می تواند یک پوشه والد داشته باشد. تعیین چند والدین پشتیبانی نمی شود. اگر به عنوان بخشی از درخواست ایجاد مشخص نشده باشد، فایل مستقیماً در پوشه My Drive کاربر قرار می گیرد. اگر به عنوان بخشی از درخواست کپی مشخص نشده باشد، فایل هر والد قابل کشف فایل منبع را به ارث می برد. درخواست های files.update باید از پارامترهای `addParents` و `removeParents` برای اصلاح لیست والدین استفاده کنند.
`thumbnailLink`	`string` فقط خروجی یک پیوند کوتاه مدت به تصویر کوچک فایل، در صورت وجود. به طور معمول به ترتیب ساعت طول می کشد. به دلیل خط‌مشی‌های اشتراک‌گذاری منابع متقاطع (CORS) برای استفاده مستقیم در برنامه‌های وب در نظر گرفته نشده است، استفاده از سرور پراکسی را در نظر بگیرید. فقط زمانی پر می شود که برنامه درخواست کننده بتواند به محتوای فایل دسترسی داشته باشد. اگر فایل به‌صورت عمومی به اشتراک گذاشته نمی‌شود، URL بازگردانده شده در `Files.thumbnailLink` باید با استفاده از یک درخواست اعتبارسنجی واکشی شود.
`iconLink`	`string` فقط خروجی پیوند ایستا و احراز هویت نشده به نماد فایل.
`shared`	`boolean` فقط خروجی اینکه آیا فایل به اشتراک گذاشته شده است. برای موارد موجود در درایوهای مشترک پر نشده است.
`lastModifyingUser`	`object ( User )` فقط خروجی آخرین کاربری که فایل را تغییر داده است. این فیلد فقط زمانی پر می شود که آخرین تغییر توسط یک کاربر وارد شده انجام شده باشد.
`owners[]`	`object ( User )` فقط خروجی صاحب این فایل فقط برخی از فایل‌های قدیمی ممکن است بیش از یک مالک داشته باشند. این فیلد برای موارد موجود در درایوهای مشترک پر نشده است.
`headRevisionId`	`string` فقط خروجی شناسه ویرایش سر فایل. این در حال حاضر فقط برای فایل‌هایی با محتوای باینری در Google Drive در دسترس است.
`sharingUser`	`object ( User )` فقط خروجی کاربری که فایل را با کاربر درخواست کننده به اشتراک گذاشته است، در صورت وجود.
`webViewLink`	`string` فقط خروجی پیوندی برای باز کردن فایل در یک ویرایشگر یا نمایشگر مرتبط Google در یک مرورگر.
`webContentLink`	`string` فقط خروجی لینکی برای دانلود محتوای فایل در مرورگر. این فقط برای فایل‌هایی با محتوای باینری در Google Drive در دسترس است.
`size`	`string ( int64 format)` فقط خروجی اندازه در بایت حباب ها و فایل های ویرایشگر شخص اول. برای فایل‌هایی که اندازه ندارند، مانند میان‌برها و پوشه‌ها، پر نمی‌شود.
`viewersCanCopyContent (deprecated)`	`boolean` این مورد منسوخ شده است! منسوخ شده: به جای آن از `copyRequiresWriterPermission` استفاده کنید.
`permissions[]`	`object ( Permission )` فقط خروجی لیست کامل مجوزهای فایل این تنها در صورتی در دسترس است که کاربر درخواست کننده بتواند فایل را به اشتراک بگذارد. برای موارد موجود در درایوهای مشترک پر نشده است.
`hasThumbnail`	`boolean` فقط خروجی آیا این فایل یک تصویر کوچک دارد. این نشان نمی دهد که آیا برنامه درخواست کننده به تصویر کوچک دسترسی دارد یا خیر. برای بررسی دسترسی، به دنبال وجود قسمت thumbnailLink باشید.
`spaces[]`	`string` فقط خروجی لیست فضاهایی که حاوی فایل هستند. مقادیر پشتیبانی شده در حال حاضر عبارتند از "drive"، "appDataFolder" و "photos".
`folderColorRgb`	`string` رنگ یک پوشه یا میانبر به یک پوشه به عنوان رشته هگزا RGB. رنگ های پشتیبانی شده در قسمت `folderColorPalette` منبع About منتشر می شوند. اگر یک رنگ پشتیبانی نشده مشخص شده باشد، به جای آن از نزدیکترین رنگ در پالت استفاده می شود.
`id`	`string` شناسه فایل
`name`	`string` نام فایل. این لزوما در یک پوشه منحصر به فرد نیست. توجه داشته باشید که برای موارد غیرقابل تغییر مانند پوشه های سطح بالای درایوهای مشترک، پوشه ریشه My Drive و پوشه Application Data نام ثابت است.
`description`	`string` شرح مختصری از فایل
`starred`	`boolean` اینکه آیا کاربر فایل را ستاره‌دار کرده است.
`trashed`	`boolean` این که آیا فایل به صراحت یا از یک پوشه والد حذف شده حذف شده است. فقط مالک می‌تواند یک فایل را حذف کند و سایر کاربران نمی‌توانند فایل‌های موجود در سطل زباله مالک را ببینند.
`explicitlyTrashed`	`boolean` فقط خروجی این که آیا فایل به طور صریح در سطل زباله حذف شده است، در مقایسه با سطل زباله بازگشتی از یک پوشه والد.
`createdTime`	`string` زمانی که فایل در آن ایجاد شد (RFC 3339 date-time).
`modifiedTime`	`string` آخرین باری که فایل توسط هر کسی اصلاح شد (RFC 3339 date-time). توجه داشته باشید که تنظیم `modifiedTime` نیز `modifiedByMeTime` برای کاربر به روز می کند.
`modifiedByMeTime`	`string` فقط خروجی آخرین باری که فایل توسط کاربر اصلاح شد (RFC 3339 date-time).
`viewedByMeTime`	`string` آخرین باری که کاربر فایل را مشاهده کرد (RFC 3339 date-time).
`sharedWithMeTime`	`string` فقط خروجی زمانی که فایل در صورت وجود با کاربر به اشتراک گذاشته شد (RFC 3339 date-time).
`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 استفاده می کند. شما نمی توانید از یک کلید API برای بازیابی ویژگی های خصوصی استفاده کنید. یک شی حاوی لیستی از `"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` فقط خروجی آیا کاربر فعلی می‌تواند پوشه‌ای را از درایو دیگری (درایو مشترک دیگر یا 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 )` فقط خروجی اگر فایل به صراحت حذف شده باشد، کاربری که آن را حذف کرده است. فقط برای موارد موجود در درایوهای مشترک پر شده است.
`thumbnailVersion`	`string ( int64 format)` فقط خروجی نسخه ریز برای استفاده در باطل کردن حافظه پنهان تصاویر کوچک.
`trashedTime`	`string` فقط خروجی زمانی که مورد حذف شد (RFC 3339 date-time). فقط برای موارد موجود در درایوهای مشترک پر شده است.
`modifiedByMe`	`boolean` فقط خروجی آیا فایل توسط این کاربر اصلاح شده است یا خیر.
`permissionIds[]`	`string` فقط خروجی files.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).
`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.create` قابل تنظیم است.
`shortcutDetails.targetId`	`string` شناسه فایلی که این میانبر به آن اشاره می کند. فقط روی درخواست های `files.create` قابل تنظیم است.
`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`) }, "restrictionTime": string, "ownerRestricted": boolean, "systemRestricted": boolean }

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

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

REST Resource: files

منبع: فایل

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

روش ها

`copy`

`create`

`delete`

`download`

`emptyTrash`

`export`

`generateIds`

`get`

`list`

`listLabels`

`modifyLabels`

`update`

`watch`