Method: files.patch

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

คำขอ 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

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

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