Method: projects.locations.productSets.import

非同步 API，可根據圖片資訊清單，將參考圖片清單匯入指定的產品集。

google.longrunning.Operation API 可用來追蹤要求的進度和結果。Operation.metadata 包含 BatchOperationMetadata。(進度) Operation.response 包含 ImportProductSetsResponse。(結果)

這個方法的輸入來源是 Google Cloud Storage 中的 CSV 檔案。如要瞭解 CSV 檔案格式，請參閱 ImportProductSetsGcsSource.csv_file_uri。

HTTP 要求

POST https://vision.googleapis.com/v1/{parent=projects/*/locations/*}/productSets:import

這個網址使用 gRPC 轉碼語法。

路徑參數

參數
parent

string

這是必要旗標，應匯入 ProductSet 的專案。

格式為 projects/PROJECT_ID/locations/LOC_ID。

要求主體

要求主體包含下列結構的資料：

JSON 表示法 
{
  "inputConfig": {
    object (ImportProductSetsInputConfig)
  }
}
欄位
inputConfig

object (ImportProductSetsInputConfig)

這是必要旗標，要求清單的輸入內容。

回應主體

如果成功，回應主體會包含 Operation 的執行個體。

授權範圍

需要下列其中一種 OAuth 範圍：

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/cloud-vision

詳情請參閱驗證總覽一文。

匯入產品集輸入設定

productSets.import 方法的輸入內容。

JSON 表示法 
{
  "gcsSource": {
    object (ImportProductSetsGcsSource)
  }
}
欄位
gcsSource

object (ImportProductSetsGcsSource)

CSV 檔案的 Google Cloud Storage 位置，其中每行都保留 ImportProductSetRequests 清單。

匯入產品集 GCS 來源

CSV 檔案的 Google Cloud Storage 位置，其中每行都保留 ImportProductSetRequest 清單。

JSON 表示法 
{
  "csvFileUri": string
}
欄位
csvFileUri

string

輸入 CSV 檔案的 Google Cloud Storage URI。

URI 的開頭必須是 gs://。

輸入 CSV 檔案的格式應為每行一張圖片。每行有 8 個資料欄。

  1. image-uri
  2. image-id
  3. product-set-id
  4. product-id
  5. product-category
  6. product-display-name
  7. 標籤
  8. bounding-poly

必須有 image-uri、product-set-id、product-id 和 product-category 欄。所有其他欄均為選用欄。

如果 product-set-id 和 product-id 值指定的 ProductSet 或 Product 不存在，系統會為圖片建立新的 ProductSet 或 Product。在本例中，product-display-name 欄參照 displayName，product-category 欄參照 productCategory，labels 欄則參照 productLabels。

image-id 欄為選用欄，但如果提供此欄，欄值不得重複。如果留空，系統會自動為圖片指派專屬 ID。

product-display-name 欄為選填欄位。如果空白，系統會將產品的 displayName 欄位設為空格 (" ")。您可以稍後使用 API 更新 displayName。

如果已存在具有指定 product-id 的 Product，系統會忽略 product-display-name、product-category 和 labels 欄。

labels 欄位 (選用) 是一行以半形逗號分隔的鍵/值組合清單，格式如下：

"key_1=value_1,key_2=value_2,...,key_n=value_n"

bounding-poly 欄 (選用) 會以與 referenceImages.create 相同的方式，識別圖片中的感興趣區域。如果您未指定 bounding-poly 欄，系統會嘗試自動偵測感興趣的區域。

每行最多只能有一個 bounding-poly 欄。如果圖片包含多個感興趣區域，請在 CSV 檔案中新增一行，其中包含相同的產品資訊，以及每個感興趣區域的 bounding-poly 值。

bounding-poly 欄必須包含以半形逗號分隔的偶數個數字，格式為「p1_x,p1_y,p2_x,p2_y,...,pn_x,pn_y」。請使用非負整數表示絕對邊界多邊形，使用 [0, 1] 內的浮點值表示經過標準化的邊界多邊形。

如果圖片解析度過大而無法處理 (大於 2000 萬像素)，系統會調整圖片大小。