此页面由 Cloud Translation API 翻译。

启用缩略图

搜索结果返回的文档会显示缩略图。缩略图可帮助用户更好地确定返回的文档的相关性。缩略图具有以下特征：

宽度为 1024 像素。
Google Workspace 文件缩略图的网址受 ACL 保护。其他文件类型的网址不受 ACL 保护
网址会在 5 分钟后失效。
对于大于 50 MB 的文件，系统不会生成缩略图。
如果无法生成缩略图，系统会使用占位图标。如果无法为 Google Workspace 项目生成缩略图，缩略图网址会返回“404 Not Found”。您的应用必须处理此行为。

系统会自动为自然支持缩略图的 Google 云端硬盘文件（例如 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 密钥和 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 配置图标。
选中 Use your own credentials（使用您自己的凭据）。
输入第 3 步中生成的客户端 ID 和客户端密钥。
在作用域字段中，输入 https://www.googleapis.com/auth/cloud_search.settings，然后点击 Authorize APIs。
（可选）如果系统显示登录界面，请选择要使用的账号。
（可选）如果系统显示授权界面，请点击接受。
点击以授权代码交换令牌。系统会返回一个令牌。
确定要为其启用缩略图控件的数据源。

调用 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 是上一个 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. 在云控制台中，点击“创建凭据”下拉列表，然后选择“API 密钥”。系统随即会显示“API 密钥已创建”页面。
2. 记下 API 密钥。
3. 点击“关闭”。新创建的凭据会显示在“API 密钥”下方。
创建 Web 应用凭据。使用 https://developers.google.com/oauthplayground 作为重定向 URI。。如需了解创建这些凭据的步骤，请参阅创建 Web 应用凭据（客户端 JavaScript）。
在 OAuth 2.0 Playground 中，点击 OAuth 2.0 配置图标。
选中 Use your own credentials（使用您自己的凭据）。
输入第 3 步中生成的客户端 ID 和客户端密钥。
在作用域字段中，输入 https://www.googleapis.com/auth/cloud_search.settings，然后点击 Authorize APIs。
（可选）如果系统显示登录界面，请选择要使用的账号。
（可选）如果系统显示授权界面，请点击接受。
点击以授权代码交换令牌。系统会返回一个令牌。
确定要为其启用缩略图控件的搜索应用。

调用 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 是上一个 c网址命令返回的显示名称。
"returnResultThumbnailUrls":true 启用缩略图。

此命令的成功结果类似于：

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

访问缩略图

如需访问云端硬盘中 Google Workspace 文件的缩略图，用户或应用必须传递用于访问 Google 云端硬盘中相应项目的相同账号凭据。

启用缩略图 使用集合让一切井井有条 根据您的偏好保存内容并对其进行分类。

为数据源启用缩略图网址

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

访问缩略图

启用缩略图