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 ไดรฟ์เท่านั้น จะไม่มีการป้อนข้อมูลให้กับเครื่องมือแก้ไขเอกสารหรือไฟล์ทางลัด

md5Checksum

string

เอาต์พุตเท่านั้น การตรวจสอบข้อผิดพลาด MD5 สำหรับเนื้อหาของไฟล์นี้ ช่องนี้จะป็อปปูเลตสำหรับไฟล์ที่มีเนื้อหาซึ่งจัดเก็บไว้ใน Google ไดรฟ์เท่านั้น จะไม่มีการป้อนข้อมูลให้กับเครื่องมือแก้ไขเอกสารหรือไฟล์ทางลัด

ownerNames[]

string

เอาต์พุตเท่านั้น ชื่อเจ้าของไฟล์นี้ ไม่ป้อนข้อมูลสำหรับรายการในไดรฟ์ที่แชร์

lastModifyingUserName

string

เอาต์พุตเท่านั้น ชื่อของผู้ใช้ล่าสุดที่จะแก้ไขไฟล์นี้

editable
(deprecated)

boolean

เอาต์พุตเท่านั้น เลิกใช้งานแล้ว: ใช้ capabilities/canEdit แทน

writersCanShare

boolean

ผู้เขียนจะแชร์เอกสารกับผู้ใช้คนอื่นๆ ได้หรือไม่ ไม่ป้อนข้อมูลสำหรับรายการในไดรฟ์ที่แชร์

downloadUrl

string

เอาต์พุตเท่านั้น URL การดาวน์โหลดที่มีอายุการใช้งานสั้นสำหรับไฟล์ ช่องนี้จะป็อปปูเลตสำหรับไฟล์ที่มีเนื้อหาซึ่งจัดเก็บไว้ใน Google ไดรฟ์เท่านั้น และจะไม่สร้างข้อมูลสำหรับ Google เอกสารหรือไฟล์ทางลัด

mimeType

string

ประเภท MIME ของไฟล์ การตั้งค่านี้จะเปลี่ยนแปลงได้เฉพาะในการอัปเดตเมื่ออัปโหลดเนื้อหาใหม่เท่านั้น สามารถเว้นช่องนี้ว่างไว้ได้ และจะกำหนดประเภท MIME จากประเภท MIME ของเนื้อหาที่อัปโหลด

driveId

string

เอาต์พุตเท่านั้น รหัสของไดรฟ์ที่แชร์ที่มีไฟล์อยู่ ระบบจะป้อนข้อมูลให้กับรายการในไดรฟ์ที่แชร์เท่านั้น

parents[]

object (ParentReference)

คอลเล็กชันของโฟลเดอร์หลักที่มีไฟล์นี้

หากไม่ระบุเป็นส่วนหนึ่งของคำขอแทรก ระบบจะวางไฟล์ไว้ในโฟลเดอร์ไดรฟ์ของฉันของผู้ใช้โดยตรง หากไม่ได้ระบุว่าเป็นส่วนหนึ่งของคำขอคัดลอก ไฟล์จะรับค่าระดับบนที่ค้นพบได้ของไฟล์ต้นฉบับ คำขอ files.update ยังใช้พารามิเตอร์ addParents และ removeParents เพื่อแก้ไขรายการระดับบนสุดได้ด้วย

appDataContents

boolean

เอาต์พุตเท่านั้น ไฟล์นี้อยู่ในโฟลเดอร์ Application Data หรือไม่

shared

boolean

เอาต์พุตเท่านั้น แชร์ไฟล์แล้วหรือไม่ ไม่ป้อนข้อมูลสำหรับรายการในไดรฟ์ที่แชร์

lastModifyingUser

object (User)

เอาต์พุตเท่านั้น ผู้ใช้คนสุดท้ายที่แก้ไขไฟล์นี้

owners[]

object (User)

เอาต์พุตเท่านั้น เจ้าของไฟล์นี้ มีเพียงไฟล์เดิมบางไฟล์เท่านั้นที่มีเจ้าของได้มากกว่า 1 คน ระบบจะไม่ป้อนข้อมูลในช่องนี้ให้กับรายการในไดรฟ์ที่แชร์

headRevisionId

string

