این صفحه به‌وسیله ‏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, "canDisableInheritedPermissions": boolean, "canEnableInheritedPermissions": 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, "inheritedPermissionsDisabled": boolean }

{
  "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,
    "canDisableInheritedPermissions": boolean,
    "canEnableInheritedPermissions": 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,
  "inheritedPermissionsDisabled": boolean
}

فیلدها
`kind`	`string` فقط خروجی مشخص می کند که این چه نوع منبعی است. مقدار: رشته ثابت `"drive#file"` .
`drive Id`	`string` فقط خروجی شناسه درایو مشترک که فایل در آن قرار دارد. فقط برای موارد موجود در درایوهای مشترک پر شده است.
`file Extension`	`string` فقط خروجی جزء نهایی `fullFileExtension` . این فقط برای فایل‌هایی با محتوای باینری در Google Drive در دسترس است.
`copy Requires Writer Permission`	`boolean` آیا گزینه‌های کپی، چاپ یا دانلود این فایل باید برای خوانندگان و نظر دهندگان غیرفعال باشد.
`md5 Checksum`	`string` فقط خروجی چک جمع MD5 برای محتوای فایل. این فقط برای فایل‌هایی با محتوای باینری در Google Drive قابل اجرا است.
`content Hints`	`object` اطلاعات تکمیلی در مورد محتوای فایل. این فیلدها هرگز در پاسخ ها پر نمی شوند.
`content Hints. indexable Text`	`string` متنی که باید برای فایل نمایه شود تا پرس و جوهای کامل متن را بهبود بخشد. این به 128 کیلوبایت محدود است و ممکن است حاوی عناصر HTML باشد.
`content Hints. thumbnail`	`object` یک تصویر کوچک برای فایل این تنها در صورتی استفاده خواهد شد که Google Drive نتواند یک تصویر کوچک استاندارد ایجاد کند.
`content Hints. thumbnail. image`	`string ( bytes format)` داده های تصویر کوچک با Base64 ایمن URL (RFC 4648 بخش 5) کدگذاری شده است. رشته ای با کد base64.
`content Hints. thumbnail. mime Type`	`string` نوع MIME تصویر کوچک.
`writers Can Share`	`boolean` این که آیا کاربرانی که فقط مجوز `writer` دارند می توانند مجوزهای فایل را تغییر دهند. برای موارد موجود در درایوهای مشترک پر نشده است.
`viewed By Me`	`boolean` فقط خروجی آیا فایل توسط این کاربر مشاهده شده است یا خیر.
`mime Type`	`string` نوع MIME فایل. اگر مقداری ارائه نشده باشد، Google Drive سعی می کند به طور خودکار مقدار مناسبی را از محتوای آپلود شده تشخیص دهد. مقدار را نمی توان تغییر داد مگر اینکه نسخه جدیدی آپلود شود. اگر فایلی با نوع Google Doc MIME ایجاد شده باشد، محتوای آپلود شده در صورت امکان وارد می شود. فرمت های واردات پشتیبانی شده در منبع About منتشر شده است.
`export Links`	`map (key: string, value: string)` فقط خروجی پیوندهایی برای صادرات فایل‌های ویرایشگر اسناد به فرمت‌های خاص. یک شی حاوی لیستی از `"key": value` . مثال: `{ "name": "wrench", "mass": "1.3kg", "count": "3" }` .
`parents[]`	`string` شناسه پوشه والد حاوی فایل. یک فایل فقط می تواند یک پوشه والد داشته باشد. تعیین چند والدین پشتیبانی نمی شود. اگر به عنوان بخشی از درخواست ایجاد مشخص نشده باشد، فایل مستقیماً در پوشه My Drive کاربر قرار می گیرد. اگر به عنوان بخشی از درخواست کپی مشخص نشده باشد، فایل هر والد قابل کشف فایل منبع را به ارث می برد. درخواست های files.update باید از پارامترهای `addParents` و `removeParents` برای اصلاح لیست والدین استفاده کنند.
`thumbnail Link`	`string` فقط خروجی یک پیوند کوتاه مدت به تصویر کوچک فایل، در صورت وجود. به طور معمول به ترتیب ساعت طول می کشد. به دلیل خط‌مشی‌های اشتراک‌گذاری منابع متقاطع (CORS) برای استفاده مستقیم در برنامه‌های وب در نظر گرفته نشده است، استفاده از یک سرور پراکسی را در نظر بگیرید. فقط زمانی پر می شود که برنامه درخواست کننده بتواند به محتوای فایل دسترسی داشته باشد. اگر فایل به‌صورت عمومی به اشتراک گذاشته نمی‌شود، URL بازگردانده شده در `Files.thumbnailLink` باید با استفاده از یک درخواست اعتبارسنجی واکشی شود.
`icon Link`	`string` فقط خروجی پیوند ایستا و احراز هویت نشده به نماد فایل.
`shared`	`boolean` فقط خروجی اینکه آیا فایل به اشتراک گذاشته شده است. برای موارد موجود در درایوهای مشترک پر نشده است.
`last Modifying User`	`object ( User )` فقط خروجی آخرین کاربری که فایل را تغییر داده است. این فیلد فقط زمانی پر می شود که آخرین تغییر توسط یک کاربر وارد شده انجام شده باشد.
`owners[]`	`object ( User )` فقط خروجی صاحب این فایل فقط برخی از فایل‌های قدیمی ممکن است بیش از یک مالک داشته باشند. این فیلد برای موارد موجود در درایوهای مشترک پر نشده است.
`head Revision Id`	`string` فقط خروجی شناسه ویرایش سر فایل. این در حال حاضر فقط برای فایل‌هایی با محتوای باینری در Google Drive در دسترس است.
`sharing User`	`object ( User )` فقط خروجی کاربری که فایل را با کاربر درخواست کننده به اشتراک گذاشته است، در صورت وجود.
`web View Link`	`string` فقط خروجی پیوندی برای باز کردن فایل در یک ویرایشگر یا نمایشگر مرتبط Google در یک مرورگر.
`web Content Link`	`string` فقط خروجی لینکی برای دانلود محتوای فایل در مرورگر. این فقط برای فایل‌هایی با محتوای باینری در Google Drive در دسترس است.
`size`	`string ( int64 format)` فقط خروجی اندازه در بایت حباب ها و فایل های ویرایشگر شخص اول. برای فایل‌هایی که اندازه ندارند، مانند میان‌برها و پوشه‌ها، پر نمی‌شود.
`viewersCanCopyContent (deprecated)`	`boolean` این مورد منسوخ شده است! منسوخ شده: به جای آن از `copyRequiresWriterPermission` استفاده کنید.
`permissions[]`	`object ( Permission )` فقط خروجی لیست کامل مجوزهای فایل این تنها در صورتی در دسترس است که کاربر درخواست کننده بتواند فایل را به اشتراک بگذارد. برای موارد موجود در درایوهای مشترک پر نشده است.
`has Thumbnail`	`boolean` فقط خروجی آیا این فایل یک تصویر کوچک دارد. این نشان نمی دهد که آیا برنامه درخواست کننده به تصویر کوچک دسترسی دارد یا خیر. برای بررسی دسترسی، به دنبال وجود قسمت thumbnailLink باشید.
`spaces[]`	`string` فقط خروجی لیست فضاهایی که حاوی فایل هستند. مقادیر پشتیبانی شده در حال حاضر عبارتند از "drive"، "appDataFolder" و "photos".
`folder Color Rgb`	`string` رنگ یک پوشه یا میانبر به یک پوشه به عنوان رشته هگزا RGB. رنگ های پشتیبانی شده در قسمت `folderColorPalette` منبع About منتشر می شوند. اگر یک رنگ پشتیبانی نشده مشخص شده باشد، به جای آن از نزدیکترین رنگ در پالت استفاده می شود.
`id`	`string` شناسه فایل
`name`	`string` نام فایل. این لزوما در یک پوشه منحصر به فرد نیست. توجه داشته باشید که برای موارد غیرقابل تغییر مانند پوشه های سطح بالای درایوهای مشترک، پوشه ریشه My Drive و پوشه Application Data نام ثابت است.
`description`	`string` شرح مختصری از فایل
`starred`	`boolean` اینکه آیا کاربر فایل را ستاره گذاری کرده است.
`trashed`	`boolean` این که آیا فایل به صراحت یا از یک پوشه والد حذف شده حذف شده است. فقط مالک می‌تواند یک فایل را حذف کند و سایر کاربران نمی‌توانند فایل‌های موجود در سطل زباله مالک را ببینند.
`explicitly Trashed`	`boolean` فقط خروجی این که آیا فایل به طور صریح در سطل زباله حذف شده است، در مقایسه با سطل زباله بازگشتی از یک پوشه والد.
`created Time`	`string` زمانی که فایل در آن ایجاد شد (RFC 3339 date-time).
`modified Time`	`string` آخرین باری که فایل توسط هر کسی اصلاح شد (RFC 3339 date-time). توجه داشته باشید که تنظیم `modifiedTime` نیز `modifiedByMeTime` برای کاربر به روز می کند.
`modified By Me Time`	`string` فقط خروجی آخرین باری که فایل توسط کاربر اصلاح شد (RFC 3339 date-time).
`viewed By Me Time`	`string` آخرین باری که کاربر فایل را مشاهده کرد (RFC 3339 date-time).
`shared With Me Time`	`string` فقط خروجی زمانی که فایل در صورت وجود با کاربر به اشتراک گذاشته شد (RFC 3339 date-time).
`quota Bytes Used`	`string ( int64 format)` فقط خروجی تعداد بایت های سهمیه ذخیره سازی استفاده شده توسط فایل. این شامل ویرایش سر و همچنین ویرایش های قبلی با فعال کردن `keepForever` می شود.
`version`	`string ( int64 format)` فقط خروجی افزایش یکنواخت شماره نسخه برای فایل. این نشان دهنده هر تغییری است که در فایل روی سرور ایجاد شده است، حتی آنهایی که برای کاربر قابل مشاهده نیستند.
`original Filename`	`string` نام فایل اصلی محتوای آپلود شده در صورت موجود بودن، یا مقدار اصلی فیلد `name` . این فقط برای فایل‌هایی با محتوای باینری در Google Drive در دسترس است.
`owned By Me`	`boolean` فقط خروجی اینکه آیا کاربر مالک فایل است. برای موارد موجود در درایوهای مشترک پر نشده است.
`full File Extension`	`string` فقط خروجی پسوند کامل فایل از قسمت `name` استخراج شده است. ممکن است حاوی چندین پسوند به هم پیوسته باشد، مانند "tar.gz". این فقط برای فایل‌هایی با محتوای باینری در Google Drive در دسترس است. هنگامی که فیلد `name` تغییر می کند، این به طور خودکار به روز می شود، اما اگر نام جدید دارای پسوند معتبر نباشد، پاک نمی شود.
`properties`	`map (key: string, value: value ( Value format))` مجموعه‌ای از جفت‌های کلید-مقدار دلخواه که برای همه برنامه‌ها قابل مشاهده است. ورودی‌های دارای مقادیر تهی در درخواست‌های به‌روزرسانی و کپی پاک می‌شوند. یک شی حاوی لیستی از `"key": value` . مثال: `{ "name": "wrench", "mass": "1.3kg", "count": "3" }` .
`app Properties`	`map (key: string, value: value ( Value format))` مجموعه‌ای از جفت‌های کلید-مقدار دلخواه که برای برنامه درخواست‌کننده خصوصی هستند. ورودی‌های دارای مقادیر تهی در درخواست‌های به‌روزرسانی و کپی پاک می‌شوند. این ویژگی ها فقط با استفاده از یک درخواست احراز هویت شده قابل بازیابی هستند. یک درخواست احراز هویت شده از یک نشانه دسترسی به دست آمده با شناسه مشتری OAuth 2 استفاده می کند. شما نمی توانید از یک کلید API برای بازیابی ویژگی های خصوصی استفاده کنید. یک شی حاوی لیستی از `"key": value` . مثال: `{ "name": "wrench", "mass": "1.3kg", "count": "3" }` .
`is App Authorized`	`boolean` فقط خروجی اینکه آیا فایل توسط برنامه درخواست کننده ایجاد شده یا باز شده است.
`teamDriveId (deprecated)`	`string` این مورد منسوخ شده است! منسوخ شده: فقط خروجی. به جای آن از `driveId` استفاده کنید.
`capabilities`	`object` فقط خروجی قابلیت هایی که کاربر فعلی روی این فایل دارد. هر قابلیت مربوط به یک اقدام دقیق است که کاربر ممکن است انجام دهد.
`capabilities.canChangeViewersCanCopyContent (deprecated)`	`boolean` منسوخ شده: فقط خروجی.
`capabilities. can Move Children Out Of Drive`	`boolean` فقط خروجی آیا کاربر فعلی می‌تواند فرزندان این پوشه را به خارج از درایو مشترک منتقل کند یا خیر. این نادرست است زمانی که مورد یک پوشه نیست. فقط برای موارد موجود در درایوهای مشترک پر شده است.
`capabilities. can Read Drive`	`boolean` فقط خروجی آیا کاربر فعلی می‌تواند درایو مشترکی که این فایل به آن تعلق دارد را بخواند یا خیر. فقط برای موارد موجود در درایوهای مشترک پر شده است.
`capabilities. can Edit`	`boolean` فقط خروجی آیا کاربر فعلی می تواند این فایل را ویرایش کند یا خیر. عوامل دیگر ممکن است نوع تغییراتی را که کاربر می تواند در یک فایل ایجاد کند محدود کند. برای مثال، `canChangeCopyRequiresWriterPermission` یا `canModifyContent` ببینید.
`capabilities. can Copy`	`boolean` فقط خروجی آیا کاربر فعلی می تواند این فایل را کپی کند یا خیر. برای یک مورد در درایو مشترک، آیا کاربر فعلی می‌تواند نوادگان غیر پوشه‌ای این مورد را کپی کند یا این مورد را اگر پوشه نیست، کپی کند.
`capabilities. can Comment`	`boolean` فقط خروجی آیا کاربر فعلی می تواند در مورد این فایل نظر دهد یا خیر.
`capabilities. can Add Children`	`boolean` فقط خروجی آیا کاربر فعلی می‌تواند کودکان را به این پوشه اضافه کند یا خیر. هنگامی که مورد یک پوشه نیست، این همیشه نادرست است.
`capabilities. can Delete`	`boolean` فقط خروجی آیا کاربر فعلی می تواند این فایل را حذف کند یا خیر.
`capabilities. can Download`	`boolean` فقط خروجی آیا کاربر فعلی می تواند این فایل را دانلود کند یا خیر.
`capabilities. can List Children`	`boolean` فقط خروجی آیا کاربر فعلی می‌تواند فرزندان این پوشه را فهرست کند یا خیر. هنگامی که مورد یک پوشه نیست، این همیشه نادرست است.
`capabilities. can Remove Children`	`boolean` فقط خروجی آیا کاربر فعلی می‌تواند کودکان را از این پوشه حذف کند یا خیر. هنگامی که مورد یک پوشه نیست، این همیشه نادرست است. برای پوشه ای در درایو مشترک، به جای آن از `canDeleteChildren` یا `canTrashChildren` استفاده کنید.
`capabilities. can Rename`	`boolean` فقط خروجی آیا کاربر فعلی می‌تواند نام این فایل را تغییر دهد یا خیر.
`capabilities. can Trash`	`boolean` فقط خروجی آیا کاربر فعلی می‌تواند این فایل را به حذف‌شده‌ها منتقل کند یا خیر.
`capabilities. can Read Revisions`	`boolean` فقط خروجی آیا کاربر فعلی می‌تواند منبع ویرایش‌های این فایل را بخواند یا خیر. برای یک مورد درایو مشترک، چه بازبینی‌های غیرپوشه‌ای این مورد، چه خود این مورد اگر یک پوشه نیست، قابل خواندن است.
`capabilities.canReadTeamDrive (deprecated)`	`boolean` منسوخ شده: فقط خروجی. به جای آن از `canReadDrive` استفاده کنید.
`capabilities.canMoveTeamDriveItem (deprecated)`	`boolean` منسوخ شده: فقط خروجی. به جای آن از `canMoveItemWithinDrive` یا `canMoveItemOutOfDrive` استفاده کنید.
`capabilities. can Change Copy Requires Writer Permission`	`boolean` فقط خروجی آیا کاربر فعلی می‌تواند محدودیت `copyRequiresWriterPermission` این فایل را تغییر دهد یا خیر.
`capabilities.canMoveItemIntoTeamDrive (deprecated)`	`boolean` منسوخ شده: فقط خروجی. به جای آن از `canMoveItemOutOfDrive` استفاده کنید.
`capabilities. can Untrash`	`boolean` فقط خروجی آیا کاربر فعلی می تواند این فایل را از سطل زباله بازیابی کند یا خیر.
`capabilities. can Modify Content`	`boolean` فقط خروجی آیا کاربر فعلی می تواند محتوای این فایل را تغییر دهد یا خیر.
`capabilities.canMoveItemWithinTeamDrive (deprecated)`	`boolean` منسوخ شده: فقط خروجی. به جای آن از `canMoveItemWithinDrive` استفاده کنید.
`capabilities.canMoveItemOutOfTeamDrive (deprecated)`	`boolean` منسوخ شده: فقط خروجی. به جای آن از `canMoveItemOutOfDrive` استفاده کنید.
`capabilities. can Delete Children`	`boolean` فقط خروجی آیا کاربر فعلی می‌تواند فرزندان این پوشه را حذف کند یا خیر. این نادرست است زمانی که مورد یک پوشه نیست. فقط برای موارد موجود در درایوهای مشترک پر شده است.
`capabilities.canMoveChildrenOutOfTeamDrive (deprecated)`	`boolean` منسوخ شده: فقط خروجی. به جای آن از `canMoveChildrenOutOfDrive` استفاده کنید.
`capabilities.canMoveChildrenWithinTeamDrive (deprecated)`	`boolean` منسوخ شده: فقط خروجی. به جای آن از `canMoveChildrenWithinDrive` استفاده کنید.
`capabilities. can Trash Children`	`boolean` فقط خروجی آیا کاربر فعلی می‌تواند فرزندان این پوشه را حذف کند یا خیر. این نادرست است زمانی که مورد یک پوشه نیست. فقط برای موارد موجود در درایوهای مشترک پر شده است.
`capabilities. can Move Item Out Of Drive`	`boolean` فقط خروجی آیا کاربر فعلی می‌تواند این مورد را با تغییر والد آن به خارج از این درایو منتقل کند یا خیر. توجه داشته باشید که بسته به والد جدیدی که اضافه می‌شود، درخواست تغییر والد مورد ممکن است همچنان با شکست مواجه شود.
`capabilities. can Add My Drive Parent`	`boolean` فقط خروجی اینکه آیا کاربر کنونی می‌تواند یک والد برای مورد بدون حذف یک والدین موجود در همان درخواست اضافه کند یا خیر. برای فایل‌های درایو مشترک پر نشده است.
`capabilities. can Remove My Drive Parent`	`boolean` فقط خروجی اینکه آیا کاربر فعلی می‌تواند یکی از والدین را از مورد بدون اضافه کردن والدین دیگری در همان درخواست حذف کند یا خیر. برای فایل‌های درایو مشترک پر نشده است.
`capabilities. can Move Item Within Drive`	`boolean` فقط خروجی آیا کاربر فعلی می‌تواند این مورد را در این درایو منتقل کند یا خیر. توجه داشته باشید که بسته به والد جدیدی که اضافه می‌شود و والدی که حذف می‌شود، ممکن است درخواست تغییر والد مورد با شکست مواجه شود.
`capabilities. can Share`	`boolean` فقط خروجی آیا کاربر فعلی می‌تواند تنظیمات اشتراک‌گذاری این فایل را تغییر دهد یا خیر.
`capabilities. can Move Children Within Drive`	`boolean` فقط خروجی آیا کاربر فعلی می‌تواند فرزندان این پوشه را در این درایو منتقل کند یا خیر. این نادرست است زمانی که مورد یک پوشه نیست. توجه داشته باشید که بسته به دسترسی کاربر فعلی به کودک و پوشه مقصد، ممکن است درخواست انتقال کودک همچنان با شکست مواجه شود.
`capabilities.canModifyContentRestriction (deprecated)`	`boolean` منسوخ شده: فقط خروجی. از یکی از `canModifyEditorContentRestriction` ، `canModifyOwnerContentRestriction` یا `canRemoveContentRestriction` استفاده کنید.
`capabilities. can Add Folder From Another Drive`	`boolean` فقط خروجی آیا کاربر فعلی می‌تواند پوشه‌ای را از درایو دیگری (درایو مشترک دیگر یا My Drive) به این پوشه اضافه کند. این نادرست است زمانی که مورد یک پوشه نیست. فقط برای موارد موجود در درایوهای مشترک پر شده است.
`capabilities. can Change Security Update Enabled`	`boolean` فقط خروجی اینکه آیا کاربر فعلی می‌تواند فیلد SecurityUpdateEnabled را در ابرداده اشتراک پیوند تغییر دهد یا خیر.
`capabilities. can Accept Ownership`	`boolean` فقط خروجی آیا کاربر فعلی مالک معلق فایل است. برای فایل‌های درایو مشترک پر نشده است.
`capabilities. can Read Labels`	`boolean` فقط خروجی آیا کاربر فعلی می‌تواند برچسب‌های روی فایل را بخواند یا خیر.
`capabilities. can Modify Labels`	`boolean` فقط خروجی اینکه آیا کاربر فعلی می‌تواند برچسب‌های روی فایل را تغییر دهد یا خیر.
`capabilities. can Modify Editor Content Restriction`	`boolean` فقط خروجی آیا کاربر فعلی می‌تواند محدودیت‌های محتوایی را در فایلی که ویرایشگر محدود شده است اضافه یا تغییر دهد.
`capabilities. can Modify Owner Content Restriction`	`boolean` فقط خروجی اینکه آیا کاربر فعلی می‌تواند محدودیت‌های محتوایی را که محدود به مالک هستند اضافه یا تغییر دهد.
`capabilities. can Remove Content Restriction`	`boolean` فقط خروجی آیا محدودیت محتوایی در فایل وجود دارد که می تواند توسط کاربر فعلی حذف شود.
`capabilities. can Disable Inherited Permissions`	`boolean` اینکه آیا کاربر می‌تواند مجوزهای ارثی را غیرفعال کند یا خیر.
`capabilities. can Enable Inherited Permissions`	`boolean` اینکه آیا کاربر می تواند مجوزهای ارثی را دوباره فعال کند یا خیر.
`has Augmented Permissions`	`boolean` فقط خروجی اینکه آیا مجوزهای مستقیماً روی این فایل وجود دارد یا خیر. این فیلد فقط برای موارد موجود در درایوهای مشترک پر شده است.
`trashing User`	`object ( User )` فقط خروجی اگر فایل به صراحت حذف شده باشد، کاربری که آن را حذف کرده است. فقط برای موارد موجود در درایوهای مشترک پر شده است.
`thumbnail Version`	`string ( int64 format)` فقط خروجی نسخه ریز برای استفاده در باطل کردن حافظه پنهان تصاویر کوچک.
`trashed Time`	`string` فقط خروجی زمانی که مورد حذف شد (RFC 3339 date-time). فقط برای موارد موجود در درایوهای مشترک پر شده است.
`modified By Me`	`boolean` فقط خروجی آیا فایل توسط این کاربر اصلاح شده است یا خیر.
`permission Ids[]`	`string` فقط خروجی files.list از شناسه‌های مجوز برای کاربرانی که به این فایل دسترسی دارند.
`image Media Metadata`	`object` فقط خروجی فراداده اضافی درباره رسانه تصویر، در صورت وجود.
`image Media Metadata. flash Used`	`boolean` فقط خروجی آیا از فلاش برای ایجاد عکس استفاده شده است یا خیر.
`image Media Metadata. metering Mode`	`string` فقط خروجی حالت اندازه گیری مورد استفاده برای ایجاد عکس.
`image Media Metadata. sensor`	`string` فقط خروجی نوع سنسور مورد استفاده برای ایجاد عکس.
`image Media Metadata. exposure Mode`	`string` فقط خروجی حالت نوردهی مورد استفاده برای ایجاد عکس.
`image Media Metadata. color Space`	`string` فقط خروجی فضای رنگی عکس.
`image Media Metadata. white Balance`	`string` فقط خروجی حالت تعادل رنگ سفید که برای ایجاد عکس استفاده می شود.
`image Media Metadata. width`	`integer` فقط خروجی عرض تصویر بر حسب پیکسل
`image Media Metadata. height`	`integer` فقط خروجی ارتفاع تصویر بر حسب پیکسل
`image Media Metadata. location`	`object` فقط خروجی اطلاعات موقعیت جغرافیایی ذخیره شده در تصویر
`image Media Metadata. location. latitude`	`number` فقط خروجی عرض جغرافیایی ذخیره شده در تصویر
`image Media Metadata. location. longitude`	`number` فقط خروجی طول جغرافیایی ذخیره شده در تصویر
`image Media Metadata. location. altitude`	`number` فقط خروجی ارتفاع ذخیره شده در تصویر
`image Media Metadata. rotation`	`integer` فقط خروجی تعداد چرخش های 90 درجه ای در جهت عقربه های ساعت که از جهت اصلی تصویر اعمال می شود.
`image Media Metadata. time`	`string` فقط خروجی تاریخ و زمان گرفتن عکس (EXIF DateTime).
`image Media Metadata. camera Make`	`string` فقط خروجی برند دوربینی که برای ایجاد عکس استفاده شده است.
`image Media Metadata. camera Model`	`string` فقط خروجی مدل دوربین استفاده شده برای ایجاد عکس.
`image Media Metadata. exposure Time`	`number` فقط خروجی طول نوردهی، بر حسب ثانیه.
`image Media Metadata. aperture`	`number` فقط خروجی دیافراگم مورد استفاده برای ایجاد عکس (شماره f).
`image Media Metadata. focal Length`	`number` فقط خروجی فاصله کانونی استفاده شده برای ایجاد عکس، بر حسب میلی متر.
`image Media Metadata. iso Speed`	`integer` فقط خروجی سرعت ISO استفاده شده برای ایجاد عکس.
`image Media Metadata. exposure Bias`	`number` فقط خروجی سوگیری نوردهی عکس (مقدار APEX).
`image Media Metadata. max Aperture Value`	`number` فقط خروجی کوچکترین عدد f لنز در فاصله کانونی مورد استفاده برای ایجاد عکس (مقدار APEX).
`image Media Metadata. subject Distance`	`integer` فقط خروجی فاصله تا سوژه عکس بر حسب متر.
`image Media Metadata. lens`	`string` فقط خروجی لنز مورد استفاده برای ایجاد عکس.
`video Media Metadata`	`object` فقط خروجی فراداده اضافی درباره رسانه ویدیویی. ممکن است بلافاصله پس از آپلود در دسترس نباشد.
`video Media Metadata. width`	`integer` فقط خروجی عرض ویدیو بر حسب پیکسل
`video Media Metadata. height`	`integer` فقط خروجی ارتفاع فیلم بر حسب پیکسل
`video Media Metadata. duration Millis`	`string ( int64 format)` فقط خروجی مدت زمان ویدیو بر حسب میلی ثانیه
`shortcut Details`	`object` جزئیات فایل میانبر فقط برای فایل های میانبر پر شده است، که قسمت mimeType روی `application/vnd.google-apps.shortcut` تنظیم شده است. فقط روی درخواست های `files.create` قابل تنظیم است.
`shortcut Details. target Id`	`string` شناسه فایلی که این میانبر به آن اشاره می کند. فقط روی درخواست های `files.create` قابل تنظیم است.
`shortcut Details. target Mime Type`	`string` فقط خروجی نوع MIME فایلی که این میانبر به آن اشاره می کند. مقدار این فیلد یک عکس فوری از نوع MIME هدف است که هنگام ایجاد میانبر گرفته می شود.
`shortcut Details. target Resource Key`	`string` فقط خروجی ResourceKey برای فایل هدف.
`content Restrictions[]`	`object ( ContentRestriction )` محدودیت برای دسترسی به محتوای فایل. فقط در صورت وجود چنین محدودیتی پر جمعیت است.
`resource Key`	`string` فقط خروجی کلید مورد نیاز برای دسترسی به مورد از طریق پیوند مشترک.
`link Share Metadata`	`object` فقط خروجی جزئیات مرتبط LinkShare حاوی جزئیات مربوط به URL های پیوندی است که مشتریان برای ارجاع به این مورد استفاده می کنند.
`link Share Metadata. security Update Eligible`	`boolean` فقط خروجی آیا فایل واجد شرایط به‌روزرسانی امنیتی است یا خیر.
`link Share Metadata. security Update Enabled`	`boolean` فقط خروجی آیا به‌روزرسانی امنیتی برای این فایل فعال است یا خیر.
`label Info`	`object` فقط خروجی نمای کلی از برچسب های روی فایل.
`label Info. labels[]`	`object ( Label )` فقط خروجی مجموعه ای از برچسب ها روی فایل که توسط شناسه های برچسب در پارامتر `includeLabels` درخواست شده است. به طور پیش فرض، هیچ برچسبی برگردانده نمی شود.
`sha1 Checksum`	`string` فقط خروجی جمع چک SHA1 مرتبط با این فایل، در صورت وجود. این فیلد فقط برای فایل هایی با محتوای ذخیره شده در Google Drive پر شده است. برای ویرایشگرهای اسناد یا فایل های میانبر پر نشده است.
`sha256 Checksum`	`string` فقط خروجی جمع چک SHA256 مرتبط با این فایل، در صورت وجود. این فیلد فقط برای فایل هایی با محتوای ذخیره شده در Google Drive پر شده است. برای ویرایشگرهای اسناد یا فایل های میانبر پر نشده است.
`inherited Permissions Disabled`	`boolean` آیا این فایل دارای مجوزهای ارثی غیرفعال است. مجوزهای ارثی به طور پیش فرض فعال هستند.

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

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

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

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

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

REST Resource: files

منبع: فایل

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

روش ها

`copy`

`create`

`delete`

`download`

`empty Trash`

`export`

`generate Ids`

`get`

`list`

`list Labels`

`modify Labels`

`update`

`watch`