Method: projects.generateProductText

제품 정보에서 후보 텍스트 완성/응답 세트를 생성합니다.

HTTP 요청

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

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

경로 매개변수

매개변수
parent

string

필수입니다. 전화를 걸 프로젝트입니다. 호출자의 프로젝트를 참조해야 합니다. 형식: projects/{project-id}

요청 본문

요청 본문에는 다음과 같은 구조의 데이터가 포함됩니다.

JSON 표현
{
  "titleExamples": [
    {
      object (TitleExample)
    }
  ],
  "productInfo": {
    object (ProductInfo)
  },
  "outputSpec": {
    object (OutputSpec)
  }
}
필드
titleExamples[]

object (TitleExample)

선택사항입니다. 사용 사례에 고유한 제목 개선사항의 수작업 예시를 제공해 줘. TiDe는 여러 제품 카테고리를 처리하는 일반적인 도구이지만 브랜드 아이덴티티에 맞춤 기능이 필요할 수 있습니다. 여기에 지정해 주세요.

productInfo

object (ProductInfo)

필수입니다. 제품에 관한 사용 가능한 정보입니다. 생성형 AI 모델에 정보를 제공하는 데 사용됩니다.

outputSpec

object (OutputSpec)

선택사항입니다. 생성되는 콘텐츠와 최종 대답에서 콘텐츠가 렌더링되는 방식에 직접적인 영향을 미치는 구성 매개변수입니다.

응답 본문

제공된 제품에 대해 생성된 텍스트입니다.

성공한 경우 응답 본문은 다음과 같은 구조의 데이터를 포함합니다.

JSON 표현
{
  "attributes": {
    string: string,
    ...
  },
  "title": {
    object (ProductTextGenerationSuggestion)
  },
  "description": {
    object (ProductTextGenerationSuggestion)
  },
  "metadata": {
    object (ProductTextGenerationMetadata)
  }
}
필드
attributes

map (key: string, value: string)

기타 생성된 속성

"key": value 쌍 목록을 포함하는 객체입니다. 예: { "name": "wrench", "mass": "1.3kg", "count": "3" }

title

object (ProductTextGenerationSuggestion)

생성된 제목입니다.

description

object (ProductTextGenerationSuggestion)

생성된 설명입니다.

metadata

object (ProductTextGenerationMetadata)

클라이언트가 생성과 관련하여 감사할 수 있는 추가 정보입니다.

ProductInfo

제품에 관한 사용 가능한 정보입니다. 생성형 AI 모델에 정보를 제공하는 데 사용됩니다.

JSON 표현
{
  "productAttributes": {
    string: string,
    ...
  },
  "productImage": {
    object (Image)
  }
}
필드
productAttributes

map (key: string, value: string)

필수입니다. 사용 가능한 모든 제품 속성의 매핑입니다. 여기에는 제품명, 설명, 브랜드, 성별, 색상, 사이즈 등이 포함될 수 있습니다.

"key": value 쌍 목록을 포함하는 객체입니다. 예: { "name": "wrench", "mass": "1.3kg", "count": "3" }

productImage

object (Image)

선택사항입니다. 제품과 연결된 이미지입니다.

OutputSpec

생성되는 콘텐츠와 최종 대답에서 콘텐츠가 렌더링되는 방식에 직접적인 영향을 미치는 구성 매개변수입니다.

JSON 표현
{
  "workflowId": string,
  "tone": string,
  "editorialChanges": string
}
필드
workflowId

string

선택사항입니다. 제공된 제품 데이터에 대해 실행할 워크플로입니다. 워크플로는 대답의 제목, 설명 또는 둘 다를 채울 수 있습니다.

tone

string

선택사항입니다. 생성된 텍스트의 원하는 출력 어조입니다(예: 심각한, 캐주얼).

editorialChanges

string

선택사항입니다. 생성된 제품 데이터의 편집 변경사항입니다. 예를 들어 'Small'을 'S'로 대체합니다. 색상이 이미 있는 경우 수정하지 않습니다.

TitleExample

제품 제목 개선의 수동으로 만든 예시입니다. 이러한 예는 AI의 품질을 개선하기 위해 제공됩니다.

JSON 표현
{
  "productInfo": {
    string: string,
    ...
  },
  "finalProductInfo": {
    string: string,
    ...
  },
  "titleFormat": string,
  "category": string
}
필드
productInfo

map (key: string, value: string)

필수입니다. 기존 제품 정보를 모두 포함하는 맵입니다. 예를 들면 다음과 같습니다. {"title": "dress", "description": "A red dress", "brand": "Dresses4All"} 제품 피드를 채우는 데 사용할 수 있는 정보입니다.

"key": value 쌍 목록을 포함하는 객체입니다. 예: { "name": "wrench", "mass": "1.3kg", "count": "3" }

finalProductInfo

map (key: string, value: string)

필수입니다. productInfo와 동일한 형식의 맵으로, 모든 개선사항이 포함되어 있습니다. 예: {"brand": "Dresses4All", "product": "dress", "color": "red", ...} 지금은 최종 제품명에 표시할 순서대로 이러한 속성을 정렬하세요. 예를 들어 위의 속성은 Dresses4All dress | red가 됩니다.

"key": value 쌍 목록을 포함하는 객체입니다. 예: { "name": "wrench", "mass": "1.3kg", "count": "3" }

titleFormat

string

필수입니다. 제품명을 구성하는 속성 또는 대략적인 속성입니다. 예를 들어 제품명이 'Google GShoe M'인 경우 titleFormat은 'brand | product | size'일 수 있습니다.

category

string

필수입니다. 제품의 카테고리입니다. 이렇게 하면 AI가 특정 예시가 다른 예시보다 더 관련성이 있는 경우를 이해하는 데 도움이 됩니다.

ProductTextGenerationSuggestion

제품에 대해 생성된 텍스트로, 품질 점수를 포함할 수 있습니다.

JSON 표현
{
  "text": string,
  "score": number,
  "changeSummary": string
}
필드
text

string

생성된 텍스트

score

number

생성과 관련된 품질 점수입니다. 피드 생성팀의 구현 스타일에 따라 구현된 휴리스틱입니다.

changeSummary

string

이루어진 모든 변경사항을 간략하게 요약합니다.

ProductTextGenerationMetadata

텍스트 생성과 관련된 모든 메타데이터의 래퍼 데이터 유형입니다.

JSON 표현
{
  "metadata": {
    object
  }
}
필드
metadata

object (Struct format)

메타데이터는 상당히 느슨한 개념입니다. 여기서는 데이터가 맵으로 모델링되어 간단한 K:V 연결을 지나면 출력에 보장된 구조가 없음을 나타냅니다. 첫 번째 사용 사례는 생성에서 추가/삭제/변경된 단어를 추적하는 것입니다.