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
  },
  "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
}
ช่อง
kind

string

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

driveId

string

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

fileExtension

string

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

copyRequiresWriterPermission

boolean

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

md5Checksum

string

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

contentHints

object

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

contentHints.indexableText

string

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

contentHints.thumbnail

object

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

contentHints.thumbnail.image

string (bytes format)

ข้อมูลภาพขนาดย่อที่เข้ารหัสด้วย Base64 ที่ปลอดภัยต่อ URL (RFC 4648 ส่วนที่ 5)

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

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

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

spaces[]

string

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

folderColorRgb

string

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

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

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 มีการเปลี่ยนแปลง แต่ระบบจะไม่ล้างออกหากชื่อใหม่ไม่มีส่วนขยายที่ถูกต้อง

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

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

capabilities.canAcceptOwnership

boolean

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

capabilities.canReadLabels

boolean

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

capabilities.canModifyLabels

boolean

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

capabilities.canModifyEditorContentRestriction

boolean

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

capabilities.canModifyOwnerContentRestriction

boolean

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

capabilities.canRemoveContentRestriction

boolean

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

hasAugmentedPermissions

boolean

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

trashingUser

object (User)

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

thumbnailVersion

string (int64 format)

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

trashedTime

string

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

modifiedByMe

boolean

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

permissionIds[]

string

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

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)

imageMediaMetadata.cameraMake

string

เอาต์พุตเท่านั้น ยี่ห้อกล้องที่ใช้สร้างรูปภาพ

imageMediaMetadata.cameraModel

string

เอาต์พุตเท่านั้น รุ่นของกล้องที่ใช้สร้างสรรค์ภาพ

imageMediaMetadata.exposureTime

number

เอาต์พุตเท่านั้น ระยะเวลาการรับแสงในหน่วยวินาที

imageMediaMetadata.aperture

number

เอาต์พุตเท่านั้น รูรับแสงที่ใช้สร้างรูปภาพ (f-number)

imageMediaMetadata.focalLength

number

เอาต์พุตเท่านั้น ความยาวโฟกัสที่ใช้ในการสร้างรูปภาพ หน่วยเป็นมิลลิเมตร

imageMediaMetadata.isoSpeed

integer

เอาต์พุตเท่านั้น ความเร็ว ISO ที่ใช้ในการสร้างรูปภาพ

imageMediaMetadata.exposureBias

number

เอาต์พุตเท่านั้น การชดเชยแสงของรูปภาพ (ค่า APEX)

imageMediaMetadata.maxApertureValue

number

เอาต์พุตเท่านั้น ค่า F ที่น้อยที่สุดของเลนส์ความยาวโฟกัสที่ใช้ในการสร้างรูปภาพ (ค่า APEX)

imageMediaMetadata.subjectDistance

integer

เอาต์พุตเท่านั้น ระยะห่างจากวัตถุในรูปภาพหน่วยเป็นเมตร

imageMediaMetadata.lens

string

เอาต์พุตเท่านั้น เลนส์ที่ใช้สร้างรูปภาพ

videoMediaMetadata

object

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

videoMediaMetadata.width

integer

เอาต์พุตเท่านั้น ความกว้างของวิดีโอเป็นพิกเซล

videoMediaMetadata.height

integer

เอาต์พุตเท่านั้น ความสูงของวิดีโอเป็นพิกเซล

videoMediaMetadata.durationMillis

string (int64 format)

เอาต์พุตเท่านั้น ระยะเวลาของวิดีโอเป็นมิลลิวินาที

shortcutDetails

object

รายละเอียดไฟล์ทางลัด ระบบจะป้อนข้อมูลสำหรับไฟล์ทางลัดเท่านั้น ซึ่งตั้งค่าช่อง mimeType เป็น application/vnd.google-apps.shortcut ตั้งค่าได้ในคำขอ files.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

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

sha256Checksum

string

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

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

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

emptyTrash

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

export

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

generateIds

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

get

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

list

แสดงไฟล์ของผู้ใช้

listLabels

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

modifyLabels

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

update

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

watch

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