Google ไดรฟ์ API รองรับการดำเนินการดาวน์โหลดและส่งออกหลายประเภทตามที่ ระบุไว้ในตารางต่อไปนี้
| การดำเนินการดาวน์โหลด |
|
||||
| การดำเนินการส่งออก |
|
ก่อนดาวน์โหลดหรือส่งออกเนื้อหาไฟล์ ให้ตรวจสอบว่าผู้ใช้สามารถดาวน์โหลดไฟล์ได้โดยใช้ฟิลด์ capabilities.canDownload ในแหล่งข้อมูล files
ดูคำอธิบายประเภทไฟล์ที่กล่าวถึงที่นี่ รวมถึงไฟล์ Blob และไฟล์ Google Workspace ได้ที่ประเภทไฟล์
ส่วนที่เหลือของคู่มือนี้จะให้วิธีการโดยละเอียดในการดำเนินการดาวน์โหลดและส่งออกประเภทเหล่านี้
ดาวน์โหลดเนื้อหาไฟล์ Blob
หากต้องการดาวน์โหลดไฟล์ Blob ที่จัดเก็บไว้ในไดรฟ์ ให้ใช้วิธี files.get กับรหัสของไฟล์ที่จะดาวน์โหลดและพารามิเตอร์ URL ของ alt=media พารามิเตอร์ URL ของ alt=media จะบอกเซิร์ฟเวอร์ว่ามีการขอให้ดาวน์โหลดเนื้อหาเป็นรูปแบบการตอบกลับอื่น
alt=media พารามิเตอร์ URL เป็นพารามิเตอร์
ของระบบที่ใช้ได้
ใน REST API ของ Google ทั้งหมด หากใช้ไลบรารีของไคลเอ็นต์สำหรับ
Drive API คุณไม่จำเป็นต้องตั้งค่าพารามิเตอร์นี้อย่างชัดเจน
ตัวอย่างโค้ดต่อไปนี้แสดงวิธีใช้เมธอด files.get เพื่อดาวน์โหลดไฟล์ด้วยไลบรารีของไคลเอ็นต์ Drive API
Java
Python
Node.js
PHP
.NET
ตัวอย่างโค้ดนี้ใช้วิธีการของไลบรารีที่เพิ่มalt=mediaพารามิเตอร์ URL
ลงในคำขอ HTTP พื้นฐาน
การดาวน์โหลดไฟล์ที่เริ่มต้นจากแอปของคุณต้องได้รับอนุญาตโดยมีขอบเขตที่อนุญาต
สิทธิ์อ่านเนื้อหาของไฟล์ เช่น แอปที่ใช้ขอบเขต drive.readonly.metadata จะไม่ได้รับอนุญาตให้ดาวน์โหลดเนื้อหาของไฟล์
ตัวอย่างโค้ดนี้ใช้ขอบเขตไฟล์ "ไดรฟ์" ที่จำกัด ซึ่งอนุญาตให้ผู้ใช้
ดูและจัดการไฟล์ทั้งหมดในไดรฟ์ของคุณ ดูข้อมูลเพิ่มเติมเกี่ยวกับ
ขอบเขตของไดรฟ์ได้ที่เลือกขอบเขต Google Drive API
ผู้ใช้ที่มีสิทธิ์ระดับowner (สำหรับไฟล์ในไดรฟ์ของฉัน) หรือสิทธิ์ระดับorganizer (สำหรับไฟล์ในไดรฟ์ที่แชร์) สามารถจำกัดการดาวน์โหลดผ่านออบเจ็กต์ DownloadRestrictionsMetadata ได้ ดูข้อมูลเพิ่มเติมได้ที่หัวข้อป้องกันไม่ให้ผู้ใช้ดาวน์โหลด พิมพ์ หรือคัดลอกไฟล์
มีเพียงเจ้าของไฟล์เท่านั้นที่ดาวน์โหลดไฟล์ที่ระบุว่าละเมิด
(เช่น ซอฟต์แวร์ที่เป็นอันตราย) ได้
นอกจากนี้ ต้องระบุgetพารามิเตอร์การค้นหาacknowledgeAbuse=trueเพื่อระบุว่าผู้ใช้รับทราบความเสี่ยงในการดาวน์โหลดซอฟต์แวร์ที่อาจไม่พึงประสงค์หรือไฟล์ที่เป็นการละเมิดอื่นๆ แอปพลิเคชันควรเตือนผู้ใช้แบบอินเทอร์แอกทีฟ
ก่อนที่จะใช้พารามิเตอร์การค้นหานี้
การดาวน์โหลดบางส่วน
การดาวน์โหลดบางส่วนคือการดาวน์โหลดเฉพาะส่วนที่ระบุของไฟล์ คุณ
ระบุส่วนของไฟล์ที่ต้องการดาวน์โหลดได้โดยใช้ช่วงไบต์กับส่วนหัว
Range เช่น
Range: bytes=500-999
ดาวน์โหลดเนื้อหาไฟล์ Blob ในเวอร์ชันก่อนหน้า
คุณจะดาวน์โหลดได้เฉพาะการแก้ไขเนื้อหาไฟล์ Blob ที่ทำเครื่องหมายว่า "เก็บตลอดไป" หากต้องการดาวน์โหลดเวอร์ชัน ให้ตั้งค่าเป็น "เก็บไว้ตลอดไป" ก่อน ดูข้อมูลเพิ่มเติมได้ที่ระบุการแก้ไขที่จะบันทึกจากการลบอัตโนมัติ
หากต้องการดาวน์โหลดเนื้อหาของไฟล์ Blob ในเวอร์ชันก่อนหน้า ให้ใช้วิธี revisions.get พร้อมรหัสของ
ไฟล์ที่จะดาวน์โหลด รหัสของการแก้ไข และพารามิเตอร์ URL alt=media พารามิเตอร์ URL
alt=media จะบอกเซิร์ฟเวอร์ว่ามีการขอให้ดาวน์โหลดเนื้อหา
เป็นรูปแบบการตอบกลับสำรอง เช่นเดียวกับ files.get เมธอด
revisions.get ยังยอมรับพารามิเตอร์การค้นหาที่ไม่บังคับ
acknowledgeAbuse และส่วนหัว Range ด้วย ดูข้อมูลเพิ่มเติมได้ที่จัดการ
การดำเนินการที่ใช้เวลานาน
โปรโตคอลคำขอจะแสดงที่นี่
GET https://www.googleapis.com/drive/v3/files/{FILE_ID}/revisions/{REVISION_ID}?alt=mediaดาวน์โหลดเนื้อหาไฟล์ Blob ในเบราว์เซอร์
หากต้องการดาวน์โหลดเนื้อหาของไฟล์ Blob ที่จัดเก็บไว้ในไดรฟ์ภายในเบราว์เซอร์แทนที่จะผ่าน API ให้ใช้ฟิลด์ webContentLink ของแหล่งข้อมูล files หากผู้ใช้มีสิทธิ์เข้าถึงเพื่อดาวน์โหลดไฟล์
ระบบจะแสดงลิงก์สำหรับดาวน์โหลดไฟล์และเนื้อหาของไฟล์ คุณจะ
เปลี่ยนเส้นทางผู้ใช้ไปยัง URL นี้ หรือเสนอเป็นลิงก์ที่คลิกได้ก็ได้
ดาวน์โหลดเนื้อหาไฟล์ Blob ระหว่างการดำเนินการที่ใช้เวลานาน
หากต้องการดาวน์โหลดเนื้อหาของไฟล์ Blob ในระหว่างการดำเนินการที่ใช้เวลานาน ให้ใช้วิธีการ
files.download กับรหัสของ
ไฟล์ที่จะดาวน์โหลด คุณเลือกตั้งค่ารหัสของการแก้ไขได้ นี่เป็น
วิธีเดียวในการดาวน์โหลดไฟล์ Google Vids ดูข้อมูลเพิ่มเติมได้ที่จัดการ
การดำเนินการที่ใช้เวลานาน
ส่งออกเนื้อหาเอกสาร 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 หรือเสนอเป็นลิงก์ที่คลิกได้ก็ได้
ส่งออกเนื้อหาเอกสาร Google Workspace ในเบราว์เซอร์เป็นเวอร์ชันก่อนหน้า
หากต้องการส่งออกเนื้อหาเอกสาร Google Workspace ในเวอร์ชันก่อนหน้าภายในเบราว์เซอร์ ให้ใช้วิธี revisions.get โดยใช้รหัสของไฟล์ที่จะดาวน์โหลดและรหัสของการแก้ไขเพื่อสร้างลิงก์ส่งออกซึ่งคุณสามารถใช้ดาวน์โหลดได้ หากผู้ใช้มีสิทธิ์เข้าถึงเพื่อดาวน์โหลดไฟล์ ระบบจะแสดงลิงก์สำหรับดาวน์โหลดไฟล์และเนื้อหาของไฟล์ คุณจะ
เปลี่ยนเส้นทางผู้ใช้ไปยัง URL นี้ หรือเสนอเป็นลิงก์ที่คลิกได้ก็ได้
ส่งออกเนื้อหาเอกสาร Google Workspace ระหว่างการดำเนินการที่ใช้เวลานาน
หากต้องการส่งออกเนื้อหาเอกสาร Google Workspace ระหว่างการดำเนินการที่ใช้เวลานาน
ให้ใช้วิธี files.download กับรหัส
ของไฟล์ที่จะดาวน์โหลดและรหัสของการแก้ไข ดูข้อมูลเพิ่มเติมได้ที่จัดการการดำเนินการที่ใช้เวลานาน