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