ภาพขนาดย่อจะแสดงสำหรับเอกสารที่ผลการค้นหาแสดง ภาพขนาดย่อช่วยให้ผู้ใช้ระบุความเกี่ยวข้องของเอกสารที่แสดงได้ดียิ่งขึ้น ภาพปกมีลักษณะต่อไปนี้
- ความกว้าง 1024 พิกเซล
- URL สำหรับภาพขนาดย่อของไฟล์ Google Workspace ได้รับการปกป้องด้วย ACL URL สำหรับ ไฟล์ประเภทอื่นๆ ไม่ได้รับการปกป้องด้วย ACL
- URL จะหมดอายุหลังจากผ่านไป 5 นาที
- ระบบจะไม่สร้างภาพขนาดย่อสำหรับไฟล์ที่มีขนาดใหญ่กว่า 50 MB
- หากสร้างภาพปกไม่ได้ ระบบจะใช้ไอคอนตัวยึดตำแหน่ง หากสร้างภาพขนาดย่อ สำหรับรายการ Google Workspace ไม่ได้ URL ของภาพขนาดย่อจะแสดงผล "404 ไม่พบ" แอปพลิเคชันของคุณต้องจัดการลักษณะการทำงานนี้
ระบบจะสร้างภาพขนาดย่อโดยอัตโนมัติสำหรับไฟล์ใน Google ไดรฟ์ที่รองรับภาพขนาดย่อโดยธรรมชาติ เช่น ประเภทเอกสารของ Google Workspace (เอกสาร ชีต สไลด์ และอื่นๆ) นอกจากนี้ Cloud Search ยังสร้างภาพขนาดย่อโดยอัตโนมัติ สำหรับไฟล์ประเภทต่อไปนี้
- Microsoft Word (DOC)
- Microsoft Word (DOCX)
- Microsoft Excel (XLS)
- Microsoft Excel (XLSX)
- Microsoft PowerPoint (PPT)
- Microsoft Powerpoint (PPTX)
- Adobe Portable Document Format (PDF)
- Rich Text Format (RTF)
- รูปแบบข้อความ (TXT)
- Hypertext Markup Language (HTML)
- ภาษามาร์กอัปที่ขยายได้ (XML)
ระบบจะแสดงภาพขนาดย่อสำหรับรายการที่แหล่งข้อมูลและแอปพลิเคชันการค้นหา เปิดใช้ภาพขนาดย่อเท่านั้น
เปิดใช้ URL ของภาพขนาดย่อสำหรับแหล่งข้อมูล
โปรเจ็กต์แพลตฟอร์ม Cloud Search มีข้อมูลเข้าสู่ระบบบัญชีบริการ อย่างไรก็ตาม หากต้องการเปิดใช้ URL ของภาพขนาดย่อ คุณต้องสร้างคีย์ API และข้อมูลเข้าสู่ระบบของเว็บแอปพลิเคชัน แล้วใช้ข้อมูลเข้าสู่ระบบของเว็บแอปพลิเคชันเพื่อรับโทเค็นเพื่อการเข้าถึง สุดท้าย คุณใช้ข้อมูลเข้าสู่ระบบเหล่านี้เพื่อรับและอัปเดต แหล่งข้อมูล
- หากยังไม่ได้ทำ ให้สร้างหรือเลือกโปรเจ็กต์สำหรับแอปและเปิดใช้ API ดูข้อมูลเกี่ยวกับ 2 ขั้นตอนนี้ได้ที่ขั้นตอนที่ 1 และ 2 ของหัวข้อกำหนดค่าการเข้าถึง Google Cloud Search API
- สร้างคีย์ API โดยทำดังนี้
- ในคอนโซล Google Cloud ให้คลิกรายการแบบเลื่อนลงสร้างข้อมูลเข้าสู่ระบบ แล้วเลือกคีย์ API หน้า "สร้างคีย์ API แล้ว" จะปรากฏขึ้น
- จดคีย์ API
- คลิก "ปิด" ข้อมูลเข้าสู่ระบบที่สร้างใหม่จะปรากฏในส่วน "คีย์ API"
- สร้างข้อมูลเข้าสู่ระบบของเว็บแอปพลิเคชัน ใช้
https://developers.google.com/oauthplayground
เป็น URI การเปลี่ยนเส้นทาง . ดูขั้นตอนการสร้างข้อมูลเข้าสู่ระบบเหล่านี้ได้ที่ สร้างข้อมูลเข้าสู่ระบบของเว็บแอปพลิเคชัน (JavaScript ฝั่งไคลเอ็นต์) - ใน OAuth 2.0 Playground คลิกการกำหนดค่า OAuth 2.0
- เลือกใช้ข้อมูลเข้าสู่ระบบของคุณเอง
- ป้อนรหัสไคลเอ็นต์และรหัสลับไคลเอ็นต์ที่สร้างไว้ในขั้นตอนที่ 3
- ในช่องขอบเขต ให้พิมพ์
https://www.googleapis.com/auth/cloud_search.settings
แล้วคลิกให้สิทธิ์ API - (ไม่บังคับ) หากเห็นหน้าจอลงชื่อเข้าใช้ ให้เลือกบัญชีที่จะใช้
- (ไม่บังคับ) หากเห็นหน้าจอการให้สิทธิ์ ให้คลิกยอมรับ
- คลิกเปลี่ยนรหัสการให้สิทธิ์ของโทเค็น ระบบจะแสดงโทเค็น
- ระบุแหล่งข้อมูลที่คุณต้องการเปิดใช้ตัวควบคุมภาพขนาดย่อ
เรียกใช้
settings.datasources.get
เพื่อรับรหัสของแหล่งข้อมูลcurl 'https://cloudsearch.googleapis.com/v1/settings/datasource_id?key=[YOUR_API_KEY]' \ --header 'Authorization: Bearer [YOUR_ACCESS_TOKEN]'\ --header 'Accept: application/json' \ --compressed
สถานที่:
- datasource_id คือชื่อของแหล่งข้อมูลที่จะดึงข้อมูล
YOUR_API_KEY
คือคีย์ API สำหรับโปรเจ็กต์ของคุณ (ได้จากขั้นตอนที่ 2)YOUR_ACCESS_TOKEN
คือโทเค็นเพื่อการเข้าถึง OAuth 2.0 สำหรับโปรเจ็กต์ของคุณ (ได้จากขั้นตอนที่ 10)
ผลลัพธ์ที่สำเร็จจากคำสั่งนี้จะมีลักษณะคล้ายกับผลลัพธ์ต่อไปนี้
{ "source": { "name": "datasources/datasource_id", "displayName": "DataSource_Display_Name", "itemsVisibility": [ { "gsuiteDomain": true } ] } }
เรียกใช้
setting.datasource.update
โดยตั้งค่าreturnThumbnailUrls
เป็นtrue
เพื่อเปิดใช้ URL ของภาพขนาดย่อสำหรับแหล่งข้อมูลcurl --request PUT \ 'https://cloudsearch.googleapis.com/v1/settings/datasources/datasource_id?key=[YOUR_API_KEY]' \ --header 'Authorization: Bearer [YOUR_ACCESS_TOKEN]' \ --header 'Accept: application/json' \ --header 'Content-Type: application/json' \ --data '{"source":{"name":"datasources/datasource_id","displayName":"DataSource_Display_Name","itemsVisibility": [{"gsuiteDomain":true}],"returnThumbnailUrls":true}}' \ --compressed
สถานที่:
- datasource_id คือรหัสของแหล่งข้อมูลที่จะดึงข้อมูล
YOUR_API_KEY
คือคีย์ API สำหรับโปรเจ็กต์ของคุณ (ได้จากขั้นตอนที่ 2)YOUR_ACCESS_TOKEN
คือโทเค็นเพื่อการเข้าถึง OAuth 2.0 สำหรับโปรเจ็กต์ของคุณ (ได้จากขั้นตอนที่ 10)DataSource_DisplayName
คือชื่อที่แสดงที่ได้จากคำสั่ง cURL ก่อนหน้า"returnThumbnailsUrls":true
เปิดใช้ภาพขนาดย่อ
ผลลัพธ์ที่สำเร็จจากคำสั่งนี้จะมีลักษณะคล้ายกับผลลัพธ์ต่อไปนี้
{ "source": { "name": "datasources/datasource_id", "displayName": "DataSource_Display_Name", "itemsVisibility": [ { "gsuiteDomain": true } ], "returnThumbnailUrls": true } }
เปิดใช้ URL ของภาพขนาดย่อสำหรับแอปพลิเคชันการค้นหา
โปรเจ็กต์แพลตฟอร์ม Cloud Search มีข้อมูลเข้าสู่ระบบบัญชีบริการ อย่างไรก็ตาม หากต้องการเปิดใช้ URL ของภาพขนาดย่อ คุณต้องสร้างคีย์ API และข้อมูลเข้าสู่ระบบของเว็บแอปพลิเคชัน แล้วใช้ข้อมูลเข้าสู่ระบบของเว็บแอปพลิเคชันเพื่อรับโทเค็นเพื่อการเข้าถึง สุดท้าย คุณใช้ข้อมูลเข้าสู่ระบบเหล่านี้เพื่อรับและอัปเดต แอปพลิเคชันค้นหา
- หากยังไม่ได้ทำ ให้สร้างหรือเลือกโปรเจ็กต์สำหรับแอปและเปิดใช้ API ดูข้อมูลเกี่ยวกับ 2 ขั้นตอนนี้ได้ที่ขั้นตอนที่ 1 และ 2 ของหัวข้อกำหนดค่าการเข้าถึง Google Cloud Search API
- สร้างคีย์ API โดยทำดังนี้
- ใน Cloud Console ให้คลิกรายการแบบเลื่อนลงสร้างข้อมูลเข้าสู่ระบบ แล้วเลือกคีย์ API หน้า "สร้างคีย์ API แล้ว" จะปรากฏขึ้น
- จดคีย์ API
- คลิก "ปิด" ข้อมูลเข้าสู่ระบบที่สร้างใหม่จะปรากฏในส่วน "คีย์ API"
- สร้างข้อมูลเข้าสู่ระบบของเว็บแอปพลิเคชัน ใช้
https://developers.google.com/oauthplayground
เป็น URI การเปลี่ยนเส้นทาง . ดูขั้นตอนการสร้างข้อมูลเข้าสู่ระบบเหล่านี้ได้ที่ สร้างข้อมูลเข้าสู่ระบบของเว็บแอปพลิเคชัน (JavaScript ฝั่งไคลเอ็นต์) - ใน OAuth 2.0 Playground คลิกการกำหนดค่า OAuth 2.0
- เลือกใช้ข้อมูลเข้าสู่ระบบของคุณเอง
- ป้อนรหัสไคลเอ็นต์และรหัสลับไคลเอ็นต์ที่สร้างไว้ในขั้นตอนที่ 3
- ในช่องขอบเขต ให้พิมพ์
https://www.googleapis.com/auth/cloud_search.settings
แล้วคลิกให้สิทธิ์ API - (ไม่บังคับ) หากเห็นหน้าจอลงชื่อเข้าใช้ ให้เลือกบัญชีที่จะใช้
- (ไม่บังคับ) หากเห็นหน้าจอการให้สิทธิ์ ให้คลิกยอมรับ
- คลิกเปลี่ยนรหัสการให้สิทธิ์ของโทเค็น ระบบจะแสดงโทเค็น
- ระบุแอปพลิเคชันการค้นหาที่ต้องการเปิดใช้การควบคุมภาพขนาดย่อ
โทรหา
settings.searchapplications.get
เพื่อขอรหัสของแอปพลิเคชันการค้นหาcurl \ 'https://cloudsearch.googleapis.com/v1/settings/searchapplications/search_application_id?key=[YOUR_API_KEY]' \ --header 'Authorization: Bearer [YOUR_ACCESS_TOKEN]' \ --header 'Accept: application/json' \ --compressed
สถานที่:
คือรหัสของแอปพลิเคชันการค้นหาที่จะดึงข้อมูล YOUR_API_KEY
คือคีย์ API สำหรับโปรเจ็กต์ของคุณ (ได้จากขั้นตอนที่ 2)YOUR_ACCESS_TOKEN
คือโทเค็นเพื่อการเข้าถึง OAuth 2.0 สำหรับโปรเจ็กต์ของคุณ (ได้จากขั้นตอนที่ 10)
ผลลัพธ์ที่สำเร็จจากคำสั่งนี้จะมีลักษณะคล้ายกับผลลัพธ์ต่อไปนี้
{ "name": "searchapplications/search_application_id", "displayName": "SearchApp_Display_Name", "dataSourceRestrictions": [ { "source": { "name": "datasources/datasource_id" } } ] }
เรียกใช้
setting.searchapplications.update
โดยตั้งค่าreturnResultThumbnailUrls
เป็นtrue
เพื่อเปิดใช้ URL ของภาพขนาดย่อสำหรับ แอปพลิเคชันการค้นหาcurl --request PUT \ 'https://cloudsearch.googleapis.com/v1/settings/searchapplications/search_application_id?key=[YOUR_API_KEY]' \ --header 'Authorization: Bearer [YOUR_ACCESS_TOKEN]' \ --header 'Accept: application/json' \ --header 'Content-Type: application/json' \ --data '{"name":"searchapplications/search_application_id","displayName":"SearchApp_Display_Name","dataSourceRestrictions":[{"source": {"name":"datasources/datasource_id"}}],"returnResultThumbnailUrls":true}' \ --compressed
สถานที่:
คือรหัสของแอปพลิเคชันการค้นหาที่จะดึงข้อมูล YOUR_API_KEY
คือคีย์ API สำหรับโปรเจ็กต์ของคุณ (ได้จากขั้นตอนที่ 2)YOUR_ACCESS_TOKEN
คือโทเค็นเพื่อการเข้าถึง OAuth 2.0 สำหรับโปรเจ็กต์ของคุณ (ได้จากขั้นตอนที่ 10)SearchApp_DisplayName
คือชื่อที่แสดงที่ได้จากคำสั่ง cURL ก่อนหน้า"returnResultThumbnailUrls":true
เปิดใช้ภาพขนาดย่อ
ผลลัพธ์ที่สำเร็จจากคำสั่งนี้จะมีลักษณะคล้ายกับผลลัพธ์ต่อไปนี้
{ "name": "searchapplications/search_application_id", "displayName": "SearchApp_Display_Name", "dataSourceRestrictions": [ { "source": { "name": "datasources/datasource_id" } } ], "returnResultThumbnailUrls": true }
เข้าถึงภาพปก
หากต้องการเข้าถึงภาพขนาดย่อของไฟล์ Google Workspace ในไดรฟ์ ผู้ใช้หรือแอปพลิเคชันต้องส่งข้อมูลเข้าสู่ระบบของบัญชีเดียวกันกับที่ใช้เข้าถึงรายการใน Google ไดรฟ์