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

เอาต์พุตเท่านั้น ผลรวมตรวจสอบ 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

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

spaces[]

string

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

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

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

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

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 DateTime)

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-number ที่น้อยที่สุดของเลนส์ความยาวโฟกัสที่ใช้สร้างรูปภาพ (ค่า 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

shortcutDetails.targetId

string

รหัสของไฟล์ที่ทางลัดนี้ชี้ไป

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

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