API ของ Google ไดรฟ์รองรับการดาวน์โหลดและส่งออกหลายประเภท เช่น แสดงในตารางต่อไปนี้
การดาวน์โหลด |
|
|||
การส่งออก |
|
ก่อนดาวน์โหลดหรือส่งออกเนื้อหาไฟล์ โปรดยืนยันว่าผู้ใช้จะดาวน์โหลดหรือส่งออกเนื้อหาไฟล์ได้
โดยใช้ฟิลด์ capabilities.canDownload
ใน
แหล่งข้อมูล files
ส่วนที่เหลือของคู่มือนี้มีวิธีการโดยละเอียดสำหรับการดำเนินการประเภทเหล่านี้ ของการดำเนินการดาวน์โหลดและส่งออก
ดาวน์โหลดเนื้อหาไฟล์ BLOB
หากต้องการดาวน์โหลดไฟล์ BLOB ที่จัดเก็บไว้ในไดรฟ์ ให้ใช้เมธอด files.get
ที่มีรหัสไฟล์ที่จะดาวน์โหลด
และพารามิเตอร์ URL alt=media
พารามิเตอร์ของ URL alt=media
จะบอก
เซิร์ฟเวอร์ที่มีการขอให้ดาวน์โหลดเนื้อหาเป็นการตอบสนองทางเลือก
พารามิเตอร์ URL alt=media
คือ ระบบ
พารามิเตอร์
ใน Google REST API ทั้งหมด หากคุณใช้ไลบรารีไคลเอ็นต์สำหรับ
Drive API คุณไม่จำเป็นต้องตั้งค่าพารามิเตอร์นี้อย่างชัดแจ้ง
ตัวอย่างโค้ดต่อไปนี้แสดงวิธีใช้เมธอด files.get
ในการดาวน์โหลด
ที่มีไลบรารีของไคลเอ็นต์ Drive API
Java
Python
Node.js
PHP
.NET
ตัวอย่างโค้ดนี้ใช้วิธีการไลบรารีที่เพิ่มพารามิเตอร์ของ URL alt=media
ลงในคำขอ HTTP ที่สำคัญ
การดาวน์โหลดไฟล์ที่เริ่มต้นจากแอปจะต้องได้รับอนุญาตด้วยขอบเขตที่ให้สิทธิ์
สิทธิ์การอ่านเนื้อหาไฟล์ เช่น แอปที่ใช้
ขอบเขต drive.readonly.metadata
ไม่ได้รับอนุญาตให้ดาวน์โหลดเนื้อหาของไฟล์
ตัวอย่างโค้ดนี้ใช้ขอบเขตไฟล์ "ไดรฟ์" แบบจำกัดซึ่งอนุญาตให้ผู้ใช้
ดูและจัดการไฟล์ในไดรฟ์ทั้งหมดของคุณ หากต้องการทราบข้อมูลเพิ่มเติมเกี่ยวกับ
ขอบเขตของไดรฟ์ โปรดดูที่เลือก Google Drive API
ขอบเขตการใช้งาน
ผู้ใช้ที่มีสิทธิ์แก้ไขสามารถจำกัดการดาวน์โหลดโดยผู้ใช้แบบอ่านอย่างเดียวได้ผ่านทาง
กำลังตั้งค่า copyRequiresWriterPermission
เป็น false
ไฟล์ระบุว่า
ละเมิด
(เช่น ซอฟต์แวร์ที่เป็นอันตราย) จะมีเพียงเจ้าของไฟล์เท่านั้นที่สามารถดาวน์โหลดได้
นอกจากนี้ คุณต้องใส่ get
พารามิเตอร์การค้นหา acknowledgeAbuse=true
ด้วย
เพื่อระบุว่าผู้ใช้รับทราบถึงความเสี่ยงในการดาวน์โหลด
ซอฟต์แวร์ไม่พึงประสงค์หรือไฟล์ที่เป็นการละเมิดอื่นๆ แอปพลิเคชันของคุณควรมีการโต้ตอบ
เตือนผู้ใช้ก่อนใช้พารามิเตอร์การค้นหานี้
ดาวน์โหลดบางส่วน
การดาวน์โหลดบางส่วนเกี่ยวข้องกับการดาวน์โหลดเฉพาะบางส่วนของไฟล์ คุณ
สามารถระบุส่วนของไฟล์ที่คุณต้องการดาวน์โหลดโดยใช้ไบต์
ช่วง
ที่มีส่วนหัว Range
เช่น
Range: bytes=500-999
ดาวน์โหลดเนื้อหาไฟล์ BLOB ในเวอร์ชันก่อนหน้า
หากต้องการดาวน์โหลดเนื้อหาของไฟล์ BLOB ในเวอร์ชันก่อนหน้า ให้ใช้
เมธอด revisions.get
ที่มีรหัสของ
ไฟล์ที่จะดาวน์โหลด รหัสของการแก้ไข และพารามิเตอร์ URL alt=media
พารามิเตอร์ของ URL alt=media
จะบอกเซิร์ฟเวอร์ว่าการดาวน์โหลดเนื้อหา
มีการขอให้เป็นรูปแบบคำตอบทางเลือก เช่นเดียวกับ files.get
วิธี revisions.get
ยังยอมรับพารามิเตอร์การค้นหาที่ไม่บังคับด้วย
acknowledgeAbuse
และส่วนหัว Range
สำหรับข้อมูลเพิ่มเติมเกี่ยวกับการดาวน์โหลด
การแก้ไข โปรดดูดาวน์โหลดและเผยแพร่ไฟล์
การแก้ไขดังกล่าว
ดาวน์โหลดเนื้อหาไฟล์ Blob ในเบราว์เซอร์
หากต้องการดาวน์โหลดเนื้อหาของไฟล์ Blob ที่จัดเก็บในไดรฟ์ภายใน
แทนการดำเนินการผ่าน API ให้ใช้
ฟิลด์ webContentLink
ของฟิลด์
แหล่งข้อมูล files
หากผู้ใช้มีการดาวน์โหลด
การเข้าถึงไฟล์ ลิงก์สำหรับดาวน์โหลดไฟล์ และเนื้อหาในไฟล์
ส่งคืนแล้ว คุณสามารถเปลี่ยนเส้นทางผู้ใช้ไปยัง URL นี้ หรือเสนอให้เป็น URL ที่คลิกได้
ลิงก์
ส่งออกเนื้อหาเอกสารใน Google Workspace
หากต้องการส่งออกเนื้อหาไบต์ในเอกสารของ Google Workspace ให้ใช้เมธอด files.export
ที่มีรหัสไฟล์ที่จะส่งออก
และประเภท MIME ที่ถูกต้อง ส่งออกแล้ว
เนื้อหาต้องมีขนาดไม่เกิน 10 MB
ตัวอย่างโค้ดต่อไปนี้แสดงวิธีใช้เมธอด files.export
เพื่อส่งออก
เอกสารของ Google Workspace ในรูปแบบ PDF โดยใช้ไคลเอ็นต์ Drive API
ไลบรารี:
Java
Python
Node.js
PHP
.NET
ตัวอย่างโค้ดนี้ใช้ขอบเขต drive
ที่จำกัดซึ่งอนุญาตให้ผู้ใช้ดูและ
จัดการไฟล์ในไดรฟ์ทั้งหมดของคุณ หากต้องการทราบข้อมูลเพิ่มเติมเกี่ยวกับ
ขอบเขตของไดรฟ์ โปรดดูที่เลือก Google Drive API
ขอบเขตการใช้งาน
ตัวอย่างโค้ดจะประกาศประเภท MIME ที่ส่งออกเป็น application/pdf
ด้วย สำหรับ
รายการประเภท MIME ส่งออกทั้งหมดที่รองรับสำหรับ Google Workspace แต่ละรายการ
โปรดดูเอกสารที่หัวข้อส่งออกประเภท MIME สำหรับ Google Workspace
เอกสาร
ส่งออกเนื้อหาเอกสาร Google Workspace ในเบราว์เซอร์
หากต้องการส่งออกเนื้อหาเอกสารใน Google Workspace ภายในเบราว์เซอร์ ให้ใช้เมธอด
ฟิลด์ exportLinks
ของฟิลด์
แหล่งข้อมูล files
ทั้งนี้ขึ้นอยู่กับเอกสาร
ประเภท ลิงก์สำหรับดาวน์โหลดไฟล์ และเนื้อหาในไฟล์จะแสดงผลสำหรับ MIME ทั้งหมด
ประเภทที่มีให้เลือก คุณสามารถเปลี่ยนเส้นทางผู้ใช้ไปยัง URL หรือเสนอให้เป็น URL
ลิงก์ที่คลิกได้
ส่งออกเนื้อหาของเอกสาร Google Workspace เวอร์ชันก่อนหน้าในเบราว์เซอร์
หากต้องการส่งออกเนื้อหาของเอกสาร Google Workspace เป็นเวอร์ชันก่อนหน้าภายใน
เบราว์เซอร์ ให้ใช้เมธอด revisions.get
พร้อมรหัสไฟล์ที่จะดาวน์โหลดและรหัสของการแก้ไข หากผู้ใช้มี
สิทธิ์ดาวน์โหลดไฟล์ ลิงก์สำหรับดาวน์โหลดไฟล์ และเนื้อหาในไฟล์
ส่งคืนแล้ว คุณสามารถเปลี่ยนเส้นทางผู้ใช้ไปยัง URL นี้ หรือเสนอให้เป็น URL ที่คลิกได้
ลิงก์