Method: files.create

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

สร้างไฟล์ใหม่

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

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

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

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

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

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

คำขอ GET ที่ตามมาจะมีพร็อพเพอร์ตี้ fileExtension แบบอ่านอย่างเดียวซึ่งสร้างขึ้นด้วยส่วนขยายที่ระบุไว้ในพร็อพเพอร์ตี้ title เดิม เมื่อผู้ใช้ 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	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 คุณจะต้องกรอกข้อมูลในช่องนี้ หากสร้างไฟล์ที่มีเฉพาะข้อมูลเมตา คุณไม่จำเป็นต้องกรอกข้อมูลในช่องนี้ นอกจากนี้ ฟิลด์นี้จะไม่แสดงในวิดเจ็ต "ลองใช้วิธีนี้" เนื่องจากวิดเจ็ตไม่รองรับการอัปโหลดข้อมูล ค่าที่ยอมรับมีดังนี้ media - การอัปโหลดแบบง่าย อัปโหลดเฉพาะสื่อโดยไม่มีข้อมูลเมตา multipart - การอัปโหลดแบบหลายส่วน อัปโหลดทั้งสื่อและข้อมูลเมตาในคำขอเดียว resumable - การอัปโหลดที่ดำเนินการต่อได้ อัปโหลดไฟล์ในลักษณะที่กลับมาดำเนินการต่อได้โดยใช้ชุดคำขออย่างน้อย 2 รายการ โดยคำขอแรกต้องมีข้อมูลเมตา
useContentAsIndexableText	boolean ระบุว่าจะใช้เนื้อหาที่อัปโหลดเป็นข้อความที่จัดทําดัชนีได้หรือไม่
includePermissionsForView	string ระบุสิทธิ์ของมุมมองเพิ่มเติมที่จะรวมไว้ในคำตอบ รองรับเฉพาะ "เผยแพร่แล้ว"
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

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