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

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

พารามิเตอร์
uploadType	string ประเภทคำขออัปโหลดไปยัง URI /upload ต้องระบุข้อมูลในช่องนี้หากคุณอัปโหลดข้อมูลด้วย URI /upload หากสร้างไฟล์ที่มีเฉพาะข้อมูลเมตา คุณไม่จำเป็นต้องกรอกข้อมูลในช่องนี้ นอกจากนี้ ช่องนี้จะไม่แสดงในวิดเจ็ต "ลองวิธีนี้" เนื่องจากวิดเจ็ตไม่รองรับการอัปโหลดข้อมูล ค่าที่ยอมรับมีดังนี้ media - การอัปโหลดอย่างง่าย อัปโหลดสื่อเท่านั้นโดยไม่มีข้อมูลเมตา multipart - การอัปโหลดหลายส่วน อัปโหลดทั้งสื่อและข้อมูลเมตาในคำขอเดียว resumable - การอัปโหลดที่ดำเนินการต่อได้ อัปโหลดไฟล์แบบที่ดำเนินการต่อได้ โดยใช้ชุดคำขออย่างน้อย 2 รายการ โดยที่คำขอแรกมีข้อมูลเมตา
enforceSingleParent	boolean เลิกใช้งานแล้ว ระบบไม่รองรับการสร้างไฟล์ในหลายโฟลเดอร์อีกต่อไป
ignoreDefaultVisibility	boolean เลือกว่าจะไม่สนใจการตั้งค่าการเปิดเผยเริ่มต้นของโดเมนสำหรับไฟล์ที่สร้างขึ้นหรือไม่ ผู้ดูแลระบบโดเมนสามารถเลือกให้ไฟล์ที่อัปโหลดทั้งหมดแสดงต่อโดเมนโดยค่าเริ่มต้น พารามิเตอร์นี้จะข้ามลักษณะการทำงานของคำขอดังกล่าว สิทธิ์ต่างๆ ยังคงได้รับมาจากโฟลเดอร์หลัก
keepRevisionForever	boolean ตั้งค่าฟิลด์ "keepForever" ในการแก้ไขส่วนหัวใหม่หรือไม่ การดำเนินการนี้จะมีผลกับไฟล์ที่มีเนื้อหาไบนารีใน Google ไดรฟ์เท่านั้น ระบบจะเก็บการแก้ไขไฟล์ได้ตลอด 200 ครั้งเท่านั้น หากครบจำนวนที่จำกัดไว้แล้ว ให้ลองลบการแก้ไขที่ปักหมุดไว้
ocrLanguage	string คำแนะนำภาษาสำหรับการประมวลผล OCR ระหว่างการนำเข้ารูปภาพ (รหัส ISO 639-1)
supportsAllDrives	boolean แอปพลิเคชันที่ส่งคำขอรองรับทั้งไดรฟ์ของฉันและไดรฟ์ที่แชร์หรือไม่
supportsTeamDrives (deprecated)	boolean เลิกใช้งานแล้ว: ใช้ supportsAllDrives แทน
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

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