格式化大量匯入 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 可以與多個參考圖片建立關聯。

   注意： 單一產品也可以屬於多個產品組合。如果大量匯入作業中已存在 product-id，系統就會忽略該行項目的 product-category、product-display 和 labels。

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

   * 舊版 productCategory 代碼： 系統仍支援舊版類別 (homegoods、apparel 和 toys)，但新產品應使用更新後的 -v2 類別。

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 的物件定位器功能，取得圖片中一般物件的定界框座標。

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