Method: projects.generateProductTextAttributes

Membuat atribut yang tidak ada dari informasi produk.

Permintaan HTTP

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

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

object (Attribute)

Opsional. Atribut input yang digunakan untuk membuat saran. Nilai yang didukung adalah: title, description. Atribut ini tidak akan disertakan dalam respons dan tidak akan berubah.

generativeAttributes[]

object (Attribute)

Wajib. Atribut yang akan dibuat. Nilai yang didukung adalah gender, age_group, color, dan size, dan setidaknya salah satu nilai tersebut harus ditetapkan. Hanya nilai yang ditetapkan di sini yang akan disertakan dalam respons.

offerImage

object (Image)

Wajib. Gambar yang terkait dengan produk.

clientRequestContext

object (ClientRequestContext)

Wajib. Info tentang klien yang membuat permintaan.

allowAnyConfidenceSuggestions

boolean

Opsional. Jika benar, saran atribut dengan semua tingkat keyakinan akan disertakan dalam respons. Secara default, hanya saran dengan keyakinan tinggi yang disertakan untuk semua atribut.

Isi respons

Respons untuk projects.generateProductTextAttributes.

Jika berhasil, isi respons memuat data dengan struktur berikut:

Representasi JSON
{
  "suggestions": [
    {
      object (Attribute)
    }
  ]
}
Kolom
suggestions[]

object (Attribute)

Saran atribut produk yang dihasilkan. Kolom ini dapat kosong jika model tidak dapat menyarankan atribut dengan skor keyakinan yang memadai. Saran dapat berupa gender, age_group, color, dan size berdasarkan atribut_yang_akan_dibuat dalam permintaan.

Atribut

Atribut produk yang digunakan dalam permintaan dan respons.

Representasi JSON
{
  "key": string,
  "textValue": string,
  "confidenceLevel": enum (ConfidenceLevel)
}
Kolom
key

string

Wajib. Nama atribut sebagaimana diberikan oleh penjual.

textValue

string

Opsional. Menyimpan nilai teks atribut. Atribut ini harus ditetapkan untuk inputAttributes di GenerateProductTextAttributesRequest dan untuk saran di GenerateProductTextAttributesResponse. Hanya atribut teks yang digunakan/dibuat pada tahap ini, sehingga attribute_type(misalnya: INT, RICH_TEXT) dan format_values lainnya(misalnya: float_value, rich_text_value) tidak ditentukan.

confidenceLevel

enum (ConfidenceLevel)

Opsional. Atribut ini hanya ada dalam respons dan akan menentukan tingkat keyakinan saran atribut yang dihasilkan.

ConfidenceLevel

Tingkat keyakinan saran atribut yang dihasilkan oleh model AI. Model ini menghasilkan skor keyakinan untuk setiap saran dan dikelompokkan ke dalam salah satu tingkat keyakinan. Nilai minimum keyakinan untuk setiap kelompok ditentukan berdasarkan evaluasi manual terhadap output model.

Enum
CONFIDENCE_LEVEL_UNSPECIFIED Tingkat keyakinan tidak ditentukan.
LOW Tingkat keyakinan rendah.
MEDIUM Tingkat keyakinan sedang.
HIGH Tingkat keyakinan tinggi.

ClientRequestContext

Informasi tentang klien yang membuat permintaan.

Representasi JSON
{
  "partnerProductId": string
}
Kolom
partnerProductId

string

Wajib. ID produk yang ditentukan oleh partner.