此页面由 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 密钥和 Web 应用凭据，并使用 Web 应用凭据获取访问令牌。最后，您可以使用这些凭据获取和更新数据源。

如果您尚未创建或选择项目，请为您的应用创建或选择项目，然后启用该 API。如需了解这两步，请参阅配置对 Google Cloud Search API 的访问权限的第 1 步和第 2 步。
创建 API 密钥：
1. 在 Google Cloud 控制台中，点击“创建凭据”下拉列表，然后选择“API 密钥”。系统随即会显示“已创建 API 密钥”页面。
2. 记下 API 密钥。
3. 点击“关闭”。新创建的凭据会显示在“API 密钥”下。
创建 Web 应用凭据。使用 https://developers.google.com/oauthplayground 作为重定向 URI。。如需了解创建这些凭据的步骤，请参阅创建 Web 应用凭据（客户端 JavaScript）。
在 OAuth 2.0 Playground 中，点击 OAuth 2.0 配置 。
选中使用您自己的凭据。
输入第 3 步生成的客户端 ID 和客户端密钥。
在“scopes”字段中，输入 https://www.googleapis.com/auth/cloud_search.settings，然后点击 Authorize APIs。
（可选）如果系统显示登录界面，请选择要使用的账号。
（可选）如果系统显示授权界面，请点击接受。
点击 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 是上一个 c网址命令返回的显示名称。
"returnThumbnailsUrls":true 启用缩略图。

此命令的成功结果类似如下所示：

{
  "source": {
    "name": "datasources/datasource_id",
    "displayName": "DataSource_Display_Name",
    "itemsVisibility": [
      {
        "gsuiteDomain": true
      }
    ],
    "returnThumbnailUrls": true
  }
}

为搜索应用启用缩略图网址

您的 Cloud Search 平台项目包含服务账号凭据。不过，如需启用缩略图网址，您必须创建 API 密钥和 Web 应用凭据，并使用 Web 应用凭据获取访问令牌。最后，您可以使用这些凭据获取和更新搜索应用。

如果您尚未创建或选择项目，请为您的应用创建或选择项目，然后启用该 API。如需了解这两步，请参阅配置对 Google Cloud Search API 的访问权限的第 1 步和第 2 步。
创建 API 密钥：
1. 在 Cloud 控制台中，点击“创建凭据”下拉列表，然后选择“API 密钥”。系统随即会显示“已创建 API 密钥”页面。
2. 记下 API 密钥。
3. 点击“关闭”。新创建的凭据会显示在“API 密钥”下。
创建 Web 应用凭据。使用 https://developers.google.com/oauthplayground 作为重定向 URI。。如需了解创建这些凭据的步骤，请参阅创建 Web 应用凭据（客户端 JavaScript）。
在 OAuth 2.0 Playground 中，点击 OAuth 2.0 配置 。
选中使用您自己的凭据。
输入第 3 步生成的客户端 ID 和客户端密钥。
在“scopes”字段中，输入 https://www.googleapis.com/auth/cloud_search.settings，然后点击 Authorize APIs。
（可选）如果系统显示登录界面，请选择要使用的账号。
（可选）如果系统显示授权界面，请点击接受。
点击 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 是上一个 c网址命令返回的显示名称。
"returnResultThumbnailUrls":true 启用缩略图。

此命令的成功结果类似如下所示：

{
  "name": "searchapplications/search_application_id",
  "displayName": "SearchApp_Display_Name",
  "dataSourceRestrictions": [
    {
      "source": {
        "name": "datasources/datasource_id"
      }
    }
  ],
  "returnResultThumbnailUrls": true
}

访问缩略图

如需在云端硬盘中访问 Google Workspace 文件的缩略图，用户或应用必须传递与他们访问 Google 云端硬盘中相应内容时所用账号凭据相同的凭据。