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