ภาพขนาดย่อจะแสดงสำหรับเอกสารที่แสดงผลการค้นหา ภาพปกช่วยให้ผู้ใช้ระบุความเกี่ยวข้องของเอกสารที่ส่งคืนได้ดียิ่งขึ้น ภาพปกมีลักษณะต่อไปนี้
- ความกว้าง 1024 พิกเซล
- URL สำหรับภาพขนาดย่อของไฟล์ Google Workspace มีการป้องกัน ACL URL สำหรับไฟล์ประเภทอื่นๆ ไม่มีการป้องกันด้วย ACL
- URL จะหมดอายุหลังจากผ่านไป 5 นาที
- แต่จะไม่สร้างภาพขนาดย่อสำหรับไฟล์ที่มีขนาดใหญ่กว่า 50 MB
- หากสร้างภาพขนาดย่อไม่ได้ ระบบจะใช้ไอคอนตัวยึดตำแหน่ง หากสร้างภาพขนาดย่อ สำหรับรายการใน Google Workspace ไม่ได้ URL ของภาพขนาดย่อจะแสดงผล "404 Not Found" แอปพลิเคชันของคุณต้องจัดการกับการทำงานนี้
ระบบจะสร้างภาพขนาดย่อให้โดยอัตโนมัติสำหรับไฟล์ 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 (RTF)
- รูปแบบข้อความ (TXT)
- ภาษามาร์กอัปไฮเปอร์เท็กซ์ (HTML)
- Extensible Markup Language (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 - (ไม่บังคับ) หากมีหน้าจอลงชื่อเข้าใช้ปรากฏขึ้น ให้เลือกบัญชีที่จะใช้
- (ไม่บังคับ) หากมีหน้าจอการให้สิทธิ์ปรากฏขึ้น ให้คลิกยอมรับ
- คลิกรหัสการให้สิทธิ์ของ Exchange สำหรับโทเค็น ระบบจะแสดงผลโทเค็น
- ระบุแหล่งที่มาที่คุณต้องการเปิดใช้การควบคุมภาพขนาดย่อ
เรียกใช้
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 ดังนี้
- ในคอนโซลระบบคลาวด์ ให้คลิกรายการแบบเลื่อนลง "สร้างข้อมูลเข้าสู่ระบบ" แล้วเลือกคีย์ 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 - (ไม่บังคับ) หากมีหน้าจอลงชื่อเข้าใช้ปรากฏขึ้น ให้เลือกบัญชีที่จะใช้
- (ไม่บังคับ) หากมีหน้าจอการให้สิทธิ์ปรากฏขึ้น ให้คลิกยอมรับ
- คลิกรหัสการให้สิทธิ์ของ Exchange สำหรับโทเค็น ระบบจะแสดงผลโทเค็น
- ระบุแอปพลิเคชันการค้นหาที่คุณต้องการเปิดใช้การควบคุมภาพขนาดย่อ
เรียกใช้
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 ไดรฟ์