格式化大量匯入 CSV 檔案

您可以使用 import 方法，透過 CSV 檔案同時建立產品集和產品，並附上參考圖片。本頁說明如何設定 CSV 檔案格式。

建立參考圖片

參考圖片是包含產品不同角度的圖片。請遵循下列最佳化建議：

  • 請確認檔案大小未超過上限 (20 MB)。
  • 請考量能合理突顯產品的視角，並包含相關視覺資訊。
  • 建立參考圖片，補足缺少的視角。舉例來說，如果你只有一雙鞋的右鞋圖片，請提供鏡像版本的檔案做為左鞋。
  • 請上傳解析度最高的圖片。
  • 以白色背景顯示產品。
  • 將透明背景的 PNG 轉換為純色背景。

圖片必須儲存在 Cloud Storage 值區。如果您使用 API 金鑰驗證圖片建立呼叫，則該儲存桶必須是公開的。如果您使用服務帳戶進行驗證，該服務帳戶必須具備值區的讀取權限。

CSV 格式規範

如要使用 import 方法，CSV 檔案和其所指向的圖片都必須位於 Cloud Storage 值區。CSV 檔案最多可包含 20,000 行，每行最多可包含 2,048 個字元。如要匯入更多圖片，請將圖片分割成多個 CSV 檔案。

CSV 檔案必須每行包含一張圖片，並包含下列欄位：

  1. image-uri：參考圖片的 Cloud Storage URI。
  2. image-id：選用。如有提供，則為不重複的值。否則系統會指派專屬值。
  3. product-set-id：要匯入圖片的產品集專屬 ID。

  4. product-id：由參考圖片辨識的產品，使用者定義的 ID。product-id 可與多張參考圖片建立關聯。

  5. product-category：允許的值為 homegoods-v2、apparel-v2、toys-v2、packagedgoods-v1 和 general-v1*；由參考圖片辨識的產品類別。如果未在建立要求中指定，系統會推斷。您也可以在 productCategory 參考說明文件中查看允許的值。

  6. product-display-name：選用。如果未提供產品名稱，displayName 會設為「"」。您可以稍後更新這個值。

  7. labels：選用。描述參考圖片中產品的鍵/值組合字串 (含引號)。例如：

    • "category=shoes"

    • "color=black,style=formal"

      Vision API Product Search 也允許您為單一鍵提供多個值。例如：

    • "category=shoes,category=heels"

    • "color=black,style=formal,style=mens"

  8. bounding-poly：選用。指定參考圖片中的感興趣區域。如果未指定邊界框：

    1. Vision API 會推斷圖片的邊界框，如果 API 偵測到多個產品，則單張圖片中的多個區域可能會編入索引。
    2. 行結尾必須是半形逗號。

    請參考下方範例，瞭解未指定邊界多邊形的產品。

    如果您納入邊界框，boundingPoly 欄應包含以半形逗號分隔的偶數，格式為 p1_x,p1_y,p2_x,p2_y,...,pn_x,pn_y。範例行如下所示：0.1,0.1,0.9,0.1,0.9,0.9,0.1,0.9。

    如要使用圖片的實際像素值定義定界框，請使用非負整數。因此，您可以透過下列方式，在 1000 x 1000 像素的圖片中表示邊界框：

    gs://example-reference-images/10001-001/10001-001_A.jpg,img001,sample-set-summer,sample-product-123,tan summer bag,apparel-v2,"style=womens,color=tan",100,150,450,150,450,550,100,550
gs://example-reference-images/10001-001/10001-001_A.jpg,img001,sample-set-summer,sample-product-456,blue summer bag,apparel-v2,"style=womens,color=blue",670,790,980,790,980,920,670,920
gs://example-reference-images/10002-002/10002-002_B.jpg,img002,sample-set-summer,sample-product-123,apparel-v2,,,

    Vision API Product Search 也允許您使用邊界框的標準化值。使用浮點值範圍為 [0, 1] 的規格化值定義邊界框。

    使用標準化值時，上述參考圖片資料列也可以表示為：

    gs://example-reference-images/10001-001/10001-001_A.jpg,img001,sample-set-summer,sample-product-123,tan summer bag,apparel-v2,"style=womens,color=tan",0.10,0.15,0.45,0.15,0.45,0.55,0.10,0.55
gs://example-reference-images/10001-001/10001-001_A.jpg,img001,sample-set-summer,sample-product-456,blue summer bag,apparel-v2,"style=womens,color=blue",0.67,0.79,0.98,0.79,0.98,0.92,0.67,0.92
gs://example-reference-images/10002-002/10002-002_B.jpg,img002,sample-set-summer,sample-product-123,apparel-v2,,,