Method: projects.locations.products.referenceImages.create

建立並傳回新的 ReferenceImage 資源。

boundingPoly 為選填欄位。如果未指定 boundingPoly，系統會嘗試在圖片中偵測與父項產品的 productCategory 相容的區域。如果指定此值，系統一律會略過偵測作業。系統會將多邊形轉換為未旋轉的矩形。

請注意，如果圖片解析度過大 (超過 5000 萬像素)，管道會調整圖片大小。

可能發生的錯誤：

  • 如果缺少 imageUri 或長度超過 4096 個字元，就會傳回 INVALID_ARGUMENT。
  • 如果產品不存在，則傳回 INVALID_ARGUMENT。
  • 如果未提供 boundingPoly，且系統未偵測到與父項產品的 productCategory 相容的項目，則會傳回 INVALID_ARGUMENT。
  • 如果 boundingPoly 包含超過 10 個多邊形，則會傳回 INVALID_ARGUMENT。

HTTP 要求

POST https://vision.googleapis.com/v1p4beta1/{parent=projects/*/locations/*/products/*}/referenceImages

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

路徑參數

參數
parent

string

要建立參考圖片的產品資源名稱。

格式為 projects/PROJECT_ID/locations/LOC_ID/products/PRODUCT_ID。

查詢參數

參數
referenceImageId

string

使用者提供的資源 ID，用於新增 ReferenceImage。如果已設定，伺服器就會嘗試使用這個值做為資源 ID。如果已有人使用，系統會傳回錯誤代碼 ALREADY_EXISTS。長度不得超過 128 個字元。不得包含 / 字元。

要求主體

要求主體包含 ReferenceImage 的執行個體。

回應主體

如果成功，回應主體會包含新建立的 ReferenceImage 執行個體。

授權範圍

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

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

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