Google Drive API ช่วยให้คุณสามารถอัปโหลดข้อมูลไฟล์เมื่อคุณสร้างหรืออัปเดต
File
สําหรับข้อมูลเกี่ยวกับวิธีสร้าง
ไฟล์ที่มีเฉพาะข้อมูลเมตา เช่น โฟลเดอร์ โปรดดูสร้างไฟล์ข้อมูลเมตาเท่านั้น
คุณอัปโหลดได้ 3 ประเภทดังนี้
การอัปโหลดแบบง่าย (
uploadType=media
): ใช้การอัปโหลดประเภทนี้เพื่อโอน ไฟล์สื่อขนาดเล็ก (ไม่เกิน 5 MB) โดยไม่มีข้อมูลเมตา หากต้องการดำเนินการ การอัปโหลดอย่างง่าย โปรดดูดำเนินการอัปโหลดอย่างง่ายการอัปโหลดหลายส่วน (
uploadType=multipart
): "ใช้การอัปโหลดประเภทนี้เพื่อ โอนไฟล์ขนาดเล็ก (ไม่เกิน 5 MB) พร้อมข้อมูลเมตาที่อธิบาย ในคำขอเดียว หากต้องการอัปโหลดหลายส่วน โปรดดูดำเนินการ การอัปโหลดหลายส่วนการอัปโหลดที่ดำเนินการต่อได้ (
uploadType=resumable
): ใช้การอัปโหลดประเภทนี้สำหรับ ไฟล์ขนาดใหญ่ (ใหญ่กว่า 5 MB) และเมื่อมีโอกาสสูงที่เครือข่าย เช่น เมื่อสร้างไฟล์จากแอปบนอุปกรณ์เคลื่อนที่ กลับมาใช้งานต่อได้ การอัปโหลดยังเป็นทางเลือกที่ดีสำหรับแอปพลิเคชันส่วนใหญ่ เนื่องจาก สำหรับไฟล์ขนาดเล็กที่มีค่าใช้จ่ายต่ำเมื่อมีคำขอ HTTP เพิ่มเติม 1 รายการต่อการอัปโหลด หากต้องการอัปโหลดที่ดำเนินการต่อได้ โปรดดูหัวข้อดำเนินการอัปโหลดต่อได้ อัปโหลด
ไลบรารีของไคลเอ็นต์ Google API จะใช้ประเภทต่อไปนี้อย่างน้อย 1 ประเภท ทั้งหมด โปรดดูที่ไลบรารีของไคลเอ็นต์ เอกสาร สำหรับรายละเอียดเพิ่มเติมเกี่ยวกับวิธี ที่ใช้แต่ละประเภท
ใช้ PATCH
เทียบกับ PUT
ขอทบทวนอีกครั้งว่า กริยา HTTP PATCH
รองรับการอัปเดตทรัพยากรไฟล์บางส่วน
ในขณะที่กริยา HTTP PUT
รองรับการแทนที่ทรัพยากรโดยสมบูรณ์ โปรดทราบว่าPUT
อาจนำการเปลี่ยนแปลงที่ส่งผลกับส่วนอื่นในระบบมาใช้เมื่อเพิ่มช่องใหม่ลงในทรัพยากรที่มีอยู่
เมื่ออัปโหลดแหล่งข้อมูลไฟล์ ให้ใช้หลักเกณฑ์ต่อไปนี้
- ใช้คำกริยา HTTP ที่บันทึกไว้ในการอ้างอิง API สำหรับคำขอเริ่มต้นของ การอัปโหลดที่กลับมาทำงานต่อได้ หรือคำขอเดียวสำหรับการอัปโหลดแบบง่ายหรือการอัปโหลดหลายส่วน
- ใช้
PUT
สำหรับคำขอที่ตามมาทั้งหมดสำหรับการอัปโหลดที่ดำเนินการต่อได้เมื่อ ได้เริ่มคำขอแล้ว คำขอเหล่านี้อัปโหลดเนื้อหาไม่ว่าในกรณีใด เมธอดที่เรียกใช้
ทำการอัปโหลดอย่างง่าย
หากต้องการทำการอัปโหลดอย่างง่าย ให้ใช้
เมธอด files.create
ด้วย
uploadType=media
รายการต่อไปนี้แสดงวิธีการอัปโหลดอย่างง่าย:
HTTP
สร้างคำขอ
POST
ไปยัง URI /upload ของเมธอดที่มีคำค้นหา พารามิเตอร์ของuploadType=media
:POST https://www.googleapis.com/upload/drive/v3/files?uploadType=media
เพิ่มข้อมูลของไฟล์ในเนื้อหาคำขอ
เพิ่มส่วนหัว HTTP ต่อไปนี้
Content-Type
ตั้งค่าเป็นประเภทสื่อ MIME ของออบเจ็กต์ที่กำลังอยู่ ที่อัปโหลดContent-Length
กำหนดจำนวนไบต์ที่คุณอัปโหลด หากคุณใช้ การเข้ารหัสการโอนเป็นกลุ่ม ไม่จำเป็นต้องใช้ส่วนหัวนี้
ส่งคำขอ หากคำขอประสบความสำเร็จ เซิร์ฟเวอร์จะส่งคืนรหัสสถานะ
HTTP 200 OK
พร้อมกับข้อมูลเมตาของไฟล์ {HTTP}
เมื่อคุณทำการอัปโหลดแบบง่ายๆ จะมีการสร้างข้อมูลเมตาพื้นฐานและแอตทริบิวต์บางรายการ
จะอนุมานจากไฟล์ เช่น ประเภท MIME หรือ modifiedTime
คุณสามารถใช้
การอัปโหลดอย่างง่าย ในกรณีที่คุณมีไฟล์ขนาดเล็ก และข้อมูลเมตาของไฟล์
เป็นอย่างมาก
ดำเนินการอัปโหลดหลายส่วน
คำขออัปโหลดที่มีหลายส่วน ช่วยให้คุณสามารถอัปโหลดข้อมูลเมตาและข้อมูล อีกครั้ง ใช้ตัวเลือกนี้ถ้าข้อมูลที่คุณส่งมีขนาดเล็กพอที่จะอัปโหลดอีกครั้ง ทั้งหมด หากการเชื่อมต่อล้มเหลว
หากต้องการอัปโหลดหลายส่วน ให้ใช้
เมธอด files.create
ด้วย
uploadType=multipart
ข้อมูลต่อไปนี้แสดงวิธีการอัปโหลดหลายส่วน
Java
Python
Node.js
PHP
.NET
HTTP
สร้างคำขอ
POST
ไปยัง URI /upload ของเมธอดที่มีคำค้นหา พารามิเตอร์ของuploadType=multipart
:POST https://www.googleapis.com/upload/drive/v3/files?uploadType=multipart
สร้างเนื้อหาของคำขอ จัดรูปแบบเนื้อหาตาม ประเภทเนื้อหาแบบหลายส่วน/ที่เกี่ยวข้อง RFC 2387 ซึ่งมี 2 ส่วน ได้แก่
- ข้อมูลเมตา ข้อมูลเมตาต้องมาก่อนและต้องมี
Content-Type
ตั้งค่าส่วนหัวเป็นapplication/json;
charset=UTF-8
เพิ่มข้อมูลเมตาของไฟล์ ในรูปแบบ JSON - สื่อ สื่อต้องมาก่อนลำดับที่ 2 และต้องมีส่วนหัว
Content-Type
ประเภท MIME เพิ่มข้อมูลของไฟล์ในส่วนสื่อ
ระบุแต่ละส่วนด้วยสตริงขอบเขต ซึ่งนำหน้าด้วยขีดกลาง 2 ตัว ใน นอกจากนี้ ให้เพิ่มขีดกลาง 2 ตัวหลังสตริงขอบเขตสุดท้าย
- ข้อมูลเมตา ข้อมูลเมตาต้องมาก่อนและต้องมี
เพิ่มส่วนหัว HTTP ระดับบนสุดต่อไปนี้
Content-Type
ตั้งค่าเป็นmultipart/related
และรวมขอบเขต สตริงที่คุณใช้ระบุส่วนต่างๆ ของคำขอ สำหรับ ตัวอย่าง:Content-Type: multipart/related; boundary=foo_bar_baz
Content-Length
ตั้งค่าเป็นจำนวนไบต์ทั้งหมดในเนื้อความของคำขอ
ส่งคำขอ
หากต้องการสร้างหรืออัปเดตเฉพาะส่วนข้อมูลเมตา โดยไม่มีข้อมูลที่เชื่อมโยง
ส่งคำขอ POST
หรือ PATCH
ไปยังปลายทางทรัพยากรมาตรฐาน
https://www.googleapis.com/drive/v3/files
หากคำขอประสบความสำเร็จ
เซิร์ฟเวอร์จะส่งคืนรหัสสถานะ HTTP 200 OK
พร้อมกับ
ข้อมูลเมตา
เมื่อสร้างไฟล์ ผู้ใช้ควรระบุนามสกุลไฟล์ใน name
ของไฟล์
ด้วย เช่น เมื่อสร้างไฟล์ JPEG รูปภาพ คุณอาจระบุบางอย่าง
เช่น "name": "photo.jpg"
ในข้อมูลเมตา การเรียก files.get
ที่ตามมาจะแสดงพร็อพเพอร์ตี้ fileExtension
แบบอ่านอย่างเดียว
ที่มีส่วนขยายซึ่งระบุไว้ก่อนหน้านี้ในช่อง name
ดำเนินการอัปโหลดที่ดำเนินการต่อได้
การอัปโหลดที่ดำเนินการต่อได้ช่วยให้คุณดำเนินการอัปโหลดต่อได้หลังจากที่มีการสื่อสาร จะขัดขวางการรับส่งข้อมูล เพราะคุณไม่ต้องรีสตาร์ท การอัปโหลดไฟล์ตั้งแต่ต้น การอัปโหลดต่อได้จะช่วยลดแบนด์วิดท์ ในกรณีที่เครือข่ายล้มเหลว
การอัปโหลดที่ดำเนินการต่อได้มีประโยชน์เมื่อขนาดไฟล์ของคุณอาจแตกต่างกันอย่างมาก หรือในกรณีที่ มีการจำกัดเวลาที่แน่นอนสำหรับคำขอ (เช่น งานที่ทำงานอยู่เบื้องหลังของระบบปฏิบัติการบนอุปกรณ์เคลื่อนที่ คำขอ App Engine บางรายการ) นอกจากนี้ คุณอาจใช้การอัปโหลดที่ดำเนินการต่อได้สำหรับ ที่คุณต้องการแสดงแถบความคืบหน้าในการอัปโหลด
การอัปโหลดที่ดำเนินการต่อได้ประกอบด้วยขั้นตอนระดับสูงหลายขั้นตอนดังนี้
- ส่งคำขอเริ่มต้นและเรียก URI ของเซสชันที่ดำเนินการต่อได้
- อัปโหลดข้อมูลและตรวจสอบสถานะการอัปโหลด
- (ไม่บังคับ) หากการอัปโหลดถูกรบกวน ให้อัปโหลดต่อ
ส่งคำขอเริ่มต้น
หากต้องการเริ่มการอัปโหลดที่ดำเนินการต่อได้ ให้ใช้
เมธอด files.create
ด้วย
uploadType=resumable
HTTP
สร้างคำขอ
POST
ไปยัง URI /upload ของเมธอดที่มีคำค้นหา พารามิเตอร์ของuploadType=resumable
:POST https://www.googleapis.com/upload/drive/v3/files?uploadType=resumable
หากคำขอเริ่มต้นสำเร็จ การตอบกลับจะมี
200 OK
รหัสสถานะ HTTP นอกจากนี้ยังมีส่วนหัวLocation
ที่ ระบุ URI ของเซสชันที่เรียกได้ว่าดำเนินการต่อได้HTTP/1.1 200 OK Location: https://www.googleapis.com/upload/drive/v3/files?uploadType=resumable&upload_id=xa298sd_sdlkj2 Content-Length: 0
บันทึก URI เซสชันที่ดำเนินการต่อได้เพื่อให้คุณอัปโหลดข้อมูลไฟล์และการค้นหา สถานะการอัปโหลด URI เซสชันที่ดำเนินการต่อได้จะหมดอายุหลังจากผ่านไป 1 สัปดาห์
หากคุณมีข้อมูลเมตาสำหรับไฟล์ ให้เพิ่มข้อมูลเมตาลงในเนื้อหาคำขอ ในรูปแบบ JSON หรือปล่อยเนื้อหาคำขอว่างไว้
เพิ่มส่วนหัว HTTP ต่อไปนี้
X-Upload-Content-Type
(ไม่บังคับ) ตั้งค่าเป็นประเภท MIME ของไฟล์ ซึ่งจะโอนไปในคำขอที่ตามมา หากประเภท MIME ของข้อมูลที่ไม่ได้ระบุไว้ในข้อมูลเมตาหรือผ่านส่วนหัวนี้ ออบเจ็กต์ทำหน้าที่เป็นapplication/octet-stream.
X-Upload-Content-Length
(ไม่บังคับ) กำหนดเป็นจำนวนไบต์ของ ซึ่งมีการโอนในคำขอต่อๆ มาContent-Type
ต้องระบุหากคุณมีข้อมูลเมตาสำหรับไฟล์ กำหนดเป็นapplication/json;
charset=UTF-8
Content-Length
ต้องระบุ ยกเว้นในกรณีที่คุณใช้การเข้ารหัสการโอนเป็นกลุ่ม กำหนดเป็นจำนวนไบต์ในเนื้อหาของคำขอเริ่มต้นนี้
ส่งคำขอ หากคำขอเริ่มเซสชันสำเร็จ การตอบกลับจะมีรหัสสถานะ
200 OK HTTP
นอกจากนี้ การตอบกลับ มีส่วนหัวLocation
ที่ระบุ URI ของเซสชันที่เรียกได้ว่าดำเนินการต่อได้ ใช้ URI เซสชันที่ดำเนินการต่อได้เพื่ออัปโหลดข้อมูลไฟล์และค้นหา สถานะการอัปโหลด URI เซสชันที่ดำเนินการต่อได้จะหมดอายุหลังจากผ่านไป 1 สัปดาห์คัดลอกและบันทึก URL ของเซสชันที่ดำเนินการต่อได้
ไปที่อัปโหลดเนื้อหาต่อ
อัปโหลดเนื้อหา
การอัปโหลดไฟล์ที่มีเซสชันที่กลับมาทำงานต่อได้มี 2 วิธีดังนี้
- อัปโหลดเนื้อหาในคำขอเดียว: ใช้วิธีการนี้เมื่อไฟล์สามารถ จะอัปโหลดในคำขอเดียว หากไม่มีการจำกัดเวลาที่แน่นอนสำหรับ หรือไม่ต้องแสดงตัวระบุความคืบหน้าในการอัปโหลด ช่วงเวลานี้ วิธีที่ดีที่สุด เนื่องจากต้องการคำขอน้อยลงและให้ผลลัพธ์ที่ดีขึ้น ด้านประสิทธิภาพ
อัปโหลดเนื้อหาเป็นกลุ่ม: ใช้วิธีนี้หากจำเป็น ลดจำนวนข้อมูลที่โอนในคำขอหนึ่งๆ คุณอาจต้อง เพื่อลดการโอนข้อมูลเมื่อมีการจำกัดเวลาที่แน่นอนสำหรับผู้ใช้แต่ละราย เช่น ในกรณีของคำขอ App Engine บางคลาส แนวทางนี้ยังมีประโยชน์ในกรณีที่คุณต้องระบุตัวบ่งชี้ที่กำหนดเองเพื่อ แสดงความคืบหน้าในการอัปโหลด
HTTP - คำขอเดียว
- สร้างคำขอ
PUT
ไปยัง URI เซสชันที่ดำเนินการต่อได้ - เพิ่มข้อมูลของไฟล์ในเนื้อหาคำขอ
- เพิ่มส่วนหัว HTTP ความยาวของเนื้อหา โดยกำหนดจำนวนไบต์ในไฟล์
- ส่งคำขอ หากคำขออัปโหลดถูกขัดจังหวะ หรือหากคุณได้รับ
5xx
โปรดทำตามขั้นตอนในการอัปโหลดที่หยุดชะงักต่อ
HTTP - คำขอหลายรายการ
สร้างคำขอ
PUT
ไปยัง URI เซสชันที่ดำเนินการต่อได้เพิ่มข้อมูลของกลุ่มลงในเนื้อหาคำขอ สร้างกลุ่มโดยแบ่งเป็นพหุคูณ ขนาด 256 KB (256 x 1024 ไบต์) ยกเว้นส่วนสุดท้ายที่สมบูรณ์ การอัปโหลด ทำให้กลุ่มมีขนาดใหญ่ที่สุดเท่าที่จะทำได้เพื่อให้การอัปโหลด มีประสิทธิภาพ
เพิ่มส่วนหัว HTTP ต่อไปนี้
Content-Length
กําหนดจํานวนไบต์ในกลุ่มปัจจุบันContent-Range
ตั้งค่าเพื่อแสดงไบต์ในไฟล์ที่คุณอัปโหลด สำหรับ ตัวอย่างเช่นContent-Range: bytes 0-524287/2000000
จะแสดงว่าคุณอัปโหลด 524,288 ไบต์แรก (256 x 1024 x 2) ในไฟล์ขนาด 2,000,000 ไบต์
ส่งคำขอและประมวลผลการตอบกลับ หากคำขออัปโหลดคือ หยุดชะงัก หรือหากคุณได้รับการตอบกลับ
5xx
ให้ทำตามขั้นตอนใน อัปโหลดที่หยุดชะงักต่อทำซ้ำขั้นตอนที่ 1 ถึง 4 สำหรับแต่ละกลุ่มที่เหลืออยู่ในไฟล์ ใช้เมนู
Range
ในการตอบกลับเพื่อกำหนดตำแหน่งที่จะเริ่มกลุ่มถัดไป อย่าคิดว่าเซิร์ฟเวอร์ได้รับไบต์ทั้งหมดที่ส่งในคำขอก่อนหน้า
เมื่ออัปโหลดไฟล์ทั้งไฟล์เสร็จแล้ว คุณจะได้รับ 200 OK
หรือ
201 Created
พร้อมกับข้อมูลเมตาที่เชื่อมโยงกับทรัพยากร
ดำเนินการอัปโหลดที่หยุดชะงักต่อ
หากคำขออัปโหลดถูกยุติก่อนการตอบกลับ หรือหากได้รับการตอบกลับ503
Service Unavailable
คุณต้องกลับมาอัปโหลดที่หยุดชะงักอีกครั้ง
HTTP
หากต้องการขอสถานะการอัปโหลด ให้สร้างคำขอ
PUT
ที่ว่างเปล่าไปยัง URI เซสชันที่เรียกกลับมาทำงานอีกครั้งเพิ่มส่วนหัว
Content-Range
เพื่อระบุว่าตำแหน่งปัจจุบันใน ไม่รู้จักไฟล์ ตัวอย่างเช่น ตั้งค่าContent-Range
เป็น*/2000000
หาก ความยาวรวมของไฟล์คือ 2,000,000 ไบต์ หากคุณไม่ทราบขนาดเต็มของ ให้ตั้งค่าContent-Range
เป็น*/*
ส่งคำขอ
ประมวลผลคำตอบ
- การตอบกลับ
200 OK
หรือ201 Created
บ่งบอกว่าการอัปโหลดเป็น เสร็จสมบูรณ์ และไม่จำเป็นต้องดำเนินการใดๆ เพิ่มเติม - การตอบกลับ
308 Resume Incomplete
ระบุว่าคุณต้องดำเนินการต่อ เพื่ออัปโหลดไฟล์ - การตอบกลับ
404 Not Found
ระบุว่าเซสชันการอัปโหลดหมดอายุแล้ว และ จะต้องเริ่มอัปโหลดใหม่ตั้งแต่ต้น
- การตอบกลับ
หากคุณได้รับการตอบกลับ
308 Resume Incomplete
ให้ประมวลผลRange
ของการตอบกลับเพื่อระบุไบต์ที่เซิร์ฟเวอร์ได้รับ หาก การตอบกลับไม่มีส่วนหัวRange
จึงไม่ได้รับไบต์ ตัวอย่างเช่น ส่วนหัวRange
ของbytes=0-42
จะระบุว่า ได้รับไฟล์ขนาด 43 ไบต์และชิ้นส่วนถัดไปที่จะอัปโหลด จะขึ้นต้นด้วยไบต์ 44เมื่อคุณทราบแล้วว่าจะอัปโหลดต่อได้จากที่ใด ให้อัปโหลดไฟล์ต่อ เริ่มต้นด้วยไบต์ถัดไป มี
Content-Range
เพื่อระบุว่าส่วนใดของไฟล์ที่คุณส่ง สำหรับ ตัวอย่างเช่นContent-Range: bytes 43-1999999
บ่งบอกว่าคุณ ส่งไบต์ 44 ถึง 2,000,000
จัดการข้อผิดพลาดในการอัปโหลดสื่อ
เมื่อคุณอัปโหลดสื่อ โปรดทำตามแนวทางปฏิบัติแนะนำเหล่านี้เพื่อจัดการข้อผิดพลาด
- หากเกิดข้อผิดพลาด
5xx
รายการ ให้อัปโหลดต่อหรือลองอัปโหลดอีกครั้งที่ไม่สำเร็จเนื่องจากการเชื่อมต่อ การรบกวน ดูข้อมูลเพิ่มเติมเกี่ยวกับการจัดการข้อผิดพลาด5xx
ได้ที่ ข้อผิดพลาด 500, 502, 503, 504 - หากพบข้อผิดพลาด
403 rate limit
รายการ ให้ลองอัปโหลดอีกครั้ง สำหรับข้อมูลเพิ่มเติมเกี่ยวกับ การจัดการข้อผิดพลาด403 rate limit
โปรดดูข้อผิดพลาด 403:rateLimitExceeded
- สำหรับข้อผิดพลาด
4xx
(รวมถึง403
) ระหว่างการอัปโหลดที่ดำเนินการต่อได้ ให้รีสตาร์ท การอัปโหลด ข้อผิดพลาดเหล่านี้ระบุว่าเซสชันการอัปโหลดหมดอายุแล้วและ รีสตาร์ทโดยขอ URI เซสชันใหม่ อัปโหลดเซสชัน จะหมดอายุหลังจากไม่มีการใช้งานนาน 1 สัปดาห์
นำเข้าเป็นประเภท Google เอกสาร
เมื่อสร้างไฟล์ในไดรฟ์ คุณอาจต้องการแปลงไฟล์ ลงในประเภทไฟล์ Google Workspace เช่น Google เอกสารหรือ ชีต ตัวอย่างเช่น คุณอาจต้องการเปลี่ยนรูปแบบเอกสารจาก โปรแกรมประมวลผลคำที่คุณชื่นชอบลงในเอกสารเพื่อใช้ประโยชน์จาก ใหม่ๆ
หากต้องการแปลงไฟล์เป็นประเภทเฉพาะของ Google Workspace ให้ระบุ
mimeType
ของ Google Workspace เมื่อสร้างไฟล์
ข้อมูลต่อไปนี้แสดงวิธีแปลงไฟล์ CSV เป็นชีต Google Workspace
Java
Python
Node.js
PHP
.NET
หากต้องการดูว่ามี Conversion พร้อมใช้งานหรือไม่ ให้ตรวจสอบอาร์เรย์ importFormats
ของทรัพยากร about
ก่อนสร้างไฟล์
Conversion ที่รองรับจะแสดงแบบไดนามิกในอาร์เรย์นี้ พบบ่อย
รูปแบบการนำเข้าได้แก่
จาก | ถึง |
---|---|
Microsoft Word, OpenDocument Text, HTML, RTF, ข้อความธรรมดา | Google เอกสาร |
Microsoft Excel, สเปรดชีต OpenDocument, CSV, TSV, ข้อความธรรมดา | Google ชีต |
Microsoft PowerPoint, OpenDocument งานนำเสนอ | Google สไลด์ |
JPEG, PNG, GIF, BMP, PDF | Google เอกสาร (ฝังรูปภาพไว้ในเอกสาร) |
ข้อความธรรมดา (ประเภท MIME พิเศษ), JSON | Google Apps Script |
เมื่อคุณอัปโหลดและแปลงสื่อระหว่างการขอupdate
ไปยัง
ไฟล์เอกสาร ชีต หรือสไลด์
เนื้อหาทั้งหมดของเอกสารจะถูกแทนที่
เมื่อคุณแปลงรูปภาพเป็นเอกสาร ไดรฟ์จะใช้
การรู้จำอักขระด้วยภาพ (OCR) เพื่อแปลงรูปภาพเป็นข้อความ คุณสามารถ
ปรับปรุงคุณภาพของอัลกอริทึม OCR ด้วยการระบุ BCP ที่เกี่ยวข้อง
47 รหัสภาษา
ในช่วง
ocrLanguage
พารามิเตอร์ ข้อความที่ดึงออกมาจะปรากฏในเอกสารพร้อมกับรูปภาพที่ฝัง
ใช้รหัสที่สร้างไว้ล่วงหน้าเพื่ออัปโหลดไฟล์
Drive API ช่วยให้คุณเรียกข้อมูลรายการรหัสไฟล์ที่สร้างขึ้นล่วงหน้า
ซึ่งใช้ในการอัปโหลดและสร้างทรัพยากร คำขออัปโหลดและสร้างไฟล์สามารถ
ใช้รหัสที่สร้างไว้ล่วงหน้าเหล่านี้ ตั้งค่าช่อง id
ในข้อมูลเมตาของไฟล์
หากต้องการสร้างรหัสที่สร้างไว้ล่วงหน้า โปรดโทร
files.generateIds
ที่มีตัวเลือก
จำนวนรหัสที่จะสร้าง
คุณสามารถลองอัปโหลดอีกครั้งได้อย่างปลอดภัยโดยใช้รหัสที่สร้างขึ้นล่วงหน้าหากพบว่า
เซิร์ฟเวอร์มีข้อผิดพลาดหรือหมดเวลา หากสร้างไฟล์เรียบร้อยแล้ว ให้ดำเนินการต่อไปนี้
การลองส่งอีกครั้งจะแสดงข้อผิดพลาด HTTP 409
และจะไม่สร้างไฟล์ที่ซ้ำกัน
กำหนดข้อความที่จัดทำดัชนีได้สำหรับประเภทไฟล์ที่ไม่รู้จัก
ผู้ใช้จะใช้ UI ของไดรฟ์เพื่อค้นหาเนื้อหาเอกสารได้ นอกจากนี้คุณยัง
ใช้ files.list
และ fullText
เพื่อค้นหาเนื้อหาจากแอปของคุณ โปรดดูข้อมูลเพิ่มเติมที่หัวข้อค้นหา
ไฟล์และโฟลเดอร์
ไดรฟ์จะจัดทำดัชนีเอกสารโดยอัตโนมัติสำหรับการค้นหาเมื่อมีการ
จดจำประเภทไฟล์ รวมถึงเอกสารข้อความ, PDF, รูปภาพที่มีข้อความ และ
ประเภทอื่นๆ ที่ใช้บ่อย หากแอปบันทึกไฟล์ประเภทอื่นๆ (เช่น ภาพวาด
วิดีโอและทางลัด) คุณสามารถปรับปรุงการค้นพบได้โดยใส่
ข้อความที่จัดทำดัชนีได้ในช่อง contentHints.indexableText
ของไฟล์
โปรดดูข้อมูลเพิ่มเติมเกี่ยวกับข้อความที่จัดทำดัชนีได้ที่หัวข้อจัดการไฟล์ ข้อมูลเมตา