Method: files.create

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

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

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

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