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/v1p4beta1/{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

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

ImportProductSetsInputConfig

productSets.import 方法的输入内容。

JSON 表示法 
{
  "gcsSource": {
    object (ImportProductSetsGcsSource)
  }
}
字段
gcsSource

object (ImportProductSetsGcsSource)

一个 csv 文件的 Google Cloud Storage 位置，其中每行保留一个 ImportProductSetRequests 列表。

ImportProductSetsGcsSource

一个 csv 文件的 Google Cloud Storage 位置，其中每行保留一个 ImportProductSetRequests 列表。

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 万像素），导致系统无法处理图片，则系统将调整图片大小。