本頁面由 Cloud Translation API 翻譯而成。

啟用縮圖

搜尋結果傳回的文件縮圖會顯示縮圖。縮圖可讓使用者更準確地識別傳回文件的關聯性。縮圖具有以下特點：

寬度為 1024 像素。
Google Workspace 檔案縮圖的網址受 ACL 保護。其他檔案類型的網址不受 ACL 保護
網址會在 5 分鐘後失效。
系統不會為超過 50 MB 的檔案產生縮圖。
如果無法產生縮圖，則會使用預留位置圖示。如果無法產生 Google Workspace 項目的縮圖，縮圖網址會回傳「404 Not Found」。應用程式必須處理這個行為。

針對自然支援縮圖 (例如 Google Workspace 文件、試算表、簡報等) 的 Google 雲端硬碟檔案，系統會自動建立縮圖。此外，Cloud Search 會自動建立下列檔案類型的縮圖：

Microsoft Word (DOC)
Microsoft Word (DOCX)
Microsoft Excel (XLS)
Microsoft Excel (XLSX)
Microsoft PowerPoint (PPT)
Microsoft PowerPoint (PPTX)
Adobe 可攜式文件格式 (PDF)
RTF 格式
文字格式 (TXT)
超文本標記語言 (HTML)
可延伸標記語言 (XML)

系統只會針對資料來源和搜尋應用程式啟用縮圖的項目傳回縮圖。

為資料來源啟用縮圖網址

您的 Cloud Search 平台專案含有服務帳戶憑證。但是，如要啟用縮圖網址，您必須建立 API 金鑰和網頁應用程式憑證，並使用網頁應用程式憑證取得存取權杖。最後，您會使用這些憑證取得及更新資料來源。

如果您尚未為應用程式建立或選取專案，並啟用 API，請先完成這項操作。如要瞭解這兩個步驟，請參閱「設定 Google Cloud Search API 的存取權」一文的步驟 1 和 2。
建立 API 金鑰：
1. 在 Google Cloud 控制台中，按一下「Create Credentials」(建立憑證) 下拉式清單，然後選取 API 金鑰。「已建立 API 金鑰」頁面隨即顯示。
2. 記下 API 金鑰。
3. 按一下「關閉」。新建立的憑證會顯示在「API 金鑰」下方。
建立網頁應用程式憑證。使用 https://developers.google.com/oauthplayground 做為重新導向 URI。。如需建立這些憑證的步驟，請參閱「建立網頁應用程式憑證 (用戶端 JavaScript)」。
在 OAuth 2.0 Playground 中，按一下「OAuth 2.0 Configuration」圖示。
勾選「Use your credentials」(使用自己的憑證)。
輸入在步驟 3 中產生的用戶端 ID 和用戶端密鑰。
在「Scope」(範圍) 欄位中輸入 https://www.googleapis.com/auth/cloud_search.settings，然後按一下「Authorize APIs」(授權 API)。
(選用) 如果出現「登入」畫面，請選取您要使用的帳戶。
(選用) 如果出現授權畫面，請按一下「接受」。
請按一下「ExchangeAuthorization code for token」。傳回權杖。
找出要啟用縮圖控制項的資料來源。

呼叫 settings.datasources.get 以取得資料來源的 ID：

curl
'https://cloudsearch.googleapis.com/v1/settings/datasource_id?key=[YOUR_API_KEY]' \
--header 'Authorization: Bearer [YOUR_ACCESS_TOKEN]'\
--header 'Accept: application/json'  \
--compressed

在此情況下：

datasource_id 是要擷取的資料來源名稱。
YOUR_API_KEY 是專案的 API 金鑰 (從步驟 2 取得)。
YOUR_ACCESS_TOKEN 是專案的 OAuth 2.0 存取權杖 (可從步驟 10 取得)。

這個指令的成功結果類似：

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

呼叫 setting.datasource.update，並將 returnThumbnailUrls 設為 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":"DataSource_Display_Name","itemsVisibility":
    [{"gsuiteDomain":true}],"returnThumbnailUrls":true}}' \
  --compressed

在此情況下：

datasource_id 是要擷取的資料來源 ID。
YOUR_API_KEY 是專案的 API 金鑰 (從步驟 2 取得)。
YOUR_ACCESS_TOKEN 是專案的 OAuth 2.0 存取權杖 (可從步驟 10 取得)。
DataSource_DisplayName 是前一個 cURL 指令傳回的顯示名稱。
"returnThumbnailsUrls":true 可啟用縮圖。

這個指令的成功結果類似：

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

啟用搜尋應用程式的縮圖網址

您的 Cloud Search 平台專案含有服務帳戶憑證。但是，如要啟用縮圖網址，您必須建立 API 金鑰和網頁應用程式憑證，並使用網頁應用程式憑證取得存取權杖。最後，您可以使用這些憑證取得及更新搜尋應用程式。

如果您尚未為應用程式建立或選取專案，並啟用 API，請先完成這項操作。如要瞭解這兩個步驟，請參閱「設定 Google Cloud Search API 的存取權」一文的步驟 1 和 2。
建立 API 金鑰：
1. 在 Cloud 控制台中，按一下「Create Credentials」(建立憑證) 下拉式清單，然後選取 API 金鑰。「已建立 API 金鑰」頁面隨即顯示。
2. 記下 API 金鑰。
3. 按一下「關閉」。新建立的憑證會顯示在「API 金鑰」下方。
建立網頁應用程式憑證。使用 https://developers.google.com/oauthplayground 做為重新導向 URI。。如需建立這些憑證的步驟，請參閱「建立網頁應用程式憑證 (用戶端 JavaScript)」。
在 OAuth 2.0 Playground 中，按一下「OAuth 2.0 Configuration」圖示。
勾選「Use your credentials」(使用自己的憑證)。
輸入在步驟 3 中產生的用戶端 ID 和用戶端密鑰。
在「Scope」(範圍) 欄位中輸入 https://www.googleapis.com/auth/cloud_search.settings，然後按一下「Authorize APIs」(授權 API)。
(選用) 如果出現「登入」畫面，請選取您要使用的帳戶。
(選用) 如果出現授權畫面，請按一下「接受」。
請按一下「ExchangeAuthorization code for token」。傳回權杖。
找出要啟用縮圖控制項的搜尋應用程式。

呼叫 settings.searchapplications.get 以取得搜尋應用程式的 ID：

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

在此情況下：

是要擷取的搜尋應用程式 ID。
YOUR_API_KEY 是專案的 API 金鑰 (從步驟 2 取得)。
YOUR_ACCESS_TOKEN 是專案的 OAuth 2.0 存取權杖 (可從步驟 10 取得)。

這個指令的成功結果類似：

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

呼叫 setting.searchapplications.update 並將 returnResultThumbnailUrls 設為 true，以啟用搜尋應用程式的縮圖網址：

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

在此情況下：

是要擷取的搜尋應用程式 ID。
YOUR_API_KEY 是專案的 API 金鑰 (從步驟 2 取得)。
YOUR_ACCESS_TOKEN 是專案的 OAuth 2.0 存取權杖 (可從步驟 10 取得)。
SearchApp_DisplayName 是前一個 cURL 指令傳回的顯示名稱。
"returnResultThumbnailUrls":true 可啟用縮圖。

這個指令的成功結果類似：

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

存取縮圖

如要存取雲端硬碟中的 Google Workspace 檔案縮圖，使用者或應用程式必須傳遞用於存取 Google 雲端硬碟中項目的相同帳戶憑證。