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

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

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

boolean

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

boolean

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

boolean

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

string

หาก ocr เป็นจริง ให้บอกเป็นนัยถึงภาษาที่จะใช้ ค่าที่ใช้ได้คือรหัส BCP 47
pinned

boolean

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

boolean

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

boolean

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

string

ภาษาของคำบรรยายแทนเสียง
timedTextTrackName

string

ชื่อแทร็กข้อความที่เวลา
uploadType

string

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

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

boolean

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

enum (Visibility)

ระดับการแชร์ของไฟล์ใหม่ พารามิเตอร์นี้เกี่ยวข้องก็ต่อเมื่อ convert=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

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