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

Bật hình thu nhỏ

Hình thu nhỏ được hiển thị cho các tài liệu mà kết quả tìm kiếm trả về. Cho phép hình thu nhỏ người dùng để xác định tốt hơn mức độ liên quan của 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 cho hình thu nhỏ của tệp 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.
Không tạo hình thu nhỏ cho tệp lớn hơn 50 MB.
Nếu không tạo được hình thu nhỏ, hệ thống sẽ sử dụng biểu tượng phần giữ chỗ. Nếu hình thu nhỏ đối với một mục trên Google Workspace không tạo được, hệ thống sẽ trả về URL hình thu nhỏ "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 trên Google Drive có tự nhiên hỗ trợ hình thu nhỏ, chẳng hạn như các loại tài liệu trên Google Workspace (Tài liệu, Trang tính, Trang trình bày, v.v.). Ngoài ra, Cloud Search cũng 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 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 chúng.

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

Dự án nền tảng Cloud Search của bạn có chứa thông tin đăng nhập vào tài khoản dịch vụ. Tuy nhiên, để kích hoạt URL hình thu nhỏ, bạn phải tạo Khoá API và thông tin đăng nhập ứ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 đăng nhập này để tải và cập nhật một nguồn dữ liệu.

Tạo hoặc chọn một dự án cho ứng dụng của bạn rồi bật tính năng này nếu bạn chưa làm việc này API. Để biết thông tin về hai bước này, vui lòng tham khảo bước 1 và 2 của Định cấu hình quyền truy cập vào Google Cloud Search API.
Tạo khoá API:
1. Trong bảng điều khiển Google Cloud, 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. "Khoá API đã được tạo" trang xuất hiện.
2. Ghi lại khoá API.
3. Nhấp vào Đóng. Thông tin đăng nhập mới tạo sẽ xuất hiện trong phần "Khoá API".
Tạo thông tin xác thực ứ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 đăng nhập này, hãy tham khảo Tạo thông tin đăng nhập ứng dụng web (JavaScript phía máy khách).
Trong Sân chơi OAuth 2.0, nhấp vào Cấu hình OAuth 2.0 .
Chọn 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 được 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 màn hình Đăng nhập hiển thị, hãy chọn tài khoản cần sử dụng.
(không bắt buộc) Nếu màn hình hiển thị cho phép, hãy nhấp vào Chấp nhận.
Nhấp vào Mã uỷ quyền Exchange cho mã thông báo. Một mã thông báo sẽ được trả về.
Xác định nguồn dữ liệu mà bạn muốn bật 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 (lấy ở bước 2).
- YOUR_ACCESS_TOKEN là mã truy cập OAuth 2.0 cho dự án của bạn (đã nhận được từ bước 10).
Kết quả thành công từ 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 withh returnThumbnailUrls được đặt thành true để bật URL hình thu nhỏ cho dữ liệu nguồn:

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 (lấy ở bước 2).
YOUR_ACCESS_TOKEN là mã truy cập OAuth 2.0 cho dự án của bạn (đã nhận được từ bước 10).
DataSource_DisplayName là tên hiển thị được trả về từ giá trị trước cURL.
"returnThumbnailsUrls":true bật hình thu nhỏ.

Kết quả thành công từ 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

Tạo hoặc chọn một dự án cho ứng dụng của bạn rồi bật tính năng này nếu bạn chưa làm việc này API. Để biết thông tin về hai bước này, vui lòng tham khảo bước 1 và 2 của Định cấu hình quyền truy cập vào Google Cloud Search API.
Tạo khoá API:
1. Trong bảng điều khiển Cloud, 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. "Khoá API đã được tạo" trang xuất hiện.
2. Ghi lại khoá API.
3. Nhấp vào Đóng. Thông tin đăng nhập mới tạo sẽ xuất hiện trong phần "Khoá API".
Tạo thông tin xác thực ứ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 đăng nhập này, hãy tham khảo Tạo thông tin đăng nhập ứng dụng web (JavaScript phía máy khách).
Trong Sân chơi OAuth 2.0, nhấp vào Cấu hình OAuth 2.0 .
Chọn 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 được 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 màn hình Đăng nhập hiển thị, hãy chọn tài khoản cần sử dụng.
(không bắt buộc) Nếu màn hình hiển thị cho phép, hãy nhấp vào Chấp nhận.
Nhấp vào Mã uỷ quyền Exchange cho mã thông báo. Một mã thông báo sẽ được trả về.
Xác định ứng dụng tìm kiếm mà bạn muốn bật các điều khiển 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ã nhận dạng 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 (lấy ở bước 2).
YOUR_ACCESS_TOKEN là mã truy cập OAuth 2.0 cho dự án của bạn (đã nhận được từ bước 10).

Kết quả thành công từ 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 trong đó 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ã nhận dạng 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 (lấy ở bước 2).
YOUR_ACCESS_TOKEN là mã truy cập OAuth 2.0 cho dự án của bạn (đã nhận được từ bước 10).
SearchApp_DisplayName là tên hiển thị được trả về từ giá trị trước cURL.
"returnResultThumbnailUrls":true bật hình thu nhỏ.

Kết quả thành công từ 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 một tệp Google Workspace trong Drive, người dùng hoặc phải chuyển cùng thông tin đăng nhập tài khoản mà ứng dụng sử dụng để truy cập trong Google Drive.