Method: projects.generateProductTextAttributes

根据商品信息生成缺失的属性。

HTTP 请求

POST https://productstudio.googleapis.com/v1/{parent=projects/*}:generateProductTextAttributes

网址采用 gRPC 转码语法。

路径参数

参数
parent

string

必需。要拨打电话的项目。必须引用调用者的项目。格式：projects/{project-id}。

请求正文

请求正文中包含结构如下的数据：

JSON 表示法 
{
  "inputAttributes": [
    {
      object (Attribute)
    }
  ],
  "generativeAttributes": [
    {
      object (Attribute)
    }
  ],
  "offerImage": {
    object (Image)
  },
  "clientRequestContext": {
    object (ClientRequestContext)
  },
  "allowAnyConfidenceSuggestions": boolean
}
字段
inputAttributes[]

object (Attribute)

可选。用于生成建议的输入属性。支持的值包括：商品名、说明。这些属性不会包含在响应中，也不会发生变化。
generativeAttributes[]

object (Attribute)

必需。要生成的属性。支持的值包括 gender [适用性别]、age_group [年龄段]、color [颜色] 和 size [尺寸]，并且应至少设置其中一个值。响应中将仅包含此处设置的值。
offerImage

object (Image)

必需。与商品相关联的图片。
clientRequestContext

object (ClientRequestContext)

必需。有关发出请求的客户端的信息。
allowAnyConfidenceSuggestions

boolean

可选。如果为 true，则响应中将包含所有置信度级别的属性建议。默认情况下，系统只会针对所有属性提供置信度较高的建议。

响应正文

针对 projects.generateProductTextAttributes 的响应。

如果成功，响应正文将包含结构如下的数据：

JSON 表示法 
{
  "suggestions": [
    {
      object (Attribute)
    }
  ]
}
字段
suggestions[]

object (Attribute)

生成的商品属性建议。如果模型无法以足够的置信度分数建议属性，则此字段可以为空。建议可以是性别、年龄段、颜色和尺寸中的任意一种，具体取决于请求中的 attributes_to_generate。

属性

在请求和响应中使用的商品属性。

JSON 表示法 
{
  "key": string,
  "textValue": string,
  "confidenceLevel": enum (ConfidenceLevel)
}
字段
key

string

必需。商家提供的属性名称。
textValue

string

可选。存储属性的文本值。必须在 GenerateProductTextAttributesRequest 中为 inputAttributes 设置此值，并在 GenerateProductTextAttributesResponse 中为建议设置此值。此时仅使用/生成文本属性，因此未定义 attribute_type（例如：INT、RICH_TEXT）和其他 format_values（例如：float_value、rich_text_value）。
confidenceLevel

enum (ConfidenceLevel)

可选。此字段仅存在于响应中，用于确定生成的属性建议的置信度。

ConfidenceLevel

AI 模型生成的属性建议的置信度。模型会为每个建议输出一个置信度分数，并将其归入某个置信度级别。每个区间的置信度阈值是根据人工对模型输出的评估结果确定的。

枚举
CONFIDENCE_LEVEL_UNSPECIFIED 未指定置信度。
LOW 置信度较低。
MEDIUM 中等置信度。
HIGH 高置信度。

ClientRequestContext

发出请求的客户的相关信息。

JSON 表示法 
{
  "partnerProductId": string
}
字段
partnerProductId

string

必需。合作伙伴定义的产品 ID。