REST Resource: files

منبع: فایل

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

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

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

فقط خروجی مشخص می کند که این چه نوع منبعی است. مقدار: رشته ثابت "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 منتشر شده است.

parents[]

string

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

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

shared

boolean

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

lastModifyingUser

object ( User )

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

owners[]

object ( User )

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

headRevisionId

string

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

sharingUser

object ( User )

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

size

string ( int64 format)

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

viewersCanCopyContent
(deprecated)

boolean

منسوخ شده: به جای آن از copyRequiresWriterPermission استفاده کنید.

permissions[]

object ( Permission )

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

hasThumbnail

boolean

فقط خروجی آیا این فایل یک تصویر کوچک دارد. این نشان نمی دهد که آیا برنامه درخواست کننده به تصویر کوچک دسترسی دارد یا خیر. برای بررسی دسترسی، به دنبال وجود قسمت 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 تنظیم شده است.

shortcutDetails.targetId

string

شناسه فایلی که این میانبر به آن اشاره می کند.

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)
  },
  "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

یک فایل متعلق به کاربر را بدون انتقال آن به سطل زباله برای همیشه حذف می کند.

emptyTrash

تمام فایل های حذف شده کاربر را برای همیشه حذف می کند.

export

یک سند Google Workspace را به نوع MIME درخواستی صادر می کند و محتوای بایت صادر شده را برمی گرداند.

generateIds

مجموعه ای از شناسه های فایل را ایجاد می کند که می توانند در درخواست های ایجاد یا کپی ارائه شوند.

get

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

list

فایل های کاربر را لیست می کند.

listLabels

برچسب های روی یک فایل را فهرست می کند.

modifyLabels

مجموعه ای از برچسب های اعمال شده روی یک فایل را تغییر می دهد.

update

فراداده و/یا محتوای یک فایل را به روز می کند.

watch

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