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

啟用縮圖

搜尋結果傳回的文件會顯示縮圖。縮圖允許次數使用者，以便更有效地識別傳回文件的相關性。縮圖有並符合下列條件：

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

系統會自動為 Google 雲端硬碟檔案產生縮圖，這類縮圖會自然產生支援縮圖，例如 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 的公平性後我們才能放心地推出 API如要進一步瞭解這兩個步驟，請參閱步驟 1 和 2 設定 Google Cloud Search API 的存取權。
建立 API 金鑰：
1. 在 Google Cloud 控制台中，點選「建立憑證」下拉式清單選取 API 金鑰「已建立 API 金鑰」出現。
2. 請記下 API 金鑰。
3. 按一下「關閉」。新建立的憑證會顯示在「API 金鑰」下方。
建立網頁應用程式憑證。使用「https://developers.google.com/oauthplayground」做為重新導向 URI。如需建立這些憑證的步驟，請參閱建立網頁應用程式憑證 (用戶端 JavaScript)。
在 OAuth 2.0 Playground 中按一下「OAuth 2.0 設定」圖示。
勾選「使用您自己的憑證」。
輸入您在步驟 3 中產生的用戶端 ID 和用戶端密鑰。
在範圍欄位中輸入 https://www.googleapis.com/auth/cloud_search.settings 然後點選「授權 API」。
(選用) 如果出現登入畫面，請選取你要使用的帳戶。
(選用) 如果出現授權畫面，請按一下「接受」。
按一下「Exchange License 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 的公平性後我們才能放心地推出 API如要進一步瞭解這兩個步驟，請參閱步驟 1 和 2 設定 Google Cloud Search API 的存取權。
建立 API 金鑰：
1. 在 Cloud 控制台中，按一下「建立憑證」下拉式清單選取 API 金鑰「已建立 API 金鑰」出現。
2. 請記下 API 金鑰。
3. 按一下「關閉」。新建立的憑證會顯示在「API 金鑰」下方。
建立網頁應用程式憑證。使用「https://developers.google.com/oauthplayground」做為重新導向 URI。如需建立這些憑證的步驟，請參閱建立網頁應用程式憑證 (用戶端 JavaScript)。
在 OAuth 2.0 Playground 中按一下「OAuth 2.0 設定」圖示。
勾選「使用您自己的憑證」。
輸入您在步驟 3 中產生的用戶端 ID 和用戶端密鑰。
在範圍欄位中輸入 https://www.googleapis.com/auth/cloud_search.settings 然後點選「授權 API」。
(選用) 如果出現登入畫面，請選取你要使用的帳戶。
(選用) 如果出現授權畫面，請按一下「接受」。
按一下「Exchange License 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 雲端硬碟中的項目。