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,
    "canDisableInheritedPermissions": boolean,
    "canEnableInheritedPermissions": 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,
  "inheritedPermissionsDisabled": boolean
}
ช่อง
kind

string

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

userPermission

object (Permission)

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

fileExtension

string

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

md5Checksum

string

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

ownerNames[]

string

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

lastModifyingUserName

string

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

editable
(deprecated)

boolean

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

writersCanShare

boolean

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

downloadUrl

string

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

mimeType

string

ประเภท MIME ของไฟล์ ข้อมูลนี้เปลี่ยนแปลงได้เฉพาะเมื่ออัปเดตขณะอัปโหลดเนื้อหาใหม่ คุณเว้นว่างช่องนี้ไว้ได้ ระบบจะกำหนด mimetype จากประเภท 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

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

spaces[]

string

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

folderColorRgb

string

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

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 จะอัปเดตวันที่ modifiedByMe ของผู้ใช้ที่ตั้งค่าวันที่ด้วย

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

permissionIds[]

string

เอาต์พุตเฉพาะไฟล์.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

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

sha256Checksum

string

เอาต์พุตเท่านั้น Checksum 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

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