搜尋結果傳回的文件縮圖會顯示縮圖。縮圖可讓使用者更準確地識別傳回文件的關聯性。縮圖具有以下特點:
- 寬度為 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 金鑰:
- 在 Google Cloud 控制台中,按一下「Create Credentials」(建立憑證) 下拉式清單,然後選取 API 金鑰。「已建立 API 金鑰」頁面隨即顯示。
- 記下 API 金鑰。
- 按一下「關閉」。新建立的憑證會顯示在「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 金鑰:
- 在 Cloud 控制台中,按一下「Create Credentials」(建立憑證) 下拉式清單,然後選取 API 金鑰。「已建立 API 金鑰」頁面隨即顯示。
- 記下 API 金鑰。
- 按一下「關閉」。新建立的憑證會顯示在「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 雲端硬碟中項目的相同帳戶憑證。