สร้างและจัดการไฟล์

คู่มือนี้อธิบายวิธีสร้างและจัดการไฟล์ใน Google ไดรฟ์โดยใช้ Google Drive API

สร้างไฟล์

หากต้องการสร้างไฟล์ในไดรฟ์ที่ไม่มีข้อมูลเมตาหรือเนื้อหา ให้ใช้วิธี create ในแหล่งข้อมูล files โดยไม่มีพารามิเตอร์

เมื่อสร้างไฟล์ เมธอดจะแสดงผลทรัพยากร files ระบบจะกำหนดkindเป็น drive.file, id, name เป็น "ไม่มีชื่อ" และmimeTypeเป็น application/octet-stream ระบบจะทําเครื่องหมาย uploadType เป็นต้องระบุ แต่ค่าเริ่มต้นคือ media คุณจึงไม่ต้อง ระบุค่าดังกล่าว

ดูข้อมูลเพิ่มเติมเกี่ยวกับขีดจำกัดของไฟล์ในไดรฟ์ได้ที่ขีดจำกัดของไฟล์และโฟลเดอร์

ใช้พารามิเตอร์ฟิลด์

หากต้องการระบุช่องที่จะแสดงผลในการตอบกลับ คุณสามารถตั้งค่าfields พารามิเตอร์ระบบ ด้วยเมธอดใดก็ได้ของทรัพยากร files หากไม่ระบุพารามิเตอร์ fields เซิร์ฟเวอร์จะแสดงผลชุดฟิลด์เริ่มต้นที่เฉพาะเจาะจงสำหรับเมธอด เช่น เมธอด list จะแสดงเฉพาะช่อง kind, id, name, mimeType และ resourceKey สำหรับแต่ละไฟล์ หากต้องการแสดงฟิลด์อื่น ให้ดูแสดงฟิลด์ที่เฉพาะเจาะจง

สร้างรหัสเพื่อใช้กับไฟล์

เมธอด generateIds ในแหล่งข้อมูล files ช่วยให้คุณสร้างรหัสไฟล์ที่ไม่ซ้ำล่วงหน้าได้ ซึ่งจะใช้เมื่อสร้างหรือคัดลอกไฟล์และโฟลเดอร์ในไดรฟ์ได้ ซึ่งอาจเป็นประโยชน์เมื่อคุณต้องการควบคุมรหัสไฟล์ จากแอปของคุณ แทนที่จะให้ไดรฟ์กำหนดรหัส โดยอัตโนมัติ

คุณตั้งค่าจำนวนรหัสที่สร้างขึ้นได้โดยใช้พารามิเตอร์การค้นหา count หากไม่ได้ตั้งค่า count ระบบจะแสดง 10 รายการโดยค่าเริ่มต้น คุณขอรหัสได้สูงสุด 1,000 รายการ

นอกจากนี้ คุณยังระบุ space ที่ใช้รหัสได้และ type ของสินค้าที่ใช้รหัสได้ด้วย

เมื่อสร้างรหัสแล้ว คุณจะส่งรหัสไปยังเมธอด create หรือ copy ได้ ผ่านช่อง id เพื่อให้มั่นใจว่าไฟล์ที่สร้างหรือคัดลอกจะใช้รหัสที่กำหนดไว้ล่วงหน้า

หากสร้างหรือคัดลอกไฟล์สำเร็จ การลองอีกครั้งในภายหลังจะแสดง409 Conflictการตอบกลับรหัสสถานะ HTTP และระบบจะไม่สร้างไฟล์ที่ซ้ำกัน

โปรดทราบว่าระบบไม่รองรับรหัสที่สร้างไว้ล่วงหน้าสำหรับการสร้างไฟล์ Google Workspace ยกเว้นapplication/vnd.google-apps.drive-sdk และapplication/vnd.google-apps.folder ประเภท MIME ในทำนองเดียวกัน ระบบก็ไม่รองรับการอัปโหลดที่อ้างอิงการแปลงเป็นรูปแบบไฟล์ Google Workspace

สร้างไฟล์ที่มีเฉพาะข้อมูลเมตา

ไฟล์ที่มีเฉพาะข้อมูลเมตาจะไม่มีเนื้อหา ข้อมูลเมตาคือข้อมูล (เช่น name, mimeType และ createdTime) ที่อธิบายไฟล์ ฟิลด์อย่าง name ไม่ ขึ้นอยู่กับผู้ใช้และจะปรากฏเหมือนกันสำหรับผู้ใช้แต่ละราย ในขณะที่ฟิลด์อย่าง viewedByMeTime จะมีค่าที่เฉพาะเจาะจงสำหรับผู้ใช้

