启用缩略图

缩略图有助于用户识别相关搜索结果。它们具有以下特征：

• 宽度为 1024 像素。
• Google Workspace 文件缩略图的网址受 ACL 保护。其他文件类型则不受保护。
• 网址会在 5 分钟后过期。
• 生成文件的最大大小为 50 MB。
• 如果生成失败，Cloud Search 会返回占位符图标。 对于 Google Workspace 项，网址会返回“404 Not Found”。您的应用必须处理此问题。

Google 云端硬盘会自动为受支持的类型（例如文档、表格和幻灯片）创建缩略图。 Cloud Search 还会为以下类型生成缩略图：

• Microsoft Word (DOC, DOCX)
• Microsoft Excel (XLS, XLSX)
• Microsoft PowerPoint (PPT, PPTX)
• Adobe PDF
• RTF、TXT、HTML 和 XML

只有在为数据源和搜索应用启用缩略图后，Cloud Search 才会返回项的缩略图。

为数据源启用缩略图网址

如需启用缩略图网址，请创建 API 密钥和 Web 应用凭据。使用这些凭据获取访问令牌，以更新您的数据源。

1. 创建或选择一个项目，然后启用 API。请参阅 配置对 Cloud Search API 的访问权限。
2. 在 Google Cloud 控制台中创建 API 密钥，并记下该值。
3. 创建 Web 应用凭据。使用 https://developers.google.com/oauthplayground 作为重定向 URI。请参阅 创建凭据。
4. 在 OAuth 2.0 Playground 中， 打开 OAuth 2.0 配置 。
5. 选择使用您自己的凭据 ，然后输入您的客户端 ID 和密钥。
6. 在“范围”字段中输入 https://www.googleapis.com/auth/cloud_search.settings，然后点击授权 API 。
7. 将授权代码转换为令牌。

8. 调用 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
   

9. 调用 settings.datasources.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":"DISPLAY_NAME","itemsVisibility":[{"gsuiteDomain":true}],"returnThumbnailUrls":true}}' \
   --compressed
   

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

您还必须在搜索应用中启用缩略图。

1. 使用 上一部分中介绍的相同方法获取 API 密钥和访问令牌。

2. 调用 settings.searchapplications.get 以获取您的应用 ID：

   curl 'https://cloudsearch.googleapis.com/v1/settings/searchapplications/APP_ID?key=YOUR_API_KEY' \
   --header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
   --header 'Accept: application/json' \
   --compressed
   

3. 调用 settings.searchapplications.update，并将 returnResultThumbnailUrls 设置为 true：

   curl --request PUT \
   'https://cloudsearch.googleapis.com/v1/settings/searchapplications/APP_ID?key=YOUR_API_KEY' \
   --header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
   --header 'Accept: application/json' \
   --header 'Content-Type: application/json' \
   --data '{"name":"searchapplications/APP_ID","displayName":"DISPLAY_NAME","dataSourceRestrictions":[{"source":{"name":"datasources/DATASOURCE_ID"}}],"returnResultThumbnailUrls":true}' \
   --compressed
   

访问缩略图

如需访问云端硬盘文件的缩略图，用户或应用必须使用与访问原始项时所用的账号凭据相同的凭据。