サムネイルを有効にする

検索結果で返されるドキュメントのサムネイルが表示されます。サムネイルで 返されたドキュメントの関連性をより正確に特定できます。サムネイルの役割 次の特性があります。

  • 幅 1,024 ピクセル。
  • Google Workspace ファイルのサムネイルの URL は ACL で保護されています。URL: ACL で保護されていないファイル形式が
  • URL の有効期限は 5 分です。
  • 50 MB を超えるファイルではサムネイルは生成されません。
  • サムネイルを生成できない場合は、プレースホルダ アイコンが使用されます。サムネイルが 生成できない場合、サムネイル URL は 「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 Portable Document Format（PDF）
  • リッチテキスト形式（RTF）
  • テキスト形式（TXT）
  • HTML（Hypertext Markup Language）
  • XML（拡張マークアップ言語）

サムネイルは、データソースと検索アプリケーションを持つアイテムに対してのみ返されます 有効にします。

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

Cloud Search Platform プロジェクトには、サービス アカウントの認証情報が含まれています。 ただし、サムネイルの URL を有効にするには、 API キーとウェブ アプリケーションの認証情報を使用し、ウェブ アプリケーションの認証情報を使用する アクセス トークンを取得します。最後に、これらの認証情報を使用して、Google Cloud データソースです

  1. まだ行っていない場合は、アプリのプロジェクトを作成または選択して有効にします できます。この 2 つの手順について詳しくは、 Google Cloud Search API へのアクセスを構成します。
  2. API キーを作成します。 <ph type="x-smartling-placeholder">
      </ph>
    1. Google Cloud コンソールで、[認証情報を作成] プルダウン リストをクリックし、 [API キー] を選択します。[作成された API キー]ページが表示されます。
    2. API キーをメモします。
    3. [閉じる] をクリックします。新しく作成した認証情報が [API キー] に表示されます。
  3. ウェブ アプリケーションの認証情報を作成する。https://developers.google.com/oauthplayground を使用する を指定します。。これらの認証情報を作成する手順については、 ウェブ アプリケーションの認証情報（クライアントサイド JavaScript）を作成する。
  4. OAuth 2.0 Playground で次の操作を行います。 [OAuth 2.0 Configuration] をクリックします。
  5. [Use your own credentials] をオンにします。
  6. 手順 3 で生成したクライアント ID とクライアント シークレットを入力します。
  7. [Scopes] フィールドに「https://www.googleapis.com/auth/cloud_search.settings」と入力します。 [Authorize APIs] をクリックします。
  8. （省略可）ログイン画面が表示された場合は、使用するアカウントを選択します。
  9. （省略可）承認画面が表示されたら、[同意する] をクリックします。
  10. [Exchange authorization code for token] をクリックします。トークンが返されます。
  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 に設定して、データのサムネイル URL を有効にします。 source:

    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
  }
}

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

Cloud Search Platform プロジェクトには、サービス アカウントの認証情報が含まれています。 ただし、サムネイルの URL を有効にするには、 API キーとウェブ アプリケーションの認証情報を使用し、ウェブ アプリケーションの認証情報を使用する アクセス トークンを取得します。最後に、これらの認証情報を使用して、Google Cloud 作成します。

  1. まだ行っていない場合は、アプリのプロジェクトを作成または選択して有効にします できます。この 2 つの手順について詳しくは、 Google Cloud Search API へのアクセスを構成します。
  2. API キーを作成します。 <ph type="x-smartling-placeholder">
      </ph>
    1. Cloud コンソールで、[認証情報を作成] プルダウン リストをクリックし、 [API キー] を選択します。[作成された API キー]ページが表示されます。
    2. API キーをメモします。
    3. [閉じる] をクリックします。新しく作成した認証情報が [API キー] に表示されます。
  3. ウェブ アプリケーションの認証情報を作成する。https://developers.google.com/oauthplayground を使用する を指定します。。これらの認証情報を作成する手順については、 ウェブ アプリケーションの認証情報（クライアントサイド JavaScript）を作成する。
  4. OAuth 2.0 Playground で次の操作を行います。 [OAuth 2.0 Configuration] をクリックします。
  5. [Use your own credentials] をオンにします。
  6. 手順 3 で生成したクライアント ID とクライアント シークレットを入力します。
  7. [Scopes] フィールドに「https://www.googleapis.com/auth/cloud_search.settings」と入力します。 [Authorize APIs] をクリックします。
  8. （省略可）ログイン画面が表示された場合は、使用するアカウントを選択します。
  9. （省略可）承認画面が表示されたら、[同意する] をクリックします。
  10. [Exchange authorization code for token] をクリックします。トークンが返されます。
  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 に設定して、動画のサムネイル URL を有効にします。 検索アプリケーション:

    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 ドライブ内のアイテムです。