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

string

เอาต์พุตเท่านั้น ระบุประเภทของทรัพยากร ค่า: สตริงคงที่ "drive#file"

driveId

string

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

fileExtension

string

เอาต์พุตเท่านั้น คอมโพเนนต์สุดท้ายของ fullFileExtension ข้อมูลนี้มีอยู่สำหรับไฟล์ที่มีเนื้อหาไบนารีใน Google ไดรฟ์เท่านั้น

copyRequiresWriterPermission

boolean

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

md5Checksum

string

เอาต์พุตเท่านั้น Checksum MD5 สำหรับเนื้อหาของไฟล์ การดำเนินการนี้ใช้ได้กับไฟล์ที่มีเนื้อหาไบนารีใน Google ไดรฟ์เท่านั้น

contentHints

object

ข้อมูลเพิ่มเติมเกี่ยวกับเนื้อหาของไฟล์ ฟิลด์เหล่านี้จะไม่มีข้อมูลในคำตอบ

contentHints.indexableText

string

ข้อความที่จะจัดทําดัชนีสําหรับไฟล์เพื่อปรับปรุงการค้นหาแบบ FullText ไฟล์นี้มีขนาดไม่เกิน 128 KB และอาจมีองค์ประกอบ HTML

contentHints.thumbnail

object

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

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

หากสร้างไฟล์ด้วยประเภท MIME ของ Google เอกสาร ระบบจะนำเข้าเนื้อหาที่อัปโหลด (หากเป็นไปได้) รูปแบบการนําเข้าที่รองรับจะเผยแพร่ในแหล่งข้อมูล "เกี่ยวกับ"

parents[]

string

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

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

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

shared

boolean

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

lastModifyingUser

object (User)

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

owners[]

object (User)

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

headRevisionId

string

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

sharingUser

object (User)

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

size

string (int64 format)

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

viewersCanCopyContent
(deprecated)

boolean

เลิกใช้งานแล้ว: ให้ใช้ copyRequiresWriterPermission แทน

permissions[]

object (Permission)

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

hasThumbnail

boolean

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

spaces[]

string

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

folderColorRgb

string

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

หากระบุสีที่ไม่รองรับ ระบบจะใช้สีที่ใกล้เคียงที่สุดในจานสีแทน

id

string

รหัสของไฟล์

name

string

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

description

string

คำอธิบายสั้นๆ ของไฟล์

starred

boolean

ผู้ใช้ติดดาวไฟล์หรือไม่

trashed

boolean

ไฟล์ถูกทิ้งหรือไม่ ไม่ว่าจะทิ้งอย่างชัดเจนหรือจากโฟลเดอร์หลักที่ทิ้ง เฉพาะเจ้าของเท่านั้นที่ทิ้งไฟล์ได้ และผู้ใช้รายอื่นจะไม่เห็นไฟล์ในถังขยะของเจ้าของ

explicitlyTrashed

boolean

เอาต์พุตเท่านั้น ไฟล์ถูกทิ้งอย่างชัดแจ้งหรือไม่ แทนที่จะทิ้งแบบซ้ำๆ จากโฟลเดอร์หลัก

createdTime

string

เวลาที่สร้างไฟล์ (รูปแบบวันที่และเวลา RFC 3339)

modifiedTime

string

ครั้งล่าสุดที่มีผู้แก้ไขไฟล์ (วันที่และเวลา RFC 3339)

โปรดทราบว่าการตั้งค่า modifiedTime จะอัปเดต modifiedByMeTime ให้กับผู้ใช้ด้วย

modifiedByMeTime

string

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

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 ไดรฟ์เท่านั้น

ownedByMe

boolean

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

fullFileExtension

string

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

ข้อมูลนี้จะอัปเดตโดยอัตโนมัติเมื่อช่อง name มีการเปลี่ยนแปลง แต่จะไม่ล้างข้อมูลหากชื่อใหม่ไม่มีนามสกุลที่ถูกต้อง

properties

map (key: string, value: value (Value format))

คอลเล็กชันคู่คีย์-ค่าที่กำหนดเองซึ่งแอปทั้งหมดมองเห็นได้

ระบบจะล้างรายการที่มีค่า Null ในคำขออัปเดตและคัดลอก

ออบเจ็กต์ที่มีรายการคู่ "key": value ตัวอย่าง: { "name": "wrench", "mass": "1.3kg", "count": "3" }

appProperties

map (key: string, value: value (Value format))

ชุดคู่คีย์-ค่าที่กำหนดเองซึ่งจะเป็นข้อมูลส่วนตัวของแอปที่ส่งคำขอ

ระบบจะล้างรายการที่มีค่า Null ในคำขออัปเดตและคัดลอก

พร็อพเพอร์ตี้เหล่านี้จะเรียกดูได้โดยใช้คำขอที่ตรวจสอบสิทธิ์แล้วเท่านั้น คำขอที่ตรวจสอบสิทธิ์แล้วจะใช้โทเค็นการเข้าถึงที่ได้รับจากรหัสไคลเอ็นต์ 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

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

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)

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

thumbnailVersion

string (int64 format)

เอาต์พุตเท่านั้น เวอร์ชันภาพปกสำหรับใช้ในสถานะแคชภาพปกไม่ถูกต้อง

trashedTime

string

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

modifiedByMe

boolean

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

permissionIds[]

string

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

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 ตั้งค่าได้ในคำขอ files.create เท่านั้น

shortcutDetails.targetId

string

รหัสของไฟล์ที่ทางลัดนี้ชี้ไป ตั้งค่าได้ในคำขอ files.create เท่านั้น

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

ลบไฟล์ของผู้ใช้อย่างถาวรโดยไม่ย้ายไฟล์ไปที่ถังขยะ

download

ดาวน์โหลดเนื้อหาของไฟล์

emptyTrash

ลบไฟล์ทั้งหมดในถังขยะของผู้ใช้อย่างถาวร

export

ส่งออกเอกสาร Google Workspace ไปยังประเภท MIME ที่ขอและแสดงผลเนื้อหาไบต์ที่ส่งออก

generateIds

สร้างชุดรหัสไฟล์ซึ่งระบุได้ในคำขอสร้างหรือคัดลอก

get

รับข้อมูลเมตาหรือเนื้อหาของไฟล์ตามรหัส

list

แสดงรายการไฟล์ของผู้ใช้

listLabels

แสดงรายการป้ายกำกับในไฟล์

modifyLabels

แก้ไขชุดป้ายกำกับที่ใช้กับไฟล์

update

อัปเดตข้อมูลเมตาและ/หรือเนื้อหาของไฟล์

watch

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