ウェブサイトで画像を検索する

Agent Search を使用すると、ウェブサイト データを含む アプリを使用して画像を検索できます。テキスト文字列または画像の形式でクエリを指定し、default_config.search メソッドがそのクエリの画像を返します。

始める前に

次の前提条件を満たしていることを確認してください。要件は、テキスト クエリを使用して検索するか、画像クエリを使用して検索するかによって異なります。

コマンドラインを使用してウェブサイトの画像結果をプレビューするには、 engines.servingConfigs.search メソッドを使用します。

  1. アプリ ID を調べます。アプリ ID をすでに保有している場合は、次のステップに進みます。

    1. コンソールで、[AI アプリケーション] ページに移動します。 Google Cloud

      [アプリ] に移動

    2. [アプリ] ページで、アプリの名前を見つけ、[ID] 列からアプリの ID を取得します。

  2. engines.servingConfigs.search メソッドを呼び出し、1 に search_type を指定します。クエリがテキスト バイトか画像バイトかに応じて、メソッドの構文を選択します。

    クエリがテキスト文字列である

    curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
-H "X-Goog-User-Project: PROJECT_ID" \
"https://discoveryengine.googleapis.com/v1/projects/PROJECT_ID/locations/global/collections/default_collection/engines/APP_ID/servingConfigs/default_config:search" \
-d '{
"servingConfig": "projects/PROJECT_ID/locations/global/collections/default_collection/engines/APP_ID/servingConfigs/default_search",
"query": "QUERY",
"pageSize": "PAGE_SIZE",
"offset": "OFFSET",
"params": {"search_type": 1}
}'

    クエリが画像である

    curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
-H "X-Goog-User-Project: PROJECT_ID" \
"https://discoveryengine.googleapis.com/v1beta/projects/PROJECT_ID/locations/global/collections/default_collection/engines/APP_ID/servingConfigs/default_search:search" \
-d '{
"servingConfig": "projects/PROJECT_ID/locations/global/collections/default_collection/engines/APP_ID/servingConfigs/default_search",
"imageQuery": {"imageBytes":"IMAGE_BYTES"},
"pageSize": "PAGE_SIZE",
"offset": "OFFSET",
"params": {"search_type": 1}
}'

    次のように置き換えます。

    • PROJECT_ID: 実際のプロジェクトの ID。

    • APP_ID: アプリの ID。

    • QUERY: 検索クエリのテキスト。（例: 「丸いヘッドライトの車」、「ストライプのドレスを表示」）。（例: 「丸いヘッドライトの車」、「ストライプのドレスを表示」）。

    • IMAGE_BYTES: Base64 でエンコードされたバイトの画像。サポートされている形式は JPEG、PNG、BMP です。

    • PAGE_SIZE: 省略可。検索によって返された結果の数。デフォルト値は、ウェブサイト検索の場合は 10 です。

      • 0 未満の値はエラーになります。
      • 100 を超える値は 100 に設定されます。

    • OFFSET: 省略可。結果の開始インデックス。 デフォルト値は 0 です。

      たとえば、オフセットが 2 でページサイズが 10 の場合、結果 2 から 11 が返されます。

  3. 回答を確認します。 項目の説明については、次の表をご覧ください。

    項目 説明
    title 画像を含むウェブページの書式なしテキストのタイトル
    htmlTitle 画像を含むウェブページの HTML 形式のタイトル
    displayLink この検索結果の URL の省略形、通常はドメイン名（例: www.example.com）
    link 画像の URL
    image.contextLink コンテキスト リンク: 画像を含むウェブページを指す URL
    image.byteSize 画像のサイズ（バイト単位）
    image.width 画像の幅（ピクセル単位）
    image.height 画像の高さ（ピクセル単位）
    image.thumbnailWidth 画像の幅（ピクセル単位）
    image.thumbnailHeight 画像の高さ（ピクセル単位）
    image.thumbnailLink サムネイル画像の URL
    mime 画像の MIME タイプ
    fileFormat 画像のファイル形式