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

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

พารามิเตอร์
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

อัปเดตวันที่ดูหลังจากอัปเดตไฟล์เรียบร้อยแล้วหรือไม่
uploadType

string

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

ค่าที่ยอมรับมีดังนี้
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

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