- HTTP 요청
- 경로 매개변수
- 요청 본문
- 응답 본문
- ProductInfo
- OutputSpec
- TitleExample
- ProductTextGenerationSuggestion
- ProductTextGenerationMetadata
제품 정보에서 후보 텍스트 완성/응답 세트를 생성합니다.
HTTP 요청
POST https://productstudio.googleapis.com/v1/{parent=projects/*}:generateProductText
URL은 gRPC 트랜스코딩 문법을 사용합니다.
경로 매개변수
매개변수 | |
---|---|
parent |
필수입니다. 전화를 걸 프로젝트입니다. 호출자의 프로젝트를 참조해야 합니다. 형식: |
요청 본문
요청 본문에는 다음과 같은 구조의 데이터가 포함됩니다.
JSON 표현 |
---|
{ "titleExamples": [ { object ( |
필드 | |
---|---|
titleExamples[] |
선택사항입니다. 사용 사례에 고유한 제목 개선사항의 수작업 예시를 제공해 줘. TiDe는 여러 제품 카테고리를 처리하는 일반적인 도구이지만 브랜드 아이덴티티에 맞춤 기능이 필요할 수 있습니다. 여기에 지정해 주세요. |
productInfo |
필수입니다. 제품에 관한 사용 가능한 정보입니다. 생성형 AI 모델에 정보를 제공하는 데 사용됩니다. |
outputSpec |
선택사항입니다. 생성되는 콘텐츠와 최종 대답에서 콘텐츠가 렌더링되는 방식에 직접적인 영향을 미치는 구성 매개변수입니다. |
응답 본문
제공된 제품에 대해 생성된 텍스트입니다.
성공한 경우 응답 본문은 다음과 같은 구조의 데이터를 포함합니다.
JSON 표현 |
---|
{ "attributes": { string: string, ... }, "title": { object ( |
필드 | |
---|---|
attributes |
기타 생성된 속성
|
title |
생성된 제목입니다. |
description |
생성된 설명입니다. |
metadata |
클라이언트가 생성과 관련하여 감사할 수 있는 추가 정보입니다. |
ProductInfo
제품에 관한 사용 가능한 정보입니다. 생성형 AI 모델에 정보를 제공하는 데 사용됩니다.
JSON 표현 |
---|
{
"productAttributes": {
string: string,
...
},
"productImage": {
object ( |
필드 | |
---|---|
productAttributes |
필수입니다. 사용 가능한 모든 제품 속성의 매핑입니다. 여기에는 제품명, 설명, 브랜드, 성별, 색상, 사이즈 등이 포함될 수 있습니다.
|
productImage |
선택사항입니다. 제품과 연결된 이미지입니다. |
OutputSpec
생성되는 콘텐츠와 최종 대답에서 콘텐츠가 렌더링되는 방식에 직접적인 영향을 미치는 구성 매개변수입니다.
JSON 표현 |
---|
{ "workflowId": string, "tone": string, "editorialChanges": string } |
필드 | |
---|---|
workflowId |
선택사항입니다. 제공된 제품 데이터에 대해 실행할 워크플로입니다. 워크플로는 대답의 제목, 설명 또는 둘 다를 채울 수 있습니다. |
tone |
선택사항입니다. 생성된 텍스트의 원하는 출력 어조입니다(예: 심각한, 캐주얼). |
editorialChanges |
선택사항입니다. 생성된 제품 데이터의 편집 변경사항입니다. 예를 들어 'Small'을 'S'로 대체합니다. 색상이 이미 있는 경우 수정하지 않습니다. |
TitleExample
제품 제목 개선의 수동으로 만든 예시입니다. 이러한 예는 AI의 품질을 개선하기 위해 제공됩니다.
JSON 표현 |
---|
{ "productInfo": { string: string, ... }, "finalProductInfo": { string: string, ... }, "titleFormat": string, "category": string } |
필드 | |
---|---|
productInfo |
필수입니다. 기존 제품 정보를 모두 포함하는 맵입니다. 예를 들면 다음과 같습니다. {"title": "dress", "description": "A red dress", "brand": "Dresses4All"} 제품 피드를 채우는 데 사용할 수 있는 정보입니다.
|
finalProductInfo |
필수입니다. productInfo와 동일한 형식의 맵으로, 모든 개선사항이 포함되어 있습니다. 예: {"brand": "Dresses4All", "product": "dress", "color": "red", ...} 지금은 최종 제품명에 표시할 순서대로 이러한 속성을 정렬하세요. 예를 들어 위의 속성은 Dresses4All dress | red가 됩니다.
|
titleFormat |
필수입니다. 제품명을 구성하는 속성 또는 대략적인 속성입니다. 예를 들어 제품명이 'Google GShoe M'인 경우 titleFormat은 'brand | product | size'일 수 있습니다. |
category |
필수입니다. 제품의 카테고리입니다. 이렇게 하면 AI가 특정 예시가 다른 예시보다 더 관련성이 있는 경우를 이해하는 데 도움이 됩니다. |
ProductTextGenerationSuggestion
제품에 대해 생성된 텍스트로, 품질 점수를 포함할 수 있습니다.
JSON 표현 |
---|
{ "text": string, "score": number, "changeSummary": string } |
필드 | |
---|---|
text |
생성된 텍스트 |
score |
생성과 관련된 품질 점수입니다. 피드 생성팀의 구현 스타일에 따라 구현된 휴리스틱입니다. |
changeSummary |
이루어진 모든 변경사항을 간략하게 요약합니다. |
ProductTextGenerationMetadata
텍스트 생성과 관련된 모든 메타데이터의 래퍼 데이터 유형입니다.
JSON 표현 |
---|
{ "metadata": { object } } |
필드 | |
---|---|
metadata |
메타데이터는 상당히 느슨한 개념입니다. 여기서는 데이터가 맵으로 모델링되어 간단한 K:V 연결을 지나면 출력에 보장된 구조가 없음을 나타냅니다. 첫 번째 사용 사례는 생성에서 추가/삭제/변경된 단어를 추적하는 것입니다. |