Method: projects.generateProductTextAttributes

Tạo các thuộc tính bị thiếu từ thông tin sản phẩm.

Yêu cầu HTTP

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

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 
{
  "inputAttributes": [
    {
      object (Attribute)
    }
  ],
  "generativeAttributes": [
    {
      object (Attribute)
    }
  ],
  "offerImage": {
    object (Image)
  },
  "clientRequestContext": {
    object (ClientRequestContext)
  },
  "allowAnyConfidenceSuggestions": boolean
}
Trường
inputAttributes[]

object (Attribute)

Không bắt buộc. Các thuộc tính đầu vào được dùng để tạo đề xuất. Các giá trị được hỗ trợ là: tiêu đề, nội dung mô tả. Các thuộc tính này sẽ không có trong phản hồi và sẽ không thay đổi.
generativeAttributes[]

object (Attribute)

Bắt buộc. Các thuộc tính sẽ được tạo. Các giá trị được hỗ trợ là giới tính, nhóm tuổi, màu sắc và kích thước, đồng thời bạn phải đặt ít nhất một trong các giá trị đó. Chỉ những giá trị được đặt ở đây mới được đưa vào phản hồi.
offerImage

object (Image)

Bắt buộc. Hình ảnh liên kết với sản phẩm.
clientRequestContext

object (ClientRequestContext)

Bắt buộc. Thông tin về ứng dụng đưa ra yêu cầu.
allowAnyConfidenceSuggestions

boolean

Không bắt buộc. Nếu đúng, các đề xuất thuộc tính có tất cả các mức độ tin cậy sẽ được đưa vào phản hồi. Theo mặc định, chỉ những đề xuất có độ tin cậy cao mới được đưa vào cho tất cả thuộc tính.

Nội dung phản hồi

Phản hồi cho projects.generateProductTextAttributes.

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 
{
  "suggestions": [
    {
      object (Attribute)
    }
  ]
}
Trường
suggestions[]

object (Attribute)

Đề xuất thuộc tính sản phẩm được tạo. Đây có thể là một danh sách trống nếu mô hình không thể đề xuất các thuộc tính có điểm số đủ tin cậy. Đề xuất có thể là giới tính, nhóm tuổi, màu sắc và kích thước dựa trên thuộc tính_cần_tạo trong yêu cầu.

Thuộc tính

Một thuộc tính sản phẩm được dùng trong yêu cầu và phản hồi.

Biểu diễn dưới dạng JSON 
{
  "key": string,
  "textValue": string,
  "confidenceLevel": enum (ConfidenceLevel)
}
Trường
key

string

Bắt buộc. Tên thuộc tính do người bán cung cấp.
textValue

string

Không bắt buộc. Lưu trữ giá trị văn bản của thuộc tính. Bạn phải đặt giá trị này cho inputAttributes trong GenerateProductTextAttributesRequest và cho các đề xuất trong GenerateProductTextAttributesResponse. Chỉ các thuộc tính văn bản được sử dụng/tạo tại thời điểm này và do đó, attribute_type(ví dụ: INT, RICH_TEXT) và các format_value khác(ví dụ: float_value, rich_text_value) không được xác định.
confidenceLevel

enum (ConfidenceLevel)

Không bắt buộc. Tham số này chỉ có trong phản hồi và sẽ xác định mức độ tin cậy của đề xuất thuộc tính được tạo.

ConfidenceLevel

Mức độ tin cậy của đề xuất thuộc tính do mô hình AI tạo ra. Mô hình này đưa ra điểm số về độ tin cậy cho từng đề xuất và được phân loại vào một trong các mức độ tin cậy. Ngưỡng độ tin cậy cho từng nhóm được xác định dựa trên đánh giá của con người về kết quả đầu ra của mô hình.

Enum
CONFIDENCE_LEVEL_UNSPECIFIED Mức độ tin cậy không xác định.
LOW Mức độ tin cậy thấp.
MEDIUM Mức độ tin cậy trung bình.
HIGH Mức độ tin cậy cao.

ClientRequestContext

Thông tin về ứng dụng đưa ra yêu cầu.

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

string

Bắt buộc. Mã sản phẩm do đối tác xác định.