Method: projects.generateProductTextAttributes

商品情報から不足している属性を生成します。

HTTP リクエスト

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

この URL は gRPC Transcoding 構文を使用します。

パスパラメータ

パラメータ
parent

string

必須。呼び出しを行うプロジェクト。呼び出し元のプロジェクトを参照する必要があります。形式: projects/{project-id}。

リクエストの本文

リクエストの本文には、次の構造のデータが含まれます。

JSON 表現 
{
  "inputAttributes": [
    {
      object (Attribute)
    }
  ],
  "generativeAttributes": [
    {
      object (Attribute)
    }
  ],
  "offerImage": {
    object (Image)
  },
  "clientRequestContext": {
    object (ClientRequestContext)
  },
  "allowAnyConfidenceSuggestions": boolean
}
フィールド
inputAttributes[]

object (Attribute)

省略可。候補の生成に使用される入力属性。サポートされている値は、title と description です。これらの属性はレスポンスに含まれず、変更もされません。
generativeAttributes[]

object (Attribute)

必須。生成する属性。サポートされている値は、gender [性別]、age_group [年齢層]、color [色]、size [サイズ] です。これらの値のいずれか 1 つ以上を設定する必要があります。ここで設定された値のみがレスポンスに含まれます。
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。