Trang này được dịch bởi Cloud Translation API.

Bật hình thu nhỏ

Hình thu nhỏ sẽ xuất hiện cho các tài liệu được trả về trong kết quả tìm kiếm. Hình thu nhỏ cho phép người dùng xác định rõ hơn mức độ liên quan của các tài liệu được trả về. Hình thu nhỏ có các đặc điểm sau:

Chiều rộng 1024 px.
URL của hình thu nhỏ tệp trong Google Workspace được bảo vệ bằng ACL. URL cho các loại tệp khác không được bảo vệ bằng ACL
URL sẽ hết hạn sau 5 phút.
Hình thu nhỏ không được tạo cho các tệp lớn hơn 50 MB.
Nếu không thể tạo hình thu nhỏ, hệ thống sẽ sử dụng biểu tượng phần giữ chỗ. Nếu không thể tạo hình thu nhỏ cho một mục trên Google Workspace, URL hình thu nhỏ 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ý hành vi này.

Hình thu nhỏ được tạo tự động cho các tệp Google Drive hỗ trợ hình thu nhỏ một cách tự nhiên, chẳng hạn như các loại tài liệu Google Workspace (Tài liệu, Trang tính, Trang trình bày, v.v.). Ngoài ra, Cloud Search tự động tạo hình thu nhỏ cho các loại tệp sau:

Microsoft Word (DOC)
Microsoft Word (DOCX)
Microsoft Excel (XLS)
Microsoft Excel (XLSX)
Microsoft Powerpoint (PPT)
Microsoft Powerpoint (PPTX)
Định dạng tài liệu di động của Adobe (PDF)
Định dạng văn bản đa dạng thức (RTF)
Định dạng văn bản (TXT)
Ngôn ngữ đánh dấu siêu văn bản (HTML)
Ngôn ngữ đánh dấu mở rộng (XML)

Hình thu nhỏ chỉ được trả về cho các mục có nguồn dữ liệu và ứng dụng tìm kiếm đã bật hình thu nhỏ.

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

Dự án trên Cloud Search Platform chứa thông tin xác thực của tài khoản dịch vụ. Tuy nhiên, để bật URL hình thu nhỏ, bạn phải tạo khoá API và thông tin xác thực ứng dụng web, đồng thời sử dụng thông tin xác thực ứng dụng web để lấy mã truy cập. Cuối cùng, bạn sử dụng các thông tin xác thực này để lấy và cập nhật nguồn dữ liệu.

