Method: files.update

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

วิธีการนี้รองรับ URI /upload และยอมรับสื่อที่อัปโหลดโดยมีลักษณะต่อไปนี้

  • ขนาดไฟล์สูงสุด: 5,120 GB
  • ประเภท MIME ของสื่อที่ยอมรับ:*/*

หมายเหตุ: โปรดระบุประเภท MIME ที่ถูกต้องแทนค่า */* ที่ตรงตัว */* เป็นตัวยึดตำแหน่งที่ใช้เพื่อระบุว่าสามารถอัปโหลดประเภท MIME ที่ถูกต้องได้

ดูข้อมูลเพิ่มเติมเกี่ยวกับการอัปโหลดไฟล์ได้ที่อัปโหลดข้อมูลไฟล์

คำขอ HTTP

  • URI การอัปโหลดสำหรับคำขออัปโหลดสื่อ:
    PATCH https://www.googleapis.com/upload/drive/v3/files/{fileId}
  • URI ของข้อมูลเมตาสำหรับคำขอข้อมูลเมตาเท่านั้น
    PATCH https://www.googleapis.com/drive/v3/files/{fileId}

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

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

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

string

รหัสของไฟล์

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

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

string

รายการรหัสผู้ปกครองที่จะเพิ่มซึ่งคั่นด้วยคอมมา

enforceSingleParent
(deprecated)

boolean

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

keepRevisionForever

boolean

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

ocrLanguage

string

คำแนะนำภาษาสำหรับการประมวลผล OCR ระหว่างการนำเข้ารูปภาพ (รหัส ISO 639-1)

removeParents

string

รายการรหัสผู้ปกครองที่คั่นด้วยคอมมาซึ่งจะนําออก

supportsAllDrives

boolean

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

supportsTeamDrives
(deprecated)

boolean

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

uploadType

string

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

ค่าที่ยอมรับมีดังนี้

useContentAsIndexableText

boolean

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

includePermissionsForView

string

ระบุสิทธิ์ของมุมมองเพิ่มเติมที่จะรวมไว้ในคำตอบ รองรับเฉพาะ "เผยแพร่แล้ว"

includeLabels

string

รายการรหัสของป้ายกำกับที่คั่นด้วยคอมมาเพื่อรวมไว้ในส่วนที่ labelInfo ของคำตอบ

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

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

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

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

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

ต้องใช้ขอบเขต OAuth ต่อไปนี้

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

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