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

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

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

string

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

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

fileId

string

รหัสของไฟล์

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

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

string

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

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

addParents

string

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

enforceSingleParent
(deprecated)

boolean

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

keepRevisionForever

boolean

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

ocrLanguage

string

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

removeParents

string

รายการรหัสหลักที่คั่นด้วยคอมมาที่จะนำออก

supportsAllDrives

boolean

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

supportsTeamDrives
(deprecated)

boolean

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

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

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