Method: projects.generateProductTextAttributes

제품 정보에서 누락된 속성을 생성합니다.

HTTP 요청

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

URL은 gRPC 트랜스코딩 문법을 사용합니다.

경로 매개변수

매개변수
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)

필수입니다. 생성할 속성입니다. 지원되는 값은 성별, 연령대, 색상, 사이즈이며 이러한 값 중 하나 이상을 설정해야 합니다. 여기에 설정된 값만 응답에 포함됩니다.
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입니다.