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

啟用縮圖

系統會顯示搜尋結果傳回的文件縮圖。縮圖可讓使用者更容易判斷傳回文件的關聯性。縮圖具有下列特性：

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

系統會自動為支援縮圖的 Google 雲端硬碟檔案建立縮圖，例如 Google Workspace 文件類型 (文件、試算表、簡報等)。此外，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 Key」(API 金鑰)。畫面隨即顯示「API Key created」(已建立 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 authorization code for tokens」。系統會傳回權杖。
找出要啟用縮圖控制項的資料來源。

呼叫 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
     }
   ]
 }
}

將 returnThumbnailUrls 設為 true，然後呼叫 setting.datasource.update，即可為資料來源啟用縮圖網址：

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 Platform 專案包含服務帳戶憑證。不過，如要啟用縮圖網址，您必須建立 API 金鑰和網頁應用程式憑證，並使用網頁應用程式憑證取得存取權權杖。最後，您會使用這些憑證取得及更新搜尋應用程式。

如果您尚未為應用程式建立或選取專案，請先啟用 API。如需這兩個步驟的相關資訊，請參閱「設定 Google Cloud Search API 存取權」中的步驟 1 和 2。
建立 API 金鑰：
1. 在雲端控制台中，按一下「建立憑證」下拉式清單，然後選取「API 金鑰」。畫面隨即顯示「API Key created」(已建立 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 authorization code for tokens」。系統會傳回權杖。
找出要啟用縮圖控制項的搜尋應用程式。

呼叫 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"
     }
   }
 ]
}

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

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 雲端硬碟中存取 Google Workspace 檔案的縮圖，使用者或應用程式必須傳送與存取 Google 雲端硬碟中項目時所用的帳戶憑證相同的憑證。