Method: projects.generateProductText

Membuat serangkaian penyelesaian/respons teks kandidat dari informasi produk.

Permintaan HTTP

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

URL menggunakan sintaksis gRPC Transcoding.

Parameter jalur

Parameter
parent

string

Wajib. Project untuk melakukan panggilan. Harus merujuk ke project pemanggil. Format: projects/{project-id}.

Isi permintaan

Isi permintaan memuat data dengan struktur berikut:

Representasi JSON 
{
  "titleExamples": [
    {
      object (TitleExample)
    }
  ],
  "productInfo": {
    object (ProductInfo)
  },
  "outputSpec": {
    object (OutputSpec)
  }
}
Kolom
titleExamples[]

object (TitleExample)

Opsional. Berikan beberapa contoh peningkatan kualitas judul buatan tangan yang unik untuk kasus penggunaan Anda. TiDe adalah alat umum yang menangani beberapa kategori produk, tetapi identitas merek Anda mungkin memerlukan fungsi kustom. Jangan ragu untuk menentukannya di sini.
productInfo

object (ProductInfo)

Wajib. Informasi yang tersedia tentang produk. Digunakan untuk menginformasikan model AI generatif.
outputSpec

object (OutputSpec)

Opsional. Parameter konfigurasi yang secara langsung memengaruhi konten yang dihasilkan, dan cara konten tersebut dirender dalam respons akhir.

Isi respons

Teks yang dihasilkan untuk produk yang disediakan.

Jika berhasil, isi respons memuat data dengan struktur berikut:

Representasi JSON 
{
  "attributes": {
    string: string,
    ...
  },
  "title": {
    object (ProductTextGenerationSuggestion)
  },
  "description": {
    object (ProductTextGenerationSuggestion)
  },
  "metadata": {
    object (ProductTextGenerationMetadata)
  }
}
Kolom
attributes

map (key: string, value: string)

Atribut lain yang dihasilkan

Objek yang berisi daftar pasangan "key": value. Contoh: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
title

object (ProductTextGenerationSuggestion)

Judul yang dibuat.
description

object (ProductTextGenerationSuggestion)

Deskripsi yang dihasilkan.
metadata

object (ProductTextGenerationMetadata)

Info tambahan yang mungkin ingin diaudit klien terkait pembuatan.

ProductInfo

Informasi yang tersedia tentang produk. Digunakan untuk menginformasikan model AI generatif.

Representasi JSON 
{
  "productAttributes": {
    string: string,
    ...
  },
  "productImage": {
    object (Image)
  }
}
Kolom
productAttributes

map (key: string, value: string)

Wajib. Pemetaan semua atribut produk yang tersedia. Hal ini dapat mencakup judul, deskripsi, merek, gender, warna, ukuran, dll.

Objek yang berisi daftar pasangan "key": value. Contoh: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
productImage

object (Image)

Opsional. Gambar yang terkait dengan produk.

OutputSpec

Parameter konfigurasi yang secara langsung memengaruhi konten yang dihasilkan, dan cara konten tersebut dirender dalam respons akhir.

Representasi JSON 
{
  "workflowId": string,
  "tone": string,
  "editorialChanges": string
}
Kolom
workflowId

string

Opsional. Alur kerja yang akan dijalankan untuk data produk yang diberikan. Alur kerja dapat mengisi judul, deskripsi, atau keduanya dalam respons.
tone

string

Opsional. Gaya bahasa output yang diinginkan untuk teks yang dihasilkan. Misalnya, serius, kasual.
editorialChanges

string

Opsional. Setiap perubahan editorial untuk data produk yang dihasilkan. Misalnya, ganti Small dengan "S", jangan ubah warna jika sudah ada.

TitleExample

Contoh peningkatan judul produk yang dibuat secara manual. Contoh ini diberikan kepada AI untuk meningkatkan kualitasnya.

Representasi JSON 
{
  "productInfo": {
    string: string,
    ...
  },
  "finalProductInfo": {
    string: string,
    ...
  },
  "titleFormat": string,
  "category": string
}
Kolom
productInfo

map (key: string, value: string)

Wajib. Peta yang berisi semua informasi produk yang ada. Misalnya, {"title": "gaun", "description": "Gaun merah", "brand": "Dresses4All"} Informasi apa pun yang dapat Anda gunakan untuk mengisi feed produk.

Objek yang berisi daftar pasangan "key": value. Contoh: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
finalProductInfo

map (key: string, value: string)

Wajib. Peta dalam format yang sama dengan productInfo, tetapi dengan semua peningkatan disertakan. Misalnya, {"brand": "Dresses4All", "product": "dress", "color": "red", ...} Untuk saat ini, urutkan atribut ini sesuai urutan yang Anda inginkan dalam judul akhir. Misalnya, contoh di atas akan menjadi: Dresses4All dress | red

Objek yang berisi daftar pasangan "key": value. Contoh: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
titleFormat

string

Wajib. Atribut atau perkiraan atribut yang membentuk judul. Misalnya, title "Google GShoe M" titleFormat dapat berupa "brand | product | size".
category

string

Wajib. Kategori produk. Hal ini membantu AI memahami kapan contoh tertentu lebih relevan daripada yang lain.

ProductTextGenerationSuggestion

Teks yang dihasilkan untuk produk, yang secara opsional mencakup skor kualitasnya.

Representasi JSON 
{
  "text": string,
  "score": number,
  "changeSummary": string
}
Kolom
text

string

Teks yang dihasilkan
score

number

Skor kualitas yang terkait dengan pembuatan. Heuristik diterapkan sesuai dengan gaya penerapan tim feedgen.
changeSummary

string

Ringkasan singkat semua perubahan yang telah dilakukan.

ProductTextGenerationMetadata

Jenis data wrapper untuk metadata apa pun yang terkait dengan pembuatan teks.

Representasi JSON 
{
  "metadata": {
    object
  }
}
Kolom
metadata

object (Struct format)

Metadata adalah konsep yang cukup longgar. Data dimodelkan sebagai peta di sini untuk menunjukkan bahwa tidak ada struktur output yang dijamin setelah asosiasi K:V sederhana. Kasus penggunaan pertama adalah untuk melacak kata-kata yang ditambahkan/dihapus/diubah dalam pembuatan.