เอาต์พุตเท่านั้น รหัสการแก้ไขส่วนหัวของไฟล์ ช่องนี้จะป็อปปูเลตสำหรับไฟล์ที่มีเนื้อหาซึ่งจัดเก็บไว้ใน Google ไดรฟ์เท่านั้น จะไม่มีการป้อนข้อมูลให้กับเครื่องมือแก้ไขเอกสารหรือไฟล์ทางลัด

properties[]

object (Property)

รายการที่พัก

copyable
(deprecated)

boolean

เอาต์พุตเท่านั้น เลิกใช้งานแล้ว: ใช้ capabilities/canCopy แทน

etag

string

เอาต์พุตเท่านั้น ETag ของไฟล์

sharingUser

object (User)

เอาต์พุตเท่านั้น ผู้ใช้ที่แชร์รายการกับผู้ใช้ปัจจุบัน หากมี

fileSize

string (int64 format)

เอาต์พุตเท่านั้น ขนาดเป็นไบต์ของ BLOB และไฟล์ตัวแก้ไขของบุคคลที่หนึ่ง ระบบจะไม่ป้อนข้อมูลสำหรับไฟล์ที่ไม่มีขนาด เช่น ทางลัดและโฟลเดอร์

copyRequiresWriterPermission

boolean

ควรปิดใช้ตัวเลือกในการคัดลอก พิมพ์ หรือดาวน์โหลดไฟล์นี้สำหรับผู้อ่านและผู้แสดงความคิดเห็นหรือไม่

permissions[]

object (Permission)

เอาต์พุตเท่านั้น รายการสิทธิ์สำหรับผู้ใช้ที่มีสิทธิ์เข้าถึงไฟล์นี้ ไม่ป้อนข้อมูลสำหรับรายการในไดรฟ์ที่แชร์

hasThumbnail

boolean

เอาต์พุตเท่านั้น ไฟล์นี้มีภาพขนาดย่อหรือไม่ ซึ่งไม่ได้ระบุว่าแอปที่ขอมีสิทธิ์เข้าถึงภาพขนาดย่อหรือไม่ หากต้องการตรวจสอบสิทธิ์เข้าถึง ให้มองหาช่องภาพขนาดย่อของภาพขนาดย่อ

spaces[]

string

เอาต์พุตเท่านั้น รายการพื้นที่ทำงานที่มีไฟล์นี้ ค่าที่รองรับคือ drive, appDataFolder และ photos

folderColorRgb

string

โฟลเดอร์สีเป็นสตริงเลขฐานสิบหก RGB หากไฟล์นั้นเป็นโฟลเดอร์หรือทางลัดไปยังโฟลเดอร์ รายการสีที่รองรับจะอยู่ในช่องโฟลเดอร์ColorPalette ของทรัพยากร "เกี่ยวกับ" หากระบุสีที่ไม่รองรับ ระบบจะเปลี่ยนเป็นสีที่ใกล้เคียงที่สุดในจานสี

id

string

รหัสของไฟล์

title

string

ชื่อของไฟล์นี้ โปรดทราบว่าสำหรับรายการที่เปลี่ยนแปลงไม่ได้ เช่น โฟลเดอร์ระดับบนสุดของไดรฟ์ที่แชร์ โฟลเดอร์รูทในไดรฟ์ของฉัน และโฟลเดอร์ข้อมูลแอปพลิเคชัน ชื่อจะไม่เปลี่ยนแปลง

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) โปรดทราบว่าการตั้งค่า EditDate จะอัปเดตวันที่ changedByMe สำหรับผู้ใช้ที่กำหนดวันที่ด้วย

lastViewedByMeDate

string

เวลาล่าสุดที่ผู้ใช้ดูไฟล์นี้ (รูปแบบการประทับเวลา RFC 3339)

markedViewedByMeDate
(deprecated)

string

เอาต์พุตเท่านั้น เลิกใช้งานแล้ว

sharedWithMeDate

string

เอาต์พุตเท่านั้น เวลาที่แชร์ไฟล์นี้กับผู้ใช้ (ในรูปแบบการประทับเวลา RFC 3339)

quotaBytesUsed

string (int64 format)

เอาต์พุตเท่านั้น จำนวนไบต์ของโควต้าที่ไฟล์นี้ใช้

