REST Resource: files

แหล่งข้อมูล: ไฟล์

ข้อมูลเมตาของไฟล์

เมธอดทรัพยากรบางรายการ (เช่น files.update) ต้องใช้ fileId ใช้เมธอด files.list เพื่อเรียกข้อมูลรหัสของไฟล์

การแสดง JSON
{
  "ownerNames": [
    string
  ],
  "exportLinks": {
    string: string,
    ...
  },
  "parents": [
    {
      object (ParentReference)
    }
  ],
  "owners": [
    {
      object (User)
    }
  ],
  "openWithLinks": {
    string: string,
    ...
  },
  "properties": [
    {
      object (Property)
    }
  ],
  "permissions": [
    {
      object (Permission)
    }
  ],
  "spaces": [
    string
  ],
  "permissionIds": [
    string
  ],
  "contentRestrictions": [
    {
      object (ContentRestriction)
    }
  ],
  "kind": string,
  "userPermission": {
    object (Permission)
  },
  "fileExtension": string,
  "md5Checksum": string,
  "selfLink": string,
  "lastModifyingUserName": string,
  "editable": boolean,
  "writersCanShare": boolean,
  "downloadUrl": string,
  "mimeType": string,
  "driveId": string,
  "thumbnailLink": string,
  "appDataContents": boolean,
  "webViewLink": string,
  "iconLink": string,
  "shared": boolean,
  "lastModifyingUser": {
    object (User)
  },
  "defaultOpenWithLink": string,
  "headRevisionId": string,
  "copyable": boolean,
  "etag": string,
  "sharingUser": {
    object (User)
  },
  "alternateLink": string,
  "embedLink": string,
  "webContentLink": string,
  "fileSize": string,
  "copyRequiresWriterPermission": boolean,
  "hasThumbnail": boolean,
  "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,
    "canDisableInheritedPermissions": boolean,
    "canEnableInheritedPermissions": boolean
  },
  "hasAugmentedPermissions": boolean,
  "trashingUser": {
    object (User)
  },
  "canReadRevisions": boolean,
  "thumbnailVersion": string,
  "trashedDate": 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
  },
  "resourceKey": string,
  "linkShareMetadata": {
    "securityUpdateEligible": boolean,
    "securityUpdateEnabled": boolean
  },
  "labelInfo": {
    "labels": [
      {
        object (Label)
      }
    ]
  },
  "sha1Checksum": string,
  "sha256Checksum": string,
  "inheritedPermissionsDisabled": boolean
}
ช่อง
ownerNames[]

string

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

parents[]

object (ParentReference)

รหัสของโฟลเดอร์หลักที่มีไฟล์อยู่

ไฟล์มีโฟลเดอร์หลักได้เพียงโฟลเดอร์เดียว ระบบไม่รองรับการระบุโฟลเดอร์หลักหลายโฟลเดอร์

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

owners[]

object (User)

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

properties[]

object (Property)

รายการพร็อพเพอร์ตี้

permissions[]

object (Permission)

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

spaces[]

string

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

permissionIds[]

string

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

contentRestrictions[]

object (ContentRestriction)

ข้อจำกัดในการเข้าถึงเนื้อหาของไฟล์ จะป้อนข้อมูลก็ต่อเมื่อมีข้อจำกัดดังกล่าว

kind

string

เอาต์พุตเท่านั้น ประเภทของไฟล์ ซึ่งจะdrive#fileเสมอ

userPermission

object (Permission)

เอาต์พุตเท่านั้น สิทธิ์สำหรับผู้ใช้ที่ตรวจสอบสิทธิ์แล้วในไฟล์นี้

fileExtension

string

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

md5Checksum

string

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

lastModifyingUserName

string

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

editable
(deprecated)

boolean

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

writersCanShare

boolean

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

downloadUrl

string

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

mimeType

string

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

driveId

string

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

appDataContents

boolean

เอาต์พุตเท่านั้น ไฟล์นี้อยู่ในโฟลเดอร์ข้อมูลแอปพลิเคชันหรือไม่

shared

boolean

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

lastModifyingUser

object (User)

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

headRevisionId

string

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

copyable
(deprecated)

boolean

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

etag

string

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

sharingUser

object (User)

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

fileSize

string (int64 format)

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

copyRequiresWriterPermission

boolean

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

hasThumbnail

boolean

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

folderColorRgb

string

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

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

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

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

capabilities.canAcceptOwnership

boolean

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

capabilities.canReadLabels

boolean

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

capabilities.canModifyLabels

boolean

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

capabilities.canModifyEditorContentRestriction

boolean

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

capabilities.canModifyOwnerContentRestriction

boolean

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

capabilities.canRemoveContentRestriction

boolean

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

capabilities.canDisableInheritedPermissions

boolean

เอาต์พุตเท่านั้น ผู้ใช้ปิดใช้สิทธิ์ที่รับช่วงมาได้หรือไม่

capabilities.canEnableInheritedPermissions

boolean

เอาต์พุตเท่านั้น ผู้ใช้จะเปิดใช้สิทธิ์ที่รับช่วงมาอีกครั้งได้หรือไม่

hasAugmentedPermissions

boolean

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

trashingUser

object (User)

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

canReadRevisions
(deprecated)

boolean

เอาต์พุตเท่านั้น เลิกใช้งานแล้ว: โปรดใช้ capabilities/canReadRevisions แทน

thumbnailVersion

string (int64 format)

เอาต์พุตเท่านั้น เวอร์ชันภาพขนาดย่อสำหรับใช้ในการล้างข้อมูลแคชภาพขนาดย่อ

trashedDate

string

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

thumbnail

object

ภาพขนาดย่อของไฟล์ ระบบจะใช้ภาพนี้ก็ต่อเมื่อสร้างภาพขนาดย่อมาตรฐานไม่ได้

thumbnail.image

string (bytes format)

ไบต์ที่เข้ารหัส Base64 ที่ปลอดภัยสำหรับ URL ของภาพขนาดย่อ ควรเป็นไปตามส่วนที่ 5 ของ RFC 4648

สตริงที่เข้ารหัส 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 สำหรับไฟล์เป้าหมาย

resourceKey

string

เอาต์พุตเท่านั้น คีย์ที่จำเป็นในการเข้าถึงรายการผ่านลิงก์ที่แชร์

linkShareMetadata.securityUpdateEligible

boolean

เอาต์พุตเท่านั้น ไฟล์มีสิทธิ์รับการอัปเดตความปลอดภัยหรือไม่

linkShareMetadata.securityUpdateEnabled

boolean

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

labelInfo

object

เอาต์พุตเท่านั้น ภาพรวมของป้ายกำกับในไฟล์

labelInfo.labels[]

object (Label)

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

sha1Checksum

string

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

sha256Checksum

string

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

inheritedPermissionsDisabled

boolean

ไฟล์นี้ปิดใช้สิทธิ์ที่รับช่วงมาหรือไม่ ระบบจะเปิดใช้สิทธิ์ที่รับช่วงมาโดยค่าเริ่มต้น

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

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