啟用縮圖

搜尋結果傳回的文件會顯示縮圖。縮圖可讓使用者更清楚傳回文件的相關性。縮圖應具有以下特性：

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

系統會自動為自然支援縮圖的 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 金鑰和網頁應用程式憑證，並使用網頁應用程式憑證取得存取權杖。最後，您會使用這些憑證來取得及更新資料來源。

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

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

  13. 呼叫 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 金鑰和網頁應用程式憑證，並使用網頁應用程式憑證取得存取權杖。最後，您會使用這些憑證來取得及更新搜尋應用程式。

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

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

  13. 呼叫 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 雲端硬碟項目時相同的帳戶憑證。