version

string (int64 format)

เอาต์พุตเท่านั้น หมายเลขเวอร์ชันที่เพิ่มขึ้นของไฟล์ซ้ำๆ กัน ข้อมูลนี้แสดงถึงการเปลี่ยนแปลงทั้งหมดที่เกิดขึ้นกับไฟล์ในเซิร์ฟเวอร์ แม้แต่การเปลี่ยนแปลงที่ผู้ใช้ที่ส่งคำขอมองไม่เห็นก็ตาม

indexableText

object

แอตทริบิวต์ข้อความที่จัดทำดัชนีได้สำหรับไฟล์ (เขียนได้เท่านั้น)

indexableText.text

string

ข้อความที่จะจัดทำดัชนีสำหรับไฟล์นี้

originalFilename

string

ชื่อไฟล์ต้นฉบับของเนื้อหาที่อัปโหลด (หากมี) หรือค่าเดิมของช่อง title วิธีนี้ใช้ได้กับไฟล์ที่มีเนื้อหาไบนารีใน Google ไดรฟ์เท่านั้น

ownedByMe

boolean

เอาต์พุตเท่านั้น ไฟล์เป็นของผู้ใช้ปัจจุบันหรือไม่ ไม่ป้อนข้อมูลสำหรับรายการในไดรฟ์ที่แชร์

canComment
(deprecated)

boolean

เอาต์พุตเท่านั้น เลิกใช้งานแล้ว: ใช้ capabilities/canComment แทน

shareable
(deprecated)

boolean

เอาต์พุตเท่านั้น เลิกใช้งานแล้ว: ใช้ capabilities/canShare แทน

fullFileExtension

string

เอาต์พุตเท่านั้น นามสกุลไฟล์แบบเต็ม แยกออกมาจากชื่อ อาจมีส่วนขยายหลายรายการที่เชื่อมถึงกัน เช่น "tar.gz" การนำส่วนขยายออกจากชื่อไม่ได้ล้างช่องนี้ อย่างไรก็ตาม การเปลี่ยนชื่อส่วนขยายในชื่อ จะอัปเดตฟิลด์นี้ด้วย ช่องนี้จะป็อปปูเลตสำหรับไฟล์ที่มีเนื้อหาซึ่งจัดเก็บไว้ใน Google ไดรฟ์เท่านั้น จะไม่มีการป้อนข้อมูลให้กับเครื่องมือแก้ไขเอกสารหรือไฟล์ทางลัด

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

เอาต์พุตเท่านั้น ผู้ใช้ปัจจุบันจะเพิ่มโฟลเดอร์จากไดรฟ์ (ไดรฟ์ที่แชร์อื่นหรือไดรฟ์ของฉัน) ลงในโฟลเดอร์นี้ได้หรือไม่ ซึ่งจะเป็นเท็จเมื่อรายการไม่ใช่โฟลเดอร์ ระบบจะป้อนข้อมูลให้กับรายการในไดรฟ์ที่แชร์เท่านั้น

capabilities.canChangeSecurityUpdateEnabled

boolean

เอาต์พุตเท่านั้น ผู้ใช้ปัจจุบันสามารถเปลี่ยนช่อง safetyUpdateEnabled ในข้อมูลเมตาการแชร์ลิงก์ได้หรือไม่

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

สตริงที่เข้ารหัสฐาน 64

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-number)

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 ไดรฟ์เท่านั้น จะไม่มีการป้อนข้อมูลให้กับเครื่องมือแก้ไขเอกสารหรือไฟล์ทางลัด

sha256Checksum

string

เอาต์พุตเท่านั้น ผลรวมตรวจสอบ SHA256 ที่เชื่อมโยงกับไฟล์นี้ (หากมี) ช่องนี้จะป็อปปูเลตสำหรับไฟล์ที่มีเนื้อหาซึ่งจัดเก็บไว้ใน Google ไดรฟ์เท่านั้น จะไม่มีการป้อนข้อมูลให้กับเครื่องมือแก้ไขเอกสารหรือไฟล์ทางลัด

ContentRestriction

ข้อจำกัดในการเข้าถึงเนื้อหาของไฟล์

การแสดง 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

ติดตามการเปลี่ยนแปลงในไฟล์