Nếu chưa, hãy tạo hoặc chọn một dự án cho ứng dụng của bạn và bật API. Để biết thông tin về hai bước này, hãy tham khảo bước 1 và 2 trong phần Định cấu hình quyền truy cập vào API Google Cloud Search.
Tạo khoá API:
1. Trong Google Cloud Console, hãy nhấp vào danh sách thả xuống Tạo thông tin xác thực rồi chọn Khoá API. Trang "Tạo khoá API" sẽ xuất hiện.
2. Ghi lại khoá API.
3. Nhấp vào Đóng. Thông tin xác thực mới tạo sẽ xuất hiện trong phần "Khoá API".
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. . Để biết các bước tạo thông tin xác thực này, hãy tham khảo bài viết Tạo thông tin xác thực ứng dụng web (JavaScript phía máy khách).
Trong OAuth 2.0 Playground, nhấp vào OAuth 2.0 Configuration (Cấu hình OAuth 2.0) .
Đánh dấu vào Sử dụng thông tin đăng nhập của riêng bạn.
Nhập mã ứng dụng khách và mật khẩu ứng dụng khách đã tạo ở bước 3.
Trong trường phạm vi, hãy nhập https://www.googleapis.com/auth/cloud_search.settings rồi nhấp vào Uỷ quyền API.
(không bắt buộc) Nếu bạn thấy màn hình Đăng nhập, hãy chọn tài khoản mà bạn muốn sử dụng.
(không bắt buộc) Nếu bạn thấy màn hình uỷ quyền, hãy nhấp vào Chấp nhận.
Nhấp vào Đổi mã uỷ quyền lấy mã thông báo. Hệ thống sẽ trả về một mã thông báo.
Xác định nguồn dữ liệu mà bạn muốn bật các chế độ điều khiển hình thu nhỏ.
Gọi settings.datasources.get để lấy mã nhận dạng của 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
```
Trong trường hợp:
- datasource_id là tên của nguồn dữ liệu cần truy xuất.
- YOUR_API_KEY là khoá API cho dự án của bạn (nhận được từ bước 2).
- YOUR_ACCESS_TOKEN là mã truy cập OAuth 2.0 cho dự án của bạn (thu được từ bước 10).
Kết quả thành công của lệnh này tương tự như:
```
{
 "source": {
   "name": "datasources/datasource_id",
   "displayName": "DataSource_Display_Name",
   "itemsVisibility": [
     {
       "gsuiteDomain": true
     }
   ]
 }
}
```

Gọi setting.datasource.update với returnThumbnailUrls được đặt thành true để bật URL hình thu nhỏ cho nguồn dữ liệu:

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

Trong trường hợp:

datasource_id là mã nhận dạng của nguồn dữ liệu cần truy xuất.
YOUR_API_KEY là khoá API cho dự án của bạn (nhận được từ bước 2).
YOUR_ACCESS_TOKEN là mã truy cập OAuth 2.0 cho dự án của bạn (thu được từ bước 10).
DataSource_DisplayName là tên hiển thị được trả về từ lệnh cURL trước đó.
"returnThumbnailsUrls":true bật hình thu nhỏ.

Kết quả thành công của lệnh này tương tự như:

{
  "source": {
    "name": "datasources/datasource_id",
    "displayName": "DataSource_Display_Name",
    "itemsVisibility": [
      {
        "gsuiteDomain": true
      }
    ],
    "returnThumbnailUrls": true
  }
}

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

Nếu chưa, hãy tạo hoặc chọn một dự án cho ứng dụng của bạn và bật API. Để biết thông tin về hai bước này, hãy tham khảo bước 1 và 2 trong phần Định cấu hình quyền truy cập vào API Google Cloud Search.
Tạo khoá API:
1. Trong bảng điều khiển đám mây, hãy nhấp vào danh sách thả xuống Tạo thông tin xác thực rồi chọn Khoá API. Trang "Tạo khoá API" sẽ xuất hiện.
2. Ghi lại khoá API.
3. Nhấp vào Đóng. Thông tin xác thực mới tạo sẽ xuất hiện trong phần "Khoá API".
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. . Để biết các bước tạo thông tin xác thực này, hãy tham khảo bài viết Tạo thông tin xác thực ứng dụng web (JavaScript phía máy khách).
Trong OAuth 2.0 Playground, nhấp vào OAuth 2.0 Configuration (Cấu hình OAuth 2.0) .
Đánh dấu vào Sử dụng thông tin đăng nhập của riêng bạn.
Nhập mã ứng dụng khách và mật khẩu ứng dụng khách đã tạo ở bước 3.
Trong trường phạm vi, hãy nhập https://www.googleapis.com/auth/cloud_search.settings rồi nhấp vào Uỷ quyền API.
(không bắt buộc) Nếu bạn thấy màn hình Đăng nhập, hãy chọn tài khoản mà bạn muốn sử dụng.
(không bắt buộc) Nếu bạn thấy màn hình uỷ quyền, hãy nhấp vào Chấp nhận.
Nhấp vào Đổi mã uỷ quyền lấy mã thông báo. Hệ thống sẽ trả về một mã thông báo.
Xác định ứng dụng tìm kiếm mà bạn muốn bật các chế độ kiểm soát hình thu nhỏ.

Gọi settings.searchapplications.get để lấy mã nhận dạng của ứng dụng tìm kiếm:

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

Trong trường hợp:

là mã của ứng dụng tìm kiếm cần truy xuất.
YOUR_API_KEY là khoá API cho dự án của bạn (nhận được từ bước 2).
YOUR_ACCESS_TOKEN là mã truy cập OAuth 2.0 cho dự án của bạn (thu được từ bước 10).

Kết quả thành công của lệnh này tương tự như:

{
 "name": "searchapplications/search_application_id",
 "displayName": "SearchApp_Display_Name",
 "dataSourceRestrictions": [
   {
     "source": {
       "name": "datasources/datasource_id"
     }
   }
 ]
}

Gọi setting.searchapplications.update với returnResultThumbnailUrls được đặt thành true để bật URL hình thu nhỏ cho ứng dụng tìm kiếm:

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

Trong trường hợp:

là mã của ứng dụng tìm kiếm cần truy xuất.
YOUR_API_KEY là khoá API cho dự án của bạn (nhận được từ bước 2).
YOUR_ACCESS_TOKEN là mã truy cập OAuth 2.0 cho dự án của bạn (thu được từ bước 10).
SearchApp_DisplayName là tên hiển thị được trả về từ lệnh cURL trước đó.
"returnResultThumbnailUrls":true bật hình thu nhỏ.

Kết quả thành công của lệnh này tương tự như:

{
  "name": "searchapplications/search_application_id",
  "displayName": "SearchApp_Display_Name",
  "dataSourceRestrictions": [
    {
      "source": {
        "name": "datasources/datasource_id"
      }
    }
  ],
  "returnResultThumbnailUrls": true
}

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

Để truy cập vào hình thu nhỏ của tệp Google Workspace trong Drive, người dùng hoặc ứng dụng phải chuyển chính thông tin xác thực tài khoản mà họ sử dụng để truy cập vào mục đó trong Google Drive.