Bật hình thu nhỏ

Hình thu nhỏ giúp người dùng xác định kết quả tìm kiếm có liên quan. Chúng có những đặc điểm sau:

• Chiều rộng 1024 px.
• URL cho hình thu nhỏ của tệp trên Google Workspace được bảo vệ bằng danh sách kiểm soát truy cập (ACL). Các loại tệp khác thì không.
• URL sẽ hết hạn sau 5 phút.
• Kích thước tệp tối đa để tạo là 50 MB.
• Nếu không tạo được, Cloud Search sẽ trả về một biểu tượng phần giữ chỗ. Đối với các mục trong Google Workspace, URL trả về thông báo "404 Không tìm thấy". Ứng dụng của bạn phải xử lý việc này.

Google Drive tự động tạo hình thu nhỏ cho các loại tệp được hỗ trợ, chẳng hạn như Tài liệu, Trang tính và Trang trình bày. Cloud Search cũng tạo hình thu nhỏ cho:

• Microsoft Word (DOC, DOCX)
• Microsoft Excel (XLS, XLSX)
• Microsoft PowerPoint (PPT, PPTX)
• Tệp PDF của Adobe
• RTF, TXT, HTML và XML

Cloud Search chỉ trả về hình thu nhỏ cho các mục khi bạn bật hình thu nhỏ cho nguồn dữ liệu và ứng dụng tìm kiếm.

Bật URL hình thu nhỏ cho một nguồn dữ liệu

Để bật URL của hình thu nhỏ, hãy tạo khoá API và thông tin đăng nhập của ứng dụng web. Sử dụng các thông tin này để lấy mã truy cập nhằm cập nhật nguồn dữ liệu.

1. Tạo hoặc chọn một dự án rồi bật API. Xem phần Định cấu hình quyền truy cập vào Cloud Search API.
2. Tạo một khoá API trong Google Cloud Console và ghi lại giá trị.
3. Tạo thông tin đăng nhập của ứng dụng web. Sử dụng https://developers.google.com/oauthplayground làm URI chuyển hướng. Xem phần Tạo thông tin đăng nhập.
4. Trong OAuth 2.0 Playground, hãy mở Cấu hình OAuth 2.0 .
5. Chọn Sử dụng thông tin đăng nhập của riêng bạn rồi nhập mã ứng dụng khách và khoá bí mật của bạn.
6. Nhập https://www.googleapis.com/auth/cloud_search.settings vào trường phạm vi rồi nhấp vào Uỷ quyền cho API.
7. Đổi mã uỷ quyền lấy mã thông báo.

8. Gọi settings.datasources.get để lấy mã nhận dạng nguồn dữ liệu:

   curl 'https://cloudsearch.googleapis.com/v1/settings/DATASOURCE_ID?key=YOUR_API_KEY' \
   --header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
   --header 'Accept: application/json' \
   --compressed
   

9. Gọi settings.datasources.update với returnThumbnailUrls được đặt thành true:

   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":"DISPLAY_NAME","itemsVisibility":[{"gsuiteDomain":true}],"returnThumbnailUrls":true}}' \
   --compressed
   

Bật URL hình thu nhỏ cho một ứng dụng tìm kiếm

Bạn cũng phải bật hình thu nhỏ trong ứng dụng tìm kiếm.

1. Lấy khoá API và mã truy cập bằng phương thức tương tự như mô tả trong phần trước.

2. Gọi settings.searchapplications.get để lấy mã ứng dụng của bạn:

   curl 'https://cloudsearch.googleapis.com/v1/settings/searchapplications/APP_ID?key=YOUR_API_KEY' \
   --header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
   --header 'Accept: application/json' \
   --compressed
   

3. Gọi settings.searchapplications.update với returnResultThumbnailUrls được đặt thành true:

   curl --request PUT \
   'https://cloudsearch.googleapis.com/v1/settings/searchapplications/APP_ID?key=YOUR_API_KEY' \
   --header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
   --header 'Accept: application/json' \
   --header 'Content-Type: application/json' \
   --data '{"name":"searchapplications/APP_ID","displayName":"DISPLAY_NAME","dataSourceRestrictions":[{"source":{"name":"datasources/DATASOURCE_ID"}}],"returnResultThumbnailUrls":true}' \
   --compressed
   

Truy cập vào hình thu nhỏ

Để truy cập vào hình thu nhỏ của một tệp trên Drive, người dùng hoặc ứng dụng phải sử dụng cùng thông tin đăng nhập tài khoản đã dùng để truy cập vào mục ban đầu.