啟用縮圖

縮圖可協助使用者找出相關搜尋結果。這些特徵包括：

• 寬度為 1024 像素。
• Google Workspace 檔案縮圖的網址受到存取控制清單 (ACL) 保護。其他檔案類型則不支援。
• 網址會在 5 分鐘後失效。
• 生成檔案的大小上限為 50 MB。
• 如果生成失敗，Cloud Search 會傳回預留位置圖示。如果是 Google Workspace 項目，網址會傳回「404 Not Found」。您的應用程式必須處理這項問題。

Google 雲端硬碟會自動為支援的類型 (例如文件、試算表和簡報) 建立縮圖。Cloud Search 也會為下列項目產生縮圖：

• Microsoft Word (DOC、DOCX)
• Microsoft Excel (XLS、XLSX)
• Microsoft PowerPoint (PPT、PPTX)
• Adobe PDF
• RTF、TXT、HTML 和 XML

如要讓 Cloud Search 傳回項目的縮圖，必須為資料來源和搜尋應用程式啟用縮圖。

為資料來源啟用縮圖網址

如要啟用縮圖網址，請建立 API 金鑰和網頁應用程式憑證。使用這些權杖取得存取權杖，以便更新資料來源。

1. 建立或選取專案，然後啟用 API。請參閱「設定 Cloud Search API 的存取權」。
2. 在 Google Cloud 控制台中建立 API 金鑰，並記下該值。
3. 建立網頁應用程式憑證。請使用 https://developers.google.com/oauthplayground 做為重新導向 URI。請參閱「建立憑證」。
4. 在 OAuth 2.0 Playground 中，開啟「OAuth 2.0 Configuration」。
5. 選取「使用自己的憑證」，然後輸入用戶端 ID 和密鑰。
6. 在範圍欄位中輸入 https://www.googleapis.com/auth/cloud_search.settings，然後按一下「Authorize APIs」。
7. 以授權碼換取權杖。

8. 呼叫 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
   

9. 呼叫 settings.datasources.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":"DISPLAY_NAME","itemsVisibility":[{"gsuiteDomain":true}],"returnThumbnailUrls":true}}' \
   --compressed
   

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

此外，您也必須在搜尋應用程式中啟用縮圖。

1. 使用上一節所述的相同方法，取得 API 金鑰和存取權杖。

2. 呼叫 settings.searchapplications.get 取得應用程式 ID：

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

3. 呼叫 settings.searchapplications.update，並將 returnResultThumbnailUrls 設為 true：

   curl --request PUT \
   'https://cloudsearch.googleapis.com/v1/settings/searchapplications/APP_ID?key=YOUR_API_KEY' \
   --header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
   --header 'Accept: application/json' \
   --header 'Content-Type: application/json' \
   --data '{"name":"searchapplications/APP_ID","displayName":"DISPLAY_NAME","dataSourceRestrictions":[{"source":{"name":"datasources/DATASOURCE_ID"}}],"returnResultThumbnailUrls":true}' \
   --compressed
   

存取縮圖

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