Method: files.update

อัปเดตข้อมูลเมตา เนื้อหา หรือทั้ง 2 อย่างของไฟล์

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

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

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

    (ระบุประเภท MIME ที่ถูกต้องแทนค่า */* ที่แท้จริง ข้อความ */* ใช้เพื่อระบุว่าสามารถอัปโหลดประเภท MIME ที่ถูกต้องได้ ดูข้อมูลเพิ่มเติมได้ที่ประเภท MIME ที่รองรับใน Google Workspace และ Google ไดรฟ์)

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

คำขอ 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

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