Method: files.update

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

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

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

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

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

คำขอ HTTP

  • URI การอัปโหลดสําหรับคําขออัปโหลดสื่อ:
    PUT https://www.googleapis.com/upload/drive/v2/files/{fileId}
  • URI ข้อมูลเมตาสําหรับคําขอเฉพาะข้อมูลเมตาเท่านั้น:
    PUT https://www.googleapis.com/drive/v2/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

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

boolean

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

boolean

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

enum (ModifiedDateBehavior)

กําหนดลักษณะการทํางานที่จะอัปเดต modifiedDate การทํางานนี้จะแทนที่ setModifiedDate
newRevision

boolean

การอัปโหลด Blob ควรสร้างการแก้ไขใหม่หรือไม่ หากเป็น "เท็จ" ข้อมูล Blob ในการแก้ไขศีรษะปัจจุบันจะถูกแทนที่ หากตั้งค่าเป็น True หรือไม่ได้ตั้งค่า ระบบจะสร้าง 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

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