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

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

contentHints.thumbnail

object

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

contentHints.thumbnail.image

string (bytes format)

ข้อมูลภาพขนาดย่อเข้ารหัสด้วย URL66 ที่ปลอดภัยต่อ 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)

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

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

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

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

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

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

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

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

เอาต์พุตเท่านั้น รูรับแสงที่ใช้ในการสร้างรูปภาพ (ตัวเลข)

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

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 ไดรฟ์เท่านั้น และจะไม่ป้อนข้อมูลเครื่องมือแก้ไขเอกสารหรือไฟล์ทางลัด

ข้อจํากัดเนื้อหา

ข้อจํากัดในการเข้าถึงเนื้อหาของไฟล์

การแสดง JSON
{
  "readOnly": boolean,
  "reason": string,
  "type": string,
  "restrictingUser": {
    object (User)
  },
  "restrictionTime": string,
  "ownerRestricted": boolean
}
ช่อง
readOnly

boolean

เนื้อหาของไฟล์เป็นแบบอ่านอย่างเดียว หากเป็นไฟล์แบบอ่านอย่างเดียว ระบบจะไม่เพิ่มการแก้ไขใหม่ของไฟล์ และอาจเพิ่มหรือแก้ไขความคิดเห็นไม่ได้ และอาจไม่มีการแก้ไขชื่อไฟล์

reason

string

สาเหตุที่มีการจํากัดเนื้อหาในไฟล์ โดยจะเปลี่ยนแปลงได้เฉพาะสําหรับคําขอที่ตั้งค่า readOnly=true ด้วยเท่านั้น

type

string

เอาต์พุตเท่านั้น ประเภทของการจํากัดเนื้อหา ปัจจุบันค่าที่เป็นไปได้มีเพียงค่าเดียวคือ globalContentRestriction

restrictingUser

object (User)

เอาต์พุตเท่านั้น ผู้ใช้ที่ตั้งค่าการจํากัดเนื้อหา เติมค่าเมื่อ readOnly เป็นจริงเท่านั้น

restrictionTime

string

เอาต์พุตเท่านั้น เวลาที่ตั้งค่าการจํากัดเนื้อหา (การประทับเวลา RFC 3339) เติมค่าเมื่อ readOnly เป็นจริงเท่านั้น

ownerRestricted

boolean

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

วิธีการ

copy

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

create

สร้างไฟล์ใหม่

delete

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

emptyTrash

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

export

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

generateIds

สร้างชุดรหัสไฟล์ที่จัดเตรียมได้ในคําขอสร้างหรือคัดลอก

get

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

list

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

listLabels

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

modifyLabels

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

update

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

watch

สมัครรับการเปลี่ยนแปลงในไฟล์