Method: projects.generateProductText

Ürün bilgilerinden bir dizi aday metin tamamlama/yanıt oluşturur.

HTTP isteği

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

URL, gRPC Kod Dönüştürme söz dizimini kullanır.

Yol parametreleri

Parametreler
parent

string

Zorunlu. Telefon görüşmesi yapma projesi. Arayanın projesine atıfta bulunmalıdır. Biçim: projects/{project-id}.

İstek içeriği

İstek metni aşağıdaki yapıyla birlikte verileri içerir:

JSON gösterimi 
{
  "titleExamples": [
    {
      object (TitleExample)
    }
  ],
  "productInfo": {
    object (ProductInfo)
  },
  "outputSpec": {
    object (OutputSpec)
  }
}
Alanlar
titleExamples[]

object (TitleExample)

İsteğe bağlıdır. Kullanım alanınıza özel, başlık iyileştirmeleriyle ilgili bazı örnekler verin. TiDe, birden fazla ürün kategorisini işleyen genel bir araçtır ancak marka kimliğiniz özel işlevsellik gerektirebilir. Burada belirtebilirsiniz.
productInfo

object (ProductInfo)

Zorunlu. Ürünle ilgili mevcut bilgiler. Üretken yapay zeka modellerini bilgilendirmek için kullanılır.
outputSpec

object (OutputSpec)

İsteğe bağlıdır. Hangi içeriğin oluşturulacağını ve bu içeriğin nihai yanıtta nasıl işleneceğini doğrudan etkileyen yapılandırma parametreleri.

Yanıt gövdesi

Belirtilen bir ürün için oluşturulan metin.

Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:

JSON gösterimi 
{
  "attributes": {
    string: string,
    ...
  },
  "title": {
    object (ProductTextGenerationSuggestion)
  },
  "description": {
    object (ProductTextGenerationSuggestion)
  },
  "metadata": {
    object (ProductTextGenerationMetadata)
  }
}
Alanlar
attributes

map (key: string, value: string)

Diğer tüm oluşturulan özellikler

"key": value çiftlerinin listesini içeren bir nesne. Örnek: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
title

object (ProductTextGenerationSuggestion)

Oluşturulan başlık.
description

object (ProductTextGenerationSuggestion)

Oluşturulan açıklama.
metadata

object (ProductTextGenerationMetadata)

Müşterilerin oluşturma işlemiyle ilgili olarak denetlemek isteyebileceği ek bilgiler.

ProductInfo

Ürünle ilgili mevcut bilgiler. Üretken yapay zeka modellerini bilgilendirmek için kullanılır.

JSON gösterimi 
{
  "productAttributes": {
    string: string,
    ...
  },
  "productImage": {
    object (Image)
  }
}
Alanlar
productAttributes

map (key: string, value: string)

Zorunlu. Mevcut tüm ürün özelliklerinin eşlemesi. Başlık, açıklama, marka, cinsiyet, renk ve beden gibi bilgiler bu kapsamda yer alabilir.

"key": value çiftlerinin listesini içeren bir nesne. Örnek: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
productImage

object (Image)

İsteğe bağlıdır. Ürünle ilişkili resim.

OutputSpec

Hangi içeriğin oluşturulacağını ve bu içeriğin nihai yanıtta nasıl işleneceğini doğrudan etkileyen yapılandırma parametreleri.

JSON gösterimi 
{
  "workflowId": string,
  "tone": string,
  "editorialChanges": string
}
Alanlar
workflowId

string

İsteğe bağlıdır. Sağlanan ürün verileri için yürütülecek iş akışı. İş akışları, yanıtın başlığını, açıklamasını veya her ikisini de doldurabilir.
tone

string

İsteğe bağlıdır. Oluşturulan metin için istenen çıkış tonu (ör. ciddi, rahat).
editorialChanges

string

İsteğe bağlıdır. Oluşturulan ürün verilerinde yapılan tüm editoryal değişiklikler (ör. Small yerine "S" yazma, renk özelliği varsa değiştirmeme).

TitleExample

Ürün başlığı iyileştirme ile ilgili, uzmanlar tarafından hazırlanmış bir örnek. Bu örnekler, kalitesini artırmak için yapay zekaya sağlanır.

JSON gösterimi 
{
  "productInfo": {
    string: string,
    ...
  },
  "finalProductInfo": {
    string: string,
    ...
  },
  "titleFormat": string,
  "category": string
}
Alanlar
productInfo

map (key: string, value: string)

Zorunlu. Mevcut tüm ürün bilgilerini içeren bir harita. Örneğin: {"title": "dress", "description": "A red dress", "brand": "Dresses4All"} Ürün feed'inizi doldurmak için kullanabileceğiniz tüm bilgiler.

"key": value çiftlerinin listesini içeren bir nesne. Örnek: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
finalProductInfo

map (key: string, value: string)

Zorunlu. productInfo ile aynı biçimde olan ancak tüm iyileştirmeleri içeren bir harita. Örneğin: {"brand": "Dresses4All", "product": "dress", "color": "red", ...} Şimdilik bu özellikleri, son başlıkta görünmesini istediğiniz sırayla girin. Örneğin, yukarıdaki örnek şu şekilde olur: Dresses4All dress | red

"key": value çiftlerinin listesini içeren bir nesne. Örnek: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
titleFormat

string

Zorunlu. Başlığı oluşturan özellikler veya yaklaşık özellikler. Örneğin, "Google GShoe M" başlığının titleFormat'ı "brand | product | size" olabilir.
category

string

Zorunlu. Ürünün kategorisi. Bu sayede yapay zeka, belirli örneklerin diğerlerinden daha alakalı olduğunu anlayabilir.

ProductTextGenerationSuggestion

Bir ürün için oluşturulan metin. Kalite puanı isteğe bağlı olarak eklenebilir.

JSON gösterimi 
{
  "text": string,
  "score": number,
  "changeSummary": string
}
Alanlar
text

string

Oluşturulan metin
score

number

Oluşturmayla ilişkili kalite puanı. Feedgen ekibinin uygulama stillerine göre sezgisel yöntem uygulandı.
changeSummary

string

Yapılan tüm değişikliklerin kısa bir özeti.

ProductTextGenerationMetadata

Metin oluşturmayla ilişkili tüm meta veriler için sarmalayıcı veri türü.

JSON gösterimi 
{
  "metadata": {
    object
  }
}
Alanlar
metadata

object (Struct format)

Meta veri oldukça geniş bir kavramdır. Veriler burada, basit bir K:V ilişkilendirmesinin ötesinde çıktının garantili bir yapısı olmadığını belirtmek için harita olarak modellenmiştir. İlk kullanım alanı, oluşturma işlemlerinde eklenen/kaldırılan/değiştirilen kelimeleri izlemektir.