REST Resource: files

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

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

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

การแสดง JSON
{
  "exportLinks": {
    string: string,
    ...
  },
  "parents": [
    string
  ],
  "owners": [
    {
      object (User)
    }
  ],
  "permissions": [
    {
      object (Permission)
    }
  ],
  "spaces": [
    string
  ],
  "properties": {
    string: value,
    ...
  },
  "appProperties": {
    string: value,
    ...
  },
  "permissionIds": [
    string
  ],
  "contentRestrictions": [
    {
      object (ContentRestriction)
    }
  ],
  "kind": string,
  "driveId": string,
  "fileExtension": string,
  "copyRequiresWriterPermission": boolean,
  "md5Checksum": string,
  "contentHints": {
    "indexableText": string,
    "thumbnail": {
      "image": string,
      "mimeType": string
    }
  },
  "writersCanShare": boolean,
  "viewedByMe": boolean,
  "mimeType": string,
  "thumbnailLink": string,
  "iconLink": string,
  "shared": boolean,
  "lastModifyingUser": {
    object (User)
  },
  "headRevisionId": string,
  "sharingUser": {
    object (User)
  },
  "webViewLink": string,
  "webContentLink": string,
  "size": string,
  "viewersCanCopyContent": boolean,
  "hasThumbnail": boolean,
  "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,
  "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,
    "canChangeItemDownloadRestriction": boolean
  },
  "hasAugmentedPermissions": boolean,
  "trashingUser": {
    object (User)
  },
  "thumbnailVersion": string,
  "trashedTime": string,
  "modifiedByMe": boolean,
  "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
  },
  "resourceKey": string,
  "linkShareMetadata": {
    "securityUpdateEligible": boolean,
    "securityUpdateEnabled": boolean
  },
  "labelInfo": {
    "labels": [
      {
        object (Label)
      }
    ]
  },
  "sha1Checksum": string,
  "sha256Checksum": string,
  "inheritedPermissionsDisabled": boolean,
  "downloadRestrictions": {
    object (DownloadRestrictionsMetadata)
  }
}
ช่อง
parents[]

string

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

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

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

owners[]

object (User)

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

permissions[]

object (Permission)

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

spaces[]

string

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

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.0 คุณใช้คีย์ API เพื่อดึงข้อมูลพร็อพเพอร์ตี้ส่วนตัวไม่ได้

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

permissionIds[]

string

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

contentRestrictions[]

object (ContentRestriction)

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

kind

string

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

driveId

string

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

fileExtension

string

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

copyRequiresWriterPermission

boolean

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

md5Checksum

string

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

contentHints

object

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

contentHints.indexableText

string

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

shared

boolean

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

lastModifyingUser

object (User)

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

headRevisionId

string

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

sharingUser

object (User)

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

size

string (int64 format)

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

viewersCanCopyContent
(deprecated)

boolean

เลิกใช้งานแล้ว: โปรดใช้ copyRequiresWriterPermission แทน

hasThumbnail

boolean

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

folderColorRgb

string

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

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

id

string

รหัสของไฟล์

name

string

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

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)

sharedWithMeTime

string

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

quotaBytesUsed

string (int64 format)

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

version

string (int64 format)

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

originalFilename

string

ชื่อไฟล์เดิมของเนื้อหาที่อัปโหลด (หากมี) หรือค่าเดิมของฟิลด์ name ข้อมูลนี้มีอยู่สำหรับไฟล์ที่มีเนื้อหาไบนารีใน Google ไดรฟ์เท่านั้น

ownedByMe

boolean

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

fullFileExtension

string

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

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

isAppAuthorized

boolean

เอาต์พุตเท่านั้น แอปที่ขอสร้างหรือเปิดไฟล์

teamDriveId
(deprecated)

string

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

capabilities

object

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

capabilities.canChangeViewersCanCopyContent
(deprecated)

boolean

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

capabilities.canMoveChildrenOutOfDrive

boolean

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

capabilities.canReadDrive

boolean

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

capabilities.canEdit

boolean

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

capabilities.canCopy

boolean

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

capabilities.canComment

boolean

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

capabilities.canAddChildren

boolean

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

capabilities.canDelete

boolean

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

capabilities.canDownload

boolean

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

capabilities.canListChildren

boolean

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

capabilities.canRemoveChildren

boolean

เอาต์พุตเท่านั้น ระบุว่าผู้ใช้ปัจจุบันนำเด็กออกจากโฟลเดอร์นี้ได้หรือไม่ ซึ่งจะเป็น false เสมอเมื่อรายการไม่ใช่โฟลเดอร์ สำหรับโฟลเดอร์ในไดรฟ์ที่แชร์ ให้ใช้ 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

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

capabilities.canMoveChildrenOutOfTeamDrive
(deprecated)

boolean

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

capabilities.canMoveChildrenWithinTeamDrive
(deprecated)

boolean

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

capabilities.canTrashChildren

boolean

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

capabilities.canMoveItemOutOfDrive

boolean

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

capabilities.canAddMyDriveParent

boolean

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

capabilities.canRemoveMyDriveParent

boolean

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

capabilities.canMoveItemWithinDrive

boolean

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

capabilities.canShare

boolean

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

capabilities.canMoveChildrenWithinDrive

boolean

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

capabilities.canModifyContentRestriction
(deprecated)

boolean

เลิกใช้งานแล้ว: เอาต์พุตเท่านั้น ใช้ canModifyEditorContentRestriction, canModifyOwnerContentRestriction หรือ canRemoveContentRestriction

capabilities.canAddFolderFromAnotherDrive

boolean

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

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

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

capabilities.canChangeItemDownloadRestriction

boolean

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

hasAugmentedPermissions

boolean

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

trashingUser

object (User)

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

thumbnailVersion

string (int64 format)

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

trashedTime

string

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

modifiedByMe

boolean

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

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 สำหรับไฟล์เป้าหมาย

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

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

downloadRestrictions

object (DownloadRestrictionsMetadata)

มีการใช้ข้อจำกัดการดาวน์โหลดในไฟล์

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=true เท่านั้น

restrictionTime

string

เอาต์พุตเท่านั้น เวลาที่ตั้งค่าการจำกัดเนื้อหา (จัดรูปแบบวันที่และเวลา RFC 3339) จะป้อนข้อมูลหาก readOnly=true เท่านั้น

ownerRestricted

boolean

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

systemRestricted

boolean

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

DownloadRestrictionsMetadata

มีการใช้ข้อจำกัดการดาวน์โหลดกับไฟล์

การแสดง JSON
{
  "itemDownloadRestriction": {
    object (DownloadRestriction)
  },
  "effectiveDownloadRestrictionWithContext": {
    object (DownloadRestriction)
  }
}
ช่อง
itemDownloadRestriction

object (DownloadRestriction)

เจ้าของหรือผู้จัดการประชุมได้จำกัดการดาวน์โหลดไฟล์โดยตรง ซึ่งไม่ได้คำนึงถึงการตั้งค่าไดรฟ์ที่แชร์หรือกฎ DLP

effectiveDownloadRestrictionWithContext

object (DownloadRestriction)

เอาต์พุตเท่านั้น ข้อจำกัดการดาวน์โหลดที่มีผลซึ่งใช้กับไฟล์นี้ ซึ่งจะพิจารณาการตั้งค่าข้อจำกัดและกฎ DLP ทั้งหมด

DownloadRestriction

การจำกัดการคัดลอกและดาวน์โหลดไฟล์

การแสดง JSON
{
  "restrictedForReaders": boolean,
  "restrictedForWriters": boolean
}
ช่อง
restrictedForReaders

boolean

จำกัดการดาวน์โหลดและคัดลอกสำหรับผู้อ่านหรือไม่

restrictedForWriters

boolean

ไม่ว่าผู้เขียนจะถูกจำกัดการดาวน์โหลดและคัดลอกหรือไม่ หากtrue ผู้อ่านจะถูกจำกัดไม่ให้ดาวน์โหลดเช่นกัน

เมธอด

copy

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

create

สร้างไฟล์

delete

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

download

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

emptyTrash

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

export

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

generateIds

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

get

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

list

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

listLabels

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

modifyLabels

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

update

อัปเดตข้อมูลเมตา เนื้อหา หรือทั้ง 2 อย่างของไฟล์

watch

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