Method: files.patch

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

คำขอ HTTP

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

URL ใช้ไวยากรณ์การแปลง gRPC

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

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

string

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

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

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

string

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

boolean

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

boolean

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

enum (ModifiedDateBehavior)

กำหนดพฤติกรรมที่ modifiedDate จะอัปเดต การดำเนินการนี้จะลบล้าง setModifiedDate
newRevision

boolean

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

boolean

ระบุว่าจะพยายาม OCR เมื่อมีการอัปโหลดไฟล์ .jpg, .png, .gif หรือ .pdf
ocrLanguage

string

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

boolean

ต้องการปักหมุดการแก้ไขใหม่หรือไม่ ไฟล์ 1 ไฟล์จะมีการแก้ไขที่ปักหมุดไว้ได้สูงสุด 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

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