Method: files.insert

แทรกไฟล์ใหม่

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

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

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

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

แอปที่สร้างทางลัดด้วย files.insert ต้องระบุประเภท MIME application/vnd.google-apps.shortcut

แอปควรระบุนามสกุลไฟล์ในพร็อพเพอร์ตี้ title เมื่อแทรกไฟล์ด้วย API เช่น การดำเนินการที่จะแทรกไฟล์ JPEG ควรระบุ "title": "cat.jpg" ในข้อมูลเมตา

คำขอ GET ที่ตามมาจะรวมพร็อพเพอร์ตี้ fileExtension แบบอ่านอย่างเดียวซึ่งสร้างจากส่วนขยายที่ระบุไว้แต่แรกในพร็อพเพอร์ตี้ title เมื่อผู้ใช้ Google ไดรฟ์ขอดาวน์โหลดไฟล์ หรือเมื่อดาวน์โหลดไฟล์ผ่านไคลเอ็นต์การซิงค์ ไดรฟ์จะสร้างชื่อไฟล์แบบเต็ม (พร้อมนามสกุล) ตามชื่อ ในกรณีที่ไม่มีนามสกุล ไดรฟ์จะพยายามระบุนามสกุลตามประเภท MIME ของไฟล์

คำขอ HTTP

  • อัปโหลด URI สำหรับคำขออัปโหลดสื่อ:
    POST https://www.googleapis.com/upload/drive/v2/files
  • URI ข้อมูลเมตาสำหรับคำขอที่มีเฉพาะข้อมูลเมตา:
    POST https://www.googleapis.com/drive/v2/files

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

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

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

string

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

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

boolean

จะแปลงไฟล์นี้เป็นรูปแบบเครื่องมือแก้ไขเอกสารที่ตรงกันหรือไม่
enforceSingleParent
(deprecated)

boolean

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

boolean

ระบุว่าจะพยายาม OCR เมื่อมีการอัปโหลดไฟล์ .jpg, .png, .gif หรือ .pdf
ocrLanguage

string

หาก ocr เป็นจริง ให้คำใบ้ภาษาที่ใช้ ค่าที่ถูกต้องคือรหัส BCP 47
pinned

boolean

ต้องการปักหมุดการแก้ไขส่วนหัวของไฟล์ที่อัปโหลดหรือไม่ ไฟล์ 1 ไฟล์จะมีการแก้ไขที่ปักหมุดไว้ได้สูงสุด 200 รายการ
supportsAllDrives

boolean

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

boolean

เลิกใช้งานแล้ว: ใช้ supportsAllDrives แทน
timedTextLanguage

string

ภาษาของข้อความที่จับเวลา
timedTextTrackName

string

ชื่อแทร็กข้อความที่มีการกำหนดเวลา
useContentAsIndexableText

boolean

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

enum (Visibility)

การเปิดเผยไฟล์ใหม่ พารามิเตอร์นี้จะเกี่ยวข้องเมื่อ conversion=false เท่านั้น
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

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