เอกสารนี้ครอบคลุมถึงข้อควรพิจารณาที่สำคัญสำหรับการตั้งชื่อไฟล์และการทำงานกับ
อย่างข้อความและภาพขนาดย่อที่จัดทำดัชนีได้ หากต้องการแทรกและเรียกข้อมูลไฟล์ โปรดดู
ทรัพยากร files
ระบุชื่อและนามสกุลไฟล์
แอปควรระบุนามสกุลไฟล์ในพร็อพเพอร์ตี้ชื่อเมื่อแทรกไฟล์
ด้วย Google Drive API ตัวอย่างเช่น การดำเนินการแทรกไฟล์ JPEG
ระบุสิ่งต่างๆ เช่น "name": "cat.jpg" ในข้อมูลเมตา
การตอบกลับ GET ครั้งต่อๆ ไปสามารถมีพร็อพเพอร์ตี้ fileExtension แบบอ่านอย่างเดียวได้
สร้างขึ้นด้วยส่วนขยายที่ระบุไว้ในพร็อพเพอร์ตี้ name ในตอนแรก เมื่อ
ผู้ใช้ Google ไดรฟ์ส่งคำขอดาวน์โหลดไฟล์ หรือเมื่อมีการดาวน์โหลดไฟล์
ผ่านไคลเอ็นต์การซิงค์ ไดรฟ์จะสร้างชื่อไฟล์แบบเต็ม (ที่มี
ส่วนขยาย) ตามชื่อ ในกรณีที่ไม่มีส่วนขยาย
ไดรฟ์จะพยายามระบุส่วนขยายตามไฟล์
ประเภท MIME
บันทึกข้อความที่จัดทำดัชนีได้
ไดรฟ์จะจัดทำดัชนีเอกสารโดยอัตโนมัติสำหรับการค้นหาเมื่อมีการ
จดจำประเภทไฟล์ รวมถึงเอกสารข้อความ, PDF, รูปภาพที่มีข้อความ และ
ประเภทอื่นๆ ที่ใช้บ่อย หากแอปบันทึกไฟล์ประเภทอื่นๆ (เช่น ภาพวาด
วิดีโอและทางลัด) คุณสามารถปรับปรุงการค้นพบได้โดยใส่
ข้อความที่จัดทำดัชนีได้ในช่อง contentHints.indexableText ของไฟล์
ข้อความที่จัดทำดัชนีได้จะมีการจัดทำดัชนีเป็น HTML ถ้าคุณบันทึกสตริงข้อความที่จัดทำดัชนีได้
<section attribute="value1">Here's some text</section> แล้วพูดว่า "นี่ไง
ข้อความ" ได้รับการจัดทำดัชนีแล้ว แต่ "value1" ใช้ไม่ได้ ด้วยเหตุนี้ การบันทึก XML เป็น "จัดทำดัชนีได้"
text ไม่มีประโยชน์เท่ากับการบันทึก HTML
โปรดคํานึงถึงสิ่งต่อไปนี้เมื่อระบุ indexableText ด้วย
contentHints.indexableTextมีขนาดสูงสุดได้ไม่เกิน 128 KB- จับคำสำคัญและแนวคิดที่คุณคาดหวังให้ผู้ใช้ค้นหา
- อย่าพยายามจัดเรียงข้อความตามลำดับความสำคัญเนื่องจากผู้จัดทำดัชนีดำเนินการเอง มีประสิทธิภาพมากขึ้น
- แอปพลิเคชันควรอัปเดตข้อความที่จัดทำดัชนีได้ทุกครั้งที่บันทึก
- ตรวจสอบว่าข้อความเกี่ยวข้องกับเนื้อหาหรือข้อมูลเมตาของไฟล์
ประเด็นสุดท้ายนี้อาจจะดูชัดเจนอยู่แล้ว แต่ก็เป็นสิ่งที่สำคัญ คุณไม่ควรที่จะ เพิ่มคำค้นหาที่ใช้กันโดยทั่วไปเพื่อบังคับให้ไฟล์ปรากฏในผลการค้นหา ช่วงเวลานี้ อาจทำให้ผู้ใช้ไม่พอใจ และอาจกระตุ้นให้พวกเขาลบไฟล์ด้วย
อัปโหลดภาพขนาดย่อ
ไดรฟ์จะสร้างภาพขนาดย่อโดยอัตโนมัติสำหรับไฟล์ทั่วไปจำนวนมาก เช่น Google เอกสาร, ชีต และสไลด์ ภาพขนาดย่อช่วยให้ผู้ใช้ระบุไฟล์ในไดรฟ์ได้ดียิ่งขึ้น
สำหรับประเภทไฟล์ที่ไดรฟ์สร้างภาพขนาดย่อมาตรฐานไม่ได้
คุณสามารถจัดเตรียมภาพขนาดย่อที่สร้างโดยแอปพลิเคชันของคุณได้ ระหว่าง
การสร้างหรืออัปเดตไฟล์ ให้อัปโหลดภาพขนาดย่อโดยการตั้งค่า
ช่อง contentHints.thumbnail ในแหล่งข้อมูล files
กล่าวอย่างเจาะจงคือ
- ตั้งค่าช่อง
contentHints.thumbnail.imageเป็น URL และชื่อไฟล์ที่ปลอดภัย รูปภาพที่เข้ารหัส base64 (โปรดดูส่วน RFC 4648 5) - ตั้งค่าช่อง
contentHints.thumbnail.mimeTypeเป็นประเภท MIME ที่เหมาะสม เป็นภาพขนาดย่อ
หากไดรฟ์สามารถสร้างภาพขนาดย่อจากไฟล์ได้ ไดรฟ์จะใช้เมธอด สร้างโดยอัตโนมัติ และไม่สนใจสิ่งที่คุณอาจเคยอัปโหลด หากทำไม่ได้ สร้างภาพขนาดย่อ โดยใช้ภาพที่คุณให้ไว้
ภาพปกต้องเป็นไปตามกฎต่อไปนี้
- ซึ่งอัปโหลดเป็นรูปแบบ PNG, GIF หรือ JPG ได้
- ความกว้างที่แนะนำคือ 1600 พิกเซล
- ความกว้างต่ำสุดคือ 220 พิกเซล
- ขนาดไฟล์สูงสุดคือ 2 MB
- แอปพลิเคชันควรได้รับการอัปเดตด้วยการบันทึกแต่ละครั้ง
สำหรับข้อมูลเพิ่มเติม โปรดดูแหล่งข้อมูล files
ดึงข้อมูลภาพขนาดย่อ
คุณสามารถเรียกข้อมูลเมตารวมถึงภาพขนาดย่อสำหรับไฟล์ในไดรฟ์ได้
ข้อมูลภาพขนาดย่อเก็บอยู่ในช่อง thumbnailLink ของ
แหล่งข้อมูล files
แสดงภาพขนาดย่อที่ต้องการ
ตัวอย่างโค้ดต่อไปนี้แสดง
คำขอเมธอด files.get ที่มี
หลายฟิลด์เป็นพารามิเตอร์การค้นหาที่จะส่งคืนข้อมูลเมตา thumbnailLink สำหรับ
ไฟล์ที่ต้องการ สำหรับข้อมูลเพิ่มเติม โปรดดูส่งคืนช่องที่ต้องการสำหรับ
ไฟล์
GET https://www.googleapis.com/drive/v3/files/FILE_ID?fields=id,name,mimeType,thumbnailLink
แทนที่ FILE_ID ด้วย fileId ของไฟล์ที่ต้องการ
ค้นหา
หากมี คำขอจะแสดง URL ที่มีอายุสั้นไปยังภาพขนาดย่อของไฟล์
โดยปกติแล้ว ลิงก์ดังกล่าวจะใช้งานได้หลายชั่วโมง ระบบจะเติมข้อมูลในช่องนี้เมื่อ
แอปที่ส่งคำขอสามารถเข้าถึงเนื้อหาของไฟล์ได้ หากยังไม่ได้แชร์ไฟล์
แบบสาธารณะ URL ที่แสดงผลใน thumbnailLink จะต้องดึงข้อมูลโดยใช้
คำขอที่มีข้อมูลรับรอง
แสดงรายการภาพขนาดย่อ
ตัวอย่างโค้ดต่อไปนี้แสดง
คำขอเมธอด files.list ที่มี
หลายฟิลด์เป็นพารามิเตอร์การค้นหาที่จะส่งคืนข้อมูลเมตา thumbnailLink สำหรับ
รายการไฟล์ โปรดดูข้อมูลเพิ่มเติมที่หัวข้อค้นหาไฟล์และ
โฟลเดอร์
GET https://www.googleapis.com/drive/v3/files/?fields=files(id,name,mimeType,thumbnailLink)
หากต้องการจำกัดผลการค้นหาให้แสดงเฉพาะประเภทไฟล์ที่ต้องการ ให้ใช้สตริงคำค้นหากับ ให้กำหนดประเภท MIME ตัวอย่างเช่น ตัวอย่างโค้ดต่อไปนี้แสดงวิธีจำกัด เป็นไฟล์ Google ชีตได้ สำหรับข้อมูลเพิ่มเติมเกี่ยวกับประเภท MIME โปรดดูที่ MIME ที่รองรับ Google Workspace และ Google ไดรฟ์ ประเภทต่างๆ
GET https://www.googleapis.com/drive/v3/files/q=mimeType='application/vnd.google-apps.spreadsheet'&fields=files(id,name,mimeType,thumbnailLink)