ตัวอย่างไฟล์ที่มีเฉพาะข้อมูลเมตาคือโฟลเดอร์ที่มีประเภท MIME application/vnd.google-apps.folder ดูข้อมูลเพิ่มเติมได้ที่สร้างและ ป้อนข้อมูลในโฟลเดอร์ อีกตัวอย่างหนึ่งคือทางลัดที่ ชี้ไปยังไฟล์อื่นในไดรฟ์ที่มีประเภท MIME application/vnd.google-apps.shortcut โปรดดูข้อมูลเพิ่มเติมที่หัวข้อสร้าง ทางลัดไปยังไฟล์ในไดรฟ์

จัดการรูปภาพปก

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

คัดลอกไฟล์ที่มีอยู่

หากต้องการคัดลอกไฟล์และใช้การอัปเดตที่ขอ ให้ใช้เมธอด copy ในแหล่งข้อมูล files หากต้องการค้นหา fileIdเพื่อคัดลอก ให้ใช้วิธี list

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

คุณตั้งค่ารหัสไฟล์ของไฟล์ที่คัดลอกไว้ล่วงหน้าได้โดยใช้วิธี generateIds ดูข้อมูลเพิ่มเติมได้ที่หัวข้อสร้างรหัสเพื่อใช้กับไฟล์

โปรดทราบว่าคุณต้องใช้ขอบเขต Drive API ที่เหมาะสมเพื่อให้สิทธิ์การเรียก ดูข้อมูลเพิ่มเติมเกี่ยวกับขอบเขตของไดรฟ์ได้ที่เลือก ขอบเขต Google Drive API

ข้อจำกัดและข้อควรพิจารณา

ขณะเตรียมคัดลอกไฟล์ โปรดทราบข้อจำกัดและข้อควรพิจารณาต่อไปนี้

  • สิทธิ์

    • ออบเจ็กต์ DownloadRestrictionsMetadata ของทรัพยากร files จะกำหนด ผู้ที่คัดลอกไฟล์ได้ ดูข้อมูลเพิ่มเติมได้ที่หัวข้อป้องกันไม่ให้ผู้ใช้ ดาวน์โหลด พิมพ์ หรือคัดลอก ไฟล์
    • ทรัพยากรฟิลด์ capabilities.canCopy จะกำหนดว่าผู้ใช้จะคัดลอกไฟล์ได้หรือไม่ ดูข้อมูลเพิ่มเติมได้ที่ทำความเข้าใจความสามารถของไฟล์
    • ผู้ใช้ที่สร้างสำเนาจะเป็นเจ้าของไฟล์ที่คัดลอก ระบบจะไม่จำลองการตั้งค่าการแชร์อื่นๆ จากไฟล์ต้นฉบับ หากสร้างสำเนาใน โฟลเดอร์ที่แชร์ สำเนาจะรับค่าสิทธิ์ของโฟลเดอร์นั้น
    • การเป็นเจ้าของไฟล์ที่คัดลอกอาจเปลี่ยนแปลง และสำเนาอาจไม่รับช่วง การตั้งค่าการแชร์ของไฟล์ต้นฉบับ คุณอาจต้อง รีเซ็ต</0x0A>การตั้งค่าเหล่านี้

  • การจัดการไฟล์:

    • ระบบจะคัดลอกไฟล์บางไฟล์ไม่ได้ เช่น ทางลัดของบุคคลที่สาม
    • คุณจะคัดลอกไฟล์ไปยังโฟลเดอร์หลักได้เพียงโฟลเดอร์เดียว ระบบไม่รองรับการระบุ ผู้ปกครองหลายคน หากไม่ได้ระบุฟิลด์ parents ไฟล์จะรับค่าโฟลเดอร์หลักที่ค้นพบได้จากไฟล์ต้นฉบับ
    • แม้ว่าโฟลเดอร์จะเป็นไฟล์ประเภทหนึ่ง แต่คุณก็ไม่สามารถคัดลอกโฟลเดอร์ได้ แต่ให้สร้างโฟลเดอร์ปลายทางและตั้งค่าฟิลด์ parents ของไฟล์ที่มีอยู่เป็นโฟลเดอร์ปลายทาง จากนั้นคุณจะลบ โฟลเดอร์แหล่งที่มาต้นฉบับได้
    • หากไม่ได้ระบุชื่อไฟล์ใหม่ copy วิธีนี้จะสร้างไฟล์ ที่มีชื่อเดียวกับไฟล์ต้นฉบับ
    • การใช้ copy มากเกินไปอาจทำให้คุณใช้โควต้า Drive API เกินขีดจำกัด ดูข้อมูลเพิ่มเติมได้ที่โควต้าการใช้งาน

ขั้นตอนถัดไปที่คุณอาจลองทำมีดังนี้