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 phù hợp. Hình thu nhỏ có những đặc điểm sau:

• Chiều rộng 1024 px.
• URL của hình thu nhỏ tệp 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 hết hạn sau 5 phút.
• Kích thước tệp tối đa để tạo là 50 MB.
• Nếu quá trình tạo không thành công, Cloud Search sẽ trả về một biểu tượng giữ chỗ. Đối với các mục Google Workspace, URL sẽ trả về thông báo "404 Không tìm thấy". Ứng dụng của bạn phải xử lý thông báo này.

Google Drive tự động tạo hình thu nhỏ cho các loại tệp được hỗ trợ 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)
• Adobe PDF
• 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 nguồn dữ liệu

Để bật URL 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 bài viết Định cấu hình quyền truy cập vào API Cloud Search.
2. Tạo khoá API trong bảng điều khiển Cloud của Google rồi 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 bài viết 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 và khoá bí mật.
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 API.
7. Trao đổi mã uỷ quyền để lấy mã thông báo.

8. Gọi settings.datasources.get để lấy mã 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 ứ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 chính phương thức được mô tả trong phần trước.

2. Gọi settings.searchapplications.get để lấy mã ứng dụng:

   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 Drive, người dùng hoặc ứng dụng phải sử dụng cùng thông tin đăng nhập của tài khoản đã dùng để truy cập vào mục gốc.