Method: files.update

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

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

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

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

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

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

คำขอ HTTP

  • URI การอัปโหลดสำหรับคำขออัปโหลดสื่อ
    PATCH https://www.googleapis.com/upload/drive/v3/files/{fileId}
  • URI ของข้อมูลเมตาสำหรับคำขอข้อมูลเมตาเท่านั้น:
    PATCH https://www.googleapis.com/drive/v3/files/{fileId}

URL ใช้ไวยากรณ์การแปลงรหัส gRPC

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

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

string

รหัสของไฟล์

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

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

string

รายการรหัสของผู้ปกครองที่จะเพิ่มซึ่งคั่นด้วยคอมมา
enforceSingleParent
(deprecated)

boolean

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

boolean

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

string

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

string

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

boolean

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

boolean

เลิกใช้งานแล้ว: โปรดใช้ supportsAllDrives แทน
uploadType

string

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

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

boolean

ว่าจะใช้เนื้อหาที่อัปโหลดเป็นข้อความที่จัดทำดัชนีได้หรือไม่
includePermissionsForView

string

ระบุสิทธิ์ของมุมมองเพิ่มเติมที่จะรวมไว้ในการตอบกลับ รองรับ published เท่านั้น
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

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