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

Bật hình thu nhỏ

Hình thu nhỏ hiển thị cho các tài liệu được kết quả tìm kiếm trả về. Hình thu nhỏ giú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 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 quyền truy cập (ACL). URL cho các loại tệp khác không được bảo vệ bằng Danh sách kiểm soát quyền truy cập (ACL)
URL sẽ hết hạn sau 5 phút.
Hình thu nhỏ sẽ 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, thì URL của hình thu nhỏ sẽ trả về thông báo lỗi "404 Not Found". Ứ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ó 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 trên Google Workspace (Tài liệu, Trang tính, Trang trình bày, v.v.). Ngoài ra, Cloud Search sẽ 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 đã bật 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

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

Tạo hoặc chọn một dự án cho ứng dụng của bạn và bật API nếu bạn chưa làm như vậy. Để biết thông tin về 2 bước này, hãy tham khảo bước 1 và 2 của bài viết Đị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. 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 đăng nhập mới tạo sẽ xuất hiện trong phần "Khoá API".
Tạo thông tin đăng nhập cho ứng dụng web. 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 bài viết Tạo thông tin đăng nhập của ứng dụng web (JavaScript phía máy khách).
Trong Playground OAuth 2.0, hãy nhấp vào Cấu hình OAuth 2.0 .
Chọn Sử dụng thông tin xác thực 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 Authorize APIs (Cho phép 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 bạn muốn sử dụng.
(không bắt buộc) Nếu màn hình uỷ quyền xuất hiện, 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ã thông báo được trả về.
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 (lấy từ bước 2).
- YOUR_ACCESS_TOKEN là mã truy cập OAuth 2.0 cho dự án của bạn (lấy từ bước 10).
Kết quả thành công của lệnh này sẽ tương tự như:
```
{
 "source": {
   "name": "datasources/datasource_id",
   "displayName": "DataSource_Display_Name",
   "itemsVisibility": [
     {
       "gsuiteDomain": true
     }
   ]
 }
}
```

Gọi setting.datasource.update, trong khi returnThumbnailUrls đặ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 (lấy từ bước 2).
YOUR_ACCESS_TOKEN là mã truy cập OAuth 2.0 cho dự án của bạn (lấy 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 sẽ 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

Dự án trên nền tảng Cloud Search của bạn có chứa thông tin đăng nhập tài khoản dịch vụ. Tuy nhiên, để bật URL của hình thu nhỏ, bạn phải tạo khoá API và thông tin xác thực của ứng dụng web, đồng thời dùng thông tin đăng nhập của ứ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 ứ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 và bật API nếu bạn chưa làm như vậy. Để biết thông tin về 2 bước này, hãy tham khảo bước 1 và 2 của bài viết Đị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. 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 đăng nhập mới tạo sẽ xuất hiện trong phần "Khoá API".
Tạo thông tin đăng nhập cho ứng dụng web. 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 bài viết Tạo thông tin đăng nhập của ứng dụng web (JavaScript phía máy khách).
Trong Playground OAuth 2.0, hãy nhấp vào Cấu hình OAuth 2.0 .
Chọn Sử dụng thông tin xác thực 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 Authorize APIs (Cho phép 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 bạn muốn sử dụng.
(không bắt buộc) Nếu màn hình uỷ quyền xuất hiện, 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ã thông báo được trả về.
Xác định ứng dụng tìm kiếm mà bạn muốn bật các nút đ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ã 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 từ bước 2).
YOUR_ACCESS_TOKEN là mã truy cập OAuth 2.0 cho dự án của bạn (lấy từ bước 10).

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

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

Gọi setting.searchapplications.update cùng 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 (lấy từ bước 2).
YOUR_ACCESS_TOKEN là mã truy cập OAuth 2.0 cho dự án của bạn (lấy 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 sẽ tương tự như:

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

Truy cập 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 ứng dụng phải chuyển cùng một thông tin đăng nhập tài khoản mà họ sử dụng để truy cập vào mục đó trong Google Drive.