จัดการข้อมูลเมตาของไฟล์

เอกสารนี้ครอบคลุมถึงข้อควรพิจารณาที่สำคัญสำหรับการตั้งชื่อไฟล์และการทำงานกับ อย่างข้อความและภาพขนาดย่อที่จัดทำดัชนีได้ หากต้องการแทรกและเรียกข้อมูลไฟล์ โปรดดู ทรัพยากร 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)