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 Transcoding

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

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

string

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

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

  • media - อัปโหลดได้ง่าย อัปโหลดสื่อเท่านั้น โดยไม่มีข้อมูลเมตา
  • multipart - การอัปโหลดหลายส่วน อัปโหลดทั้งสื่อและข้อมูลเมตาในคําขอเดียว
  • resumable - การอัปโหลดต่อ อัปโหลดไฟล์ในรูปแบบที่ดําเนินการต่อได้โดยใช้ชุดคําขออย่างน้อย 2 คําขอ โดยที่คําขอแรกมีข้อมูลเมตา
fileId

string

รหัสของไฟล์

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

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

string

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

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

  • media - อัปโหลดได้ง่าย อัปโหลดสื่อเท่านั้น โดยไม่มีข้อมูลเมตา
  • multipart - การอัปโหลดหลายส่วน อัปโหลดทั้งสื่อและข้อมูลเมตาในคําขอเดียว
  • resumable - การอัปโหลดต่อ อัปโหลดไฟล์ในรูปแบบที่ดําเนินการต่อได้โดยใช้ชุดคําขออย่างน้อย 2 คําขอ โดยที่คําขอแรกมีข้อมูลเมตา
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

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