Method: files.create

สร้างไฟล์ ดูข้อมูลเพิ่มเติมได้ที่หัวข้อสร้างและจัดการไฟล์

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

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

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

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

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

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

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

คำขอ HTTP

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

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

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

พารามิเตอร์
enforceSingleParent
(deprecated)

boolean

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

boolean

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

boolean

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

string

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

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