REST Resource: files

منبع: فایل

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

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

نمایندگی 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

فقط خروجی نوع فایل. این همیشه drive#file است.

userPermission

object ( Permission )

فقط خروجی مجوزهای کاربر احراز هویت شده در این فایل.

fileExtension

string

فقط خروجی جزء نهایی fullFileExtension با متن انتهایی که به نظر نمی رسد بخشی از پسوند حذف شده باشد. این فیلد فقط برای فایل هایی با محتوای ذخیره شده در Google Drive پر شده است. برای ویرایشگرهای اسناد یا فایل های میانبر پر نشده است.

md5Checksum

string

فقط خروجی یک چک جمع MD5 برای محتوای این فایل. این فیلد فقط برای فایل هایی با محتوای ذخیره شده در Google Drive پر شده است. برای ویرایشگرهای اسناد یا فایل های میانبر پر نشده است.

ownerNames[]

string

فقط خروجی نام(های) صاحب(های) این فایل. برای موارد موجود در درایوهای مشترک پر نشده است.

lastModifyingUserName

string

فقط خروجی نام آخرین کاربری که این فایل را تغییر داده است.

editable
(deprecated)

boolean

فقط خروجی منسوخ شده: به جای آن از capabilities/canEdit استفاده کنید.

writersCanShare

boolean

آیا نویسندگان می توانند سند را با سایر کاربران به اشتراک بگذارند یا خیر. برای موارد موجود در درایوهای مشترک پر نشده است.

downloadUrl

string

فقط خروجی URL دانلود کوتاه مدت برای فایل. این فیلد فقط برای فایل هایی با محتوای ذخیره شده در Google Drive پر شده است. برای Google Docs یا فایل های میانبر پر نشده است.

mimeType

string

نوع MIME فایل. این فقط هنگام آپدیت در هنگام آپلود محتوای جدید قابل تغییر است. این قسمت را می توان خالی گذاشت و نوع mime از نوع MIME محتوای آپلود شده تعیین می شود.

driveId

string

فقط خروجی شناسه درایو مشترک که فایل در آن قرار دارد. فقط برای موارد موجود در درایوهای مشترک پر شده است.

parents[]

object ( ParentReference )

شناسه پوشه والد حاوی فایل.

یک فایل فقط می تواند یک پوشه والد داشته باشد. تعیین چند والدین پشتیبانی نمی شود.

اگر به عنوان بخشی از درخواست درج مشخص نشده باشد، فایل مستقیماً در پوشه My Drive کاربر قرار می گیرد. اگر به عنوان بخشی از درخواست کپی مشخص نشده باشد، فایل هر والد قابل کشف فایل منبع را به ارث می برد. درخواست های files.update باید از پارامترهای addParents و removeParents برای اصلاح لیست والدین استفاده کنند.

appDataContents

boolean

فقط خروجی آیا این فایل در پوشه Application Data قرار دارد یا خیر.

shared

boolean

فقط خروجی اینکه آیا فایل به اشتراک گذاشته شده است. برای موارد موجود در درایوهای مشترک پر نشده است.

lastModifyingUser

object ( User )

فقط خروجی آخرین کاربری که این فایل را تغییر داده است. این فیلد فقط زمانی پر می شود که آخرین تغییر توسط یک کاربر وارد شده انجام شده باشد.

owners[]

object ( User )

فقط خروجی صاحب این فایل فقط برخی از فایل‌های قدیمی ممکن است بیش از یک مالک داشته باشند. این فیلد برای موارد موجود در درایوهای مشترک پر نشده است.

headRevisionId

string

فقط خروجی شناسه ویرایش سر فایل. این فیلد فقط برای فایل هایی با محتوای ذخیره شده در Google Drive پر شده است. برای ویرایشگرهای اسناد یا فایل های میانبر پر نشده است.

properties[]

object ( Property )

لیست املاک.

copyable
(deprecated)

boolean

فقط خروجی منسوخ شده: به جای آن از capabilities/canCopy استفاده کنید.

etag

string

فقط خروجی ETag فایل

sharingUser

object ( User )

فقط خروجی کاربری که در صورت موجود بودن، مورد را با کاربر فعلی به اشتراک گذاشته است.

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.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

برای تغییرات یک فایل مشترک می شود.