サムネイルを有効にする

サムネイルは、ユーザーが関連性の高い検索結果を特定するのに役立ちます。これらの特徴は次のとおりです。

• 幅は 1,024 ピクセルです。
• Google Workspace ファイルのサムネイルの URL は ACL で保護されています。他のファイル形式はサポートされていません。
• URL は 5 分後に期限切れになります。
• 生成の最大ファイルサイズは 50 MB です。
• 生成に失敗した場合、Cloud Search はプレースホルダ アイコンを返します。Google Workspace アイテムの場合、URL は「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 でアイテムのサムネイルが返されるのは、データソースと検索アプリケーションでサムネイルを有効にした場合のみです。

データソースのサムネイル URL を有効にする

サムネイル URL を有効にするには、API キーとウェブ アプリケーションの認証情報を作成します。これらを使用して、データソースを更新するためのアクセス トークンを取得します。

1. プロジェクトを作成または選択して、API を有効にします。Cloud Search API へのアクセスを構成するをご覧ください。
2. Google Cloud コンソールで API キーを作成し、値をメモします。
3. ウェブ アプリケーションの認証情報を作成します。リダイレクト URI として https://developers.google.com/oauthplayground を使用します。認証情報を作成するをご覧ください。
4. OAuth 2.0 Playground で、OAuth 2.0 構成 を開きます。
5. [Use your own credentials] を選択し、クライアント 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. returnThumbnailUrls を true に設定して settings.datasources.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":"DISPLAY_NAME","itemsVisibility":[{"gsuiteDomain":true}],"returnThumbnailUrls":true}}' \
   --compressed
   

検索アプリケーションのサムネイル URL を有効にする

検索アプリケーションでサムネイルを有効にする必要もあります。

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. returnResultThumbnailUrls を true に設定して settings.searchapplications.update を呼び出します。

   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
   

サムネイルにアクセスする

ドライブ ファイルのサムネイルにアクセスするには、ユーザーまたはアプリケーションは元のアイテムへのアクセスに使用したのと同じアカウント認証情報を使用する必要があります。