Method: projects.generateProductText

Tạo một tập hợp các câu hoàn chỉnh/câu trả lời đề xuất từ thông tin sản phẩm.

Yêu cầu HTTP

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

URL sử dụng cú pháp Chuyển mã gRPC.

Tham số đường dẫn

Thông số
parent

string

Bắt buộc. Dự án gọi điện. Phải đề cập đến dự án của người gọi. Định dạng: projects/{project-id}.

Nội dung yêu cầu

Nội dung yêu cầu chứa dữ liệu có cấu trúc sau:

Biểu diễn dưới dạng JSON 
{
  "titleExamples": [
    {
      object (TitleExample)
    }
  ],
  "productInfo": {
    object (ProductInfo)
  },
  "outputSpec": {
    object (OutputSpec)
  }
}
Trường
titleExamples[]

object (TitleExample)

Không bắt buộc. Cung cấp một số ví dụ được tạo thủ công về cách cải thiện tiêu đề dành riêng cho trường hợp sử dụng của bạn. TiDe là một công cụ chung xử lý nhiều danh mục sản phẩm, nhưng bản sắc thương hiệu của bạn có thể yêu cầu chức năng tuỳ chỉnh. Bạn có thể nêu rõ tại đây.
productInfo

object (ProductInfo)

Bắt buộc. Thông tin hiện có về sản phẩm. Được dùng để cung cấp thông tin cho các mô hình AI tạo sinh.
outputSpec

object (OutputSpec)

Không bắt buộc. Các tham số cấu hình ảnh hưởng trực tiếp đến nội dung được tạo và cách nội dung đó được hiển thị trong câu trả lời cuối cùng.

Nội dung phản hồi

Văn bản được tạo cho một sản phẩm được cung cấp.

Nếu thành công, phần nội dung phản hồi sẽ chứa dữ liệu có cấu trúc sau:

Biểu diễn dưới dạng JSON 
{
  "attributes": {
    string: string,
    ...
  },
  "title": {
    object (ProductTextGenerationSuggestion)
  },
  "description": {
    object (ProductTextGenerationSuggestion)
  },
  "metadata": {
    object (ProductTextGenerationMetadata)
  }
}
Trường
attributes

map (key: string, value: string)

Mọi thuộc tính được tạo khác

Một đối tượng chứa danh sách các cặp "key": value. Ví dụ: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
title

object (ProductTextGenerationSuggestion)

Tiêu đề được tạo.
description

object (ProductTextGenerationSuggestion)

Nội dung mô tả được tạo.
metadata

object (ProductTextGenerationMetadata)

Thông tin bổ sung mà các ứng dụng có thể muốn kiểm tra xung quanh quá trình tạo.

ProductInfo

Thông tin hiện có về sản phẩm. Được dùng để cung cấp thông tin cho các mô hình AI tạo sinh.

Biểu diễn dưới dạng JSON 
{
  "productAttributes": {
    string: string,
    ...
  },
  "productImage": {
    object (Image)
  }
}
Trường
productAttributes

map (key: string, value: string)

Bắt buộc. Một mối liên kết của tất cả các thuộc tính sản phẩm hiện có. Thông tin này có thể bao gồm tiêu đề, nội dung mô tả, thương hiệu, giới tính, màu sắc, kích thước, v.v.

Một đối tượng chứa danh sách các cặp "key": value. Ví dụ: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
productImage

object (Image)

Không bắt buộc. Hình ảnh liên kết với sản phẩm.

OutputSpec

Các tham số cấu hình ảnh hưởng trực tiếp đến nội dung được tạo và cách nội dung đó được hiển thị trong câu trả lời cuối cùng.

Biểu diễn dưới dạng JSON 
{
  "workflowId": string,
  "tone": string,
  "editorialChanges": string
}
Trường
workflowId

string

Không bắt buộc. Quy trình làm việc cần thực hiện cho dữ liệu sản phẩm được cung cấp. Quy trình có thể điền sẵn tiêu đề, nội dung mô tả hoặc cả hai cho câu trả lời.
tone

string

Không bắt buộc. Giọng điệu đầu ra mong muốn cho văn bản được tạo. Ví dụ: nghiêm túc, thân mật.
editorialChanges

string

Không bắt buộc. Mọi thay đổi biên tập đối với dữ liệu sản phẩm được tạo. Ví dụ: thay thế Small bằng "S", không sửa đổi màu nếu đã có.

TitleExample

Ví dụ được tạo thủ công về việc cải thiện tiêu đề sản phẩm. Những ví dụ này được cung cấp cho AI để cải thiện chất lượng của AI.

Biểu diễn dưới dạng JSON 
{
  "productInfo": {
    string: string,
    ...
  },
  "finalProductInfo": {
    string: string,
    ...
  },
  "titleFormat": string,
  "category": string
}
Trường
productInfo

map (key: string, value: string)

Bắt buộc. Một bản đồ chứa tất cả thông tin sản phẩm hiện có. Ví dụ: {"title": "dress", "description": "A red dress", "brand": "Dresses4All"} Mọi thông tin mà bạn có thể dùng để điền sẵn vào nguồn cấp dữ liệu sản phẩm.

Một đối tượng chứa danh sách các cặp "key": value. Ví dụ: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
finalProductInfo

map (key: string, value: string)

Bắt buộc. Một bản đồ có cùng định dạng với productInfo nhưng có tất cả các điểm cải tiến. Ví dụ: {"brand": "Dresses4All", "product": "dress", "color": "red", ...} Hiện tại, hãy sắp xếp các thuộc tính này theo thứ tự mà bạn muốn chúng xuất hiện trong tiêu đề cuối cùng. Ví dụ: ở trên sẽ trở thành: Dresses4All dress | red

Một đối tượng chứa danh sách các cặp "key": value. Ví dụ: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
titleFormat

string

Bắt buộc. Các thuộc tính hoặc thuộc tính gần đúng tạo nên tiêu đề. Ví dụ: tiêu đề "Google GShoe M" có thể có titleFormat là "thương hiệu | sản phẩm | kích thước".
category

string

Bắt buộc. Danh mục sản phẩm. Điều này giúp AI hiểu được khi nào một số ví dụ phù hợp hơn những ví dụ khác.

ProductTextGenerationSuggestion

Văn bản được tạo cho một sản phẩm, có thể bao gồm điểm chất lượng của sản phẩm đó.

Biểu diễn dưới dạng JSON 
{
  "text": string,
  "score": number,
  "changeSummary": string
}
Trường
text

string

Văn bản được tạo
score

number

Điểm chất lượng liên quan đến thế hệ. Phương pháp phỏng đoán được triển khai theo các kiểu triển khai của nhóm feedgen.
changeSummary

string

Tóm tắt ngắn gọn tất cả các thay đổi đã được thực hiện.

ProductTextGenerationMetadata

Loại dữ liệu trình bao bọc cho mọi siêu dữ liệu liên kết với tính năng tạo văn bản.

Biểu diễn dưới dạng JSON 
{
  "metadata": {
    object
  }
}
Trường
metadata

object (Struct format)

Siêu dữ liệu là một khái niệm khá rộng. Dữ liệu được mô hình hoá dưới dạng bản đồ ở đây để cho biết rằng không có cấu trúc đảm bảo nào cho đầu ra ngoài mối liên kết K:V đơn giản. Trường hợp sử dụng đầu tiên là theo dõi những từ được thêm/xoá/thay đổi trong nội dung được tạo.