本頁面由 Cloud Translation API 翻譯而成。

在網站上搜尋圖片

透過 Vertex AI Search，您可以使用含有網站資料的應用程式搜尋圖片。您以文字字串或圖片的形式提供查詢，而 default_config.search 方法會傳回該查詢的圖片。

事前準備

請確認您符合下列先決條件。需求條件因搜尋方式而異，請參閱下方說明。

如果您在網站搜尋應用程式中使用文字查詢進行搜尋，請確認已啟用下列功能：Enterprise 版功能
如果您在網站搜尋應用程式中使用圖片查詢搜尋，請確認已啟用下列項目：
- Enterprise 版功能
- 進階網站索引建立功能

預覽圖片搜尋結果

如要使用指令列預覽網站的圖片搜尋結果，請使用 engines.servingConfigs.search 方法：

注意：您可以使用 engines.servingConfigs.search 方法搜尋應用程式，並使用 dataStores.servingConfigs.search 方法搜尋資料儲存庫。在下列程序中，Google 建議使用 engines.servingConfigs.search 方法進行搜尋。

找出應用程式 ID。如果已有應用程式 ID，請跳到下一個步驟。
1. 前往 Google Cloud 控制台的「AI Applications」頁面。
  
  前往「應用程式」
2. 在「應用程式」頁面中，找出應用程式名稱，然後從「ID」欄取得應用程式的 ID。

呼叫 engines.servingConfigs.search 方法，並為 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/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 個結果。

查看回覆。請參閱下表瞭解欄位說明：

欄位	說明
`title`	包含圖片的網頁純文字標題
`htmlTitle`	包含圖片的網頁標題 (HTML 格式)
`displayLink`	這項搜尋的結果網址縮寫版，通常是網域名稱，例如 `www.example.com`
`link`	圖片的網址
`image.contextLink`	內容連結：指向包含圖片的網頁網址
`image.byteSize`	圖片大小 (以位元組為單位)
`image.width`	圖片寬度 (以像素為單位)
`image.height`	圖片高度 (以像素為單位)
`image.thumbnailWidth`	縮圖的寬度 (以像素為單位)
`image.thumbnailHeight`	縮圖的高度 (以像素為單位)
`image.thumbnailLink`	縮圖圖片的網址
`mime`	圖片的 MIME 類型
`fileFormat`	圖片的檔案格式