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

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