หน้านี้ได้รับการแปลโดย Cloud Translation API

Method: files.update

คำขอ HTTP
พารามิเตอร์เส้นทาง
พารามิเตอร์การค้นหา
เนื้อความของคำขอ
เนื้อหาการตอบกลับ
ขอบเขตการให้สิทธิ์
ลองใช้งาน

อัปเดตข้อมูลเมตาและ/หรือเนื้อหาของไฟล์ เมื่อเรียกใช้เมธอดนี้ ให้เติมข้อมูลเฉพาะช่องในคำขอที่คุณต้องการแก้ไขเท่านั้น เมื่ออัปเดตช่อง ระบบอาจเปลี่ยนบางช่องโดยอัตโนมัติ เช่น 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

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

พารามิเตอร์

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 ในการแก้ไขส่วนหัวปัจจุบันจะถูกแทนที่ ถ้า "จริง" หรือไม่ได้ตั้งค่า ระบบจะสร้าง Blob ใหม่เป็นการแก้ไขส่วนหัว และการแก้ไขที่ไม่ได้ปักหมุดไว้ก่อนหน้าจะยังคงอยู่เป็นระยะเวลาสั้นๆ ระบบจะเก็บการแก้ไขที่ปักหมุดไว้โดยไม่มีกำหนด โดยใช้โควต้าพื้นที่เก็บข้อมูลเพิ่มเติม โดยแก้ไขได้สูงสุด 200 ครั้ง โปรดดูรายละเอียดเกี่ยวกับวิธีเก็บรักษาการแก้ไขที่ศูนย์ช่วยเหลือของไดรฟ์
`ocr`	`boolean` ระบุว่าจะพยายาม OCR เมื่อมีการอัปโหลดไฟล์ .jpg, .png, .gif หรือ .pdf
`ocrLanguage`	`string` หาก ocr เป็นจริง ให้คำใบ้ภาษาที่ใช้ ค่าที่ถูกต้องคือรหัส BCP 47
`pinned`	`boolean` ต้องการปักหมุดการแก้ไขใหม่หรือไม่ ไฟล์ 1 ไฟล์จะมีการแก้ไขที่ปักหมุดไว้ได้สูงสุด 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

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