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)

ต้องระบุ ข้อมูลที่มีอยู่เกี่ยวกับผลิตภัณฑ์ ใช้เพื่อแจ้งโมเดล GenAI
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

ข้อมูลที่มีอยู่เกี่ยวกับผลิตภัณฑ์ ใช้เพื่อแจ้งโมเดล GenAI

การแสดง 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

ไม่บังคับ เวิร์กโฟลว์ที่จะดำเนินการสำหรับข้อมูลผลิตภัณฑ์ที่ระบุ เวิร์กโฟลว์อาจป้อนข้อมูลชื่อ คำอธิบาย หรือทั้ง 2 อย่างของคำตอบ
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

คะแนนคุณภาพที่เชื่อมโยงกับการสร้าง ใช้ฮิวริสติกตามรูปแบบการติดตั้งใช้งานของทีม feedgen
changeSummary

string

สรุปสั้นๆ เกี่ยวกับการเปลี่ยนแปลงทั้งหมดที่เกิดขึ้น

ProductTextGenerationMetadata

ประเภทข้อมูล Wrapper สำหรับข้อมูลเมตาทั้งหมดที่เชื่อมโยงกับการสร้างข้อความ

การแสดง JSON 
{
  "metadata": {
    object
  }
}
ช่อง
metadata

object (Struct format)

ข้อมูลเมตาเป็นแนวคิดที่ค่อนข้างกว้าง ข้อมูลได้รับการจำลองเป็นแผนที่ที่นี่เพื่อระบุว่าไม่มีโครงสร้างที่รับประกันสำหรับเอาต์พุตที่ผ่านมานอกเหนือจากการเชื่อมโยง K:V อย่างง่าย กรณีการใช้งานแรกคือการติดตามคำที่เพิ่ม/นำออก/เปลี่ยนแปลงในการสร้าง