Method: files.patch

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

คำขอ HTTP

PATCH https://www.googleapis.com/drive/v2/files/{fileId}

URL ใช้ไวยากรณ์ gRPC Transcoding

พารามิเตอร์เส้นทาง

พารามิเตอร์
fileId

string

รหัสของไฟล์ที่จะอัปเดต

พารามิเตอร์การค้นหา

พารามิเตอร์
addParents

string

รายการรหัสระดับบนสุดที่คั่นด้วยจุลภาคที่จะเพิ่ม

convert
(deprecated)

boolean

เลิกใช้งานแล้ว: พารามิเตอร์นี้ไม่มีฟังก์ชัน

enforceSingleParent
(deprecated)

boolean

เลิกใช้งานแล้ว: ระบบไม่รองรับการเพิ่มไฟล์ในหลายโฟลเดอร์อีกต่อไป ใช้ shortcuts แทน

modifiedDateBehavior

enum (ModifiedDateBehavior)

กําหนดลักษณะการทํางานที่จะอัปเดต modifiedDate การทํางานนี้จะแทนที่ setModifiedDate

newRevision

boolean

การอัปโหลด Blob ควรสร้างการแก้ไขใหม่หรือไม่ หากเป็น "เท็จ" ข้อมูล Blob ในการแก้ไขศีรษะปัจจุบันจะถูกแทนที่ หากตั้งค่าเป็น True หรือไม่ได้ตั้งค่า ระบบจะสร้าง Blob ใหม่เป็นการแก้ไขส่วนหัว และจะเก็บรักษาการแก้ไขที่ไม่ได้ตรึงก่อนหน้านี้ไว้เป็นระยะเวลาสั้นๆ ระบบจะเก็บการแก้ไขที่ตรึงไว้โดยไม่มีกําหนด โดยใช้โควต้าพื้นที่เก็บข้อมูลเพิ่มเติม แต่สูงสุด 200 รายการ โปรดดูรายละเอียดเกี่ยวกับวิธีเก็บรักษาการแก้ไขได้ที่ศูนย์ช่วยเหลือของไดรฟ์ โปรดทราบว่าระบบจะไม่สนใจช่องนี้หากไม่มีเปย์โหลดในคําขอ

ocr

boolean

จะอัปโหลด OCR ในไฟล์ .jpg, .png, .gif หรือ .pdf หรือไม่

ocrLanguage

string

หาก ocr เป็นจริง คําใบ้ที่ภาษาที่จะใช้ ค่าที่ถูกต้องคือรหัส BCP 47

pinned

boolean

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

removeParents

string

รายการรหัสระดับบนสุดที่คั่นด้วยจุลภาคที่จะนําออก

setModifiedDate

boolean

กําหนดวันที่แก้ไขโดยใช้ค่าที่ระบุในเนื้อหาคําขอหรือไม่ การตั้งค่าช่องนี้เป็น true จะเท่ากับ modifiedDateBehavior=fromBodyOrNow และ false เทียบเท่ากับ modifiedDateBehavior=now เพื่อป้องกันไม่ให้มีการเปลี่ยนแปลงวันที่แก้ไข modifiedDateBehavior=noChange

supportsAllDrives

boolean

แอปพลิเคชันที่ขอรองรับทั้งไดรฟ์ของฉันและไดรฟ์ที่แชร์หรือไม่

supportsTeamDrives
(deprecated)

boolean

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

timedTextLanguage

string

ภาษาของข้อความที่ระบุเวลา

timedTextTrackName

string

ชื่อแทร็กข้อความที่มีกําหนดเวลา

updateViewedDate

boolean

อัปเดตวันที่ดูไฟล์หลังจากอัปเดตสําเร็จหรือไม่

useContentAsIndexableText

boolean

เลือกว่าจะใช้เนื้อหาที่เป็นข้อความที่สามารถจัดทําดัชนีได้หรือไม่

includePermissionsForView

string

ระบุสิทธิ์การดูเพิ่มเติมที่จะรวมไว้ในคําตอบ รองรับเฉพาะ published เท่านั้น

includeLabels

string

รายการรหัสของป้ายกํากับที่คั่นด้วยจุลภาคที่จะรวมในส่วน labelInfo ของการตอบกลับ

เนื้อหาของคำขอ

เนื้อความของคำขอมีอินสแตนซ์ของ File

เนื้อหาการตอบกลับ

หากทำสำเร็จ เนื้อหาการตอบกลับจะมีอินสแตนซ์ File

ขอบเขตการให้สิทธิ์

ต้องการขอบเขต OAuth อย่างใดอย่างหนึ่งต่อไปนี้

  • https://www.googleapis.com/auth/docs
  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.appdata
  • https://www.googleapis.com/auth/drive.apps.readonly
  • https://www.googleapis.com/auth/drive.file
  • https://www.googleapis.com/auth/drive.metadata
  • https://www.googleapis.com/auth/drive.scripts

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