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 những tài liệu được trả về trong kết quả tìm kiếm. Hình thu nhỏ giúp người dùng xác định mức độ liên quan của các tài liệu được trả về một cách hiệu quả hơn. 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.
Hình thu nhỏ không được tạo cho các tệp có kích thước lớn hơn 50 MB.
Nếu không tạo được hình thu nhỏ, hệ thống sẽ dùng một biểu tượng giữ chỗ. Nếu không tạo được hình thu nhỏ cho một mục trong Google Workspace, thì URL hình thu nhỏ sẽ trả về "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 những tệp trên Google Drive vốn hỗ trợ hình thu nhỏ, chẳng hạn như các loại tài liệu của 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 những mục có nguồn dữ liệu và ứng dụng tìm kiếm đã bật tính năng này.

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 chứa thông tin xác thực 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 đăng nhập ứng dụng web, đồng thời sử dụng thông tin đăng nhập ứng dụng web để lấy mã truy cập. Cuối cùng, bạn sử dụng thông tin đăng nhập này để nhận và cập nhật mộ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 rồi 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 Google Cloud Search API.
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 đă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 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 đăng nhập này, hãy tham khảo bài viết Tạo thông tin đăng nhập cho ứng dụng web (JavaScript phía máy khách).
Trong OAuth 2.0 Playground, hãy nhấp vào 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 đượ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 cho 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 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. 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 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 được ở 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 của lệnh này sẽ tương tự như sau:
```
{
 "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 (lấy được ở 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ừ lệnh cURL trước đó.
"returnThumbnailsUrls":true cho phép hiển thị hình thu nhỏ.

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

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

Bật URL hình thu nhỏ cho một ứ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 rồi 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 Google Cloud Search API.
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 đă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 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 đăng nhập này, hãy tham khảo bài viết Tạo thông tin đăng nhập cho ứng dụng web (JavaScript phía máy khách).
Trong OAuth 2.0 Playground, hãy nhấp vào 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 đượ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 cho 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 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. 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 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ã 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 được ở 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 của lệnh này sẽ tương tự như sau:

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

Gọi setting.searchapplications.update bằ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ã 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 được ở 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ừ lệnh cURL trước đó.
"returnResultThumbnailUrls":true cho phép hiển thị hình thu nhỏ.

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

{
  "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 ứng dụng phải truyền thông tin đăng nhập tài khoản giống như thông tin mà họ dùng để truy cập vào mục đó trong Google Drive.

Bật hình thu nhỏ Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.

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

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

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

Bật hình thu nhỏ