Method: projects.locations.products.referenceImages.create

创建并返回新的 ReferenceImage 资源。

boundingPoly 字段为可选字段。如果未指定 boundingPoly，系统会尝试检测图片中与父级商品的 productCategory 类别相匹配的目标区域。如果已指定此字段，则始终跳过该项检测。系统会将多边形转换成非旋转式的矩形。

请注意，如果图片分辨率过大（超过 5 千万像素），无法处理，则流水线会调整图片大小。

可能出现的错误：

  • 如果 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

由用户为要添加的 ReferenceImage 提供的资源 ID。如果设置，则服务器会尝试将此值用作资源 ID。如果其已被使用，则系统会返回错误，并返回代码 ALREADY_EXISTS。长度不得超过 128 个字符。不能包含 / 字符。

请求正文

请求正文包含一个 ReferenceImage 实例。

响应正文

如果成功，响应正文将包含一个新创建的 ReferenceImage 实例。

授权范围

需要以下 OAuth 范围之一：

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

如需了解详情，请参阅身份验证概览。