Method: projects.generateProductText

יצירת קבוצה של השלמות טקסט/תשובות של מועמדים ממידע על מוצרים.

בקשת HTTP

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

כתובת ה-URL משתמשת בתחביר של gRPC Transcoding.

פרמטרים של נתיב

פרמטרים
parent

string

חובה. פרויקט לביצוע שיחה. חובה להפנות לפרויקט של המתקשר. פורמט: projects/{project-id}

גוף הבקשה

גוף הבקשה מכיל נתונים עם המבנה הבא:

ייצוג ב-JSON 
{
  "titleExamples": [
    {
      object (TitleExample)
    }
  ],
  "productInfo": {
    object (ProductInfo)
  },
  "outputSpec": {
    object (OutputSpec)
  }
}
שדות
titleExamples[]

object (TitleExample)

אופציונלי. תספק כמה דוגמאות ייחודיות לשיפורים בכותרות שמתאימות לתרחיש השימוש שלי. ‫TiDe הוא כלי כללי שמטפל בכמה קטגוריות מוצרים, אבל יכול להיות שזהות המותג שלכם תדרוש פונקציונליות מותאמת אישית. אפשר לציין את זה כאן.
productInfo

object (ProductInfo)

חובה. המידע שזמין על המוצר. הנתונים האלה משמשים לשיפור המודלים של AI גנרטיבי.
outputSpec

object (OutputSpec)

אופציונלי. פרמטרים של הגדרה שמשפיעים ישירות על התוכן שנוצר ועל האופן שבו התוכן מוצג בתשובה הסופית.

גוף התשובה

טקסט שנוצר עבור מוצר שצוין.

אם הפעולה מצליחה, גוף התגובה מכיל נתונים במבנה הבא:

ייצוג ב-JSON 
{
  "attributes": {
    string: string,
    ...
  },
  "title": {
    object (ProductTextGenerationSuggestion)
  },
  "description": {
    object (ProductTextGenerationSuggestion)
  },
  "metadata": {
    object (ProductTextGenerationMetadata)
  }
}
שדות
attributes

map (key: string, value: string)

כל מאפיין אחר שנוצר

אובייקט שמכיל רשימה של "key": value זוגות. דוגמה: { "name": "wrench", "mass": "1.3kg", "count": "3" }
title

object (ProductTextGenerationSuggestion)

השם שנוצר.
description

object (ProductTextGenerationSuggestion)

תיאור שנוצר.
metadata

object (ProductTextGenerationMetadata)

מידע נוסף שהלקוחות עשויים לרצות לבדוק לגבי יצירת התוכן.

ProductInfo

המידע שזמין על המוצר. הנתונים האלה משמשים לשיפור המודלים של AI גנרטיבי.

ייצוג ב-JSON 
{
  "productAttributes": {
    string: string,
    ...
  },
  "productImage": {
    object (Image)
  }
}
שדות
productAttributes

map (key: string, value: string)

חובה. מיפוי של כל מאפייני המוצרים הזמינים. הפרטים האלה עשויים לכלול את שם הפריט, התיאור, המותג, המגדר, הצבע, המידה וכו'.

אובייקט שמכיל רשימה של "key": value זוגות. דוגמה: { "name": "wrench", "mass": "1.3kg", "count": "3" }
productImage

object (Image)

אופציונלי. תמונה שמשויכת למוצר.

OutputSpec

פרמטרים של הגדרה שמשפיעים ישירות על התוכן שנוצר ועל האופן שבו התוכן מוצג בתשובה הסופית.

ייצוג ב-JSON 
{
  "workflowId": string,
  "tone": string,
  "editorialChanges": string
}
שדות
workflowId

string

אופציונלי. תהליך העבודה שיבוצע על נתוני המוצרים שסופקו. יכול להיות שתהליכי העבודה ימלאו את הכותרת, התיאור או את שניהם בתשובה.
tone

string

אופציונלי. הסגנון הרצוי של הטקסט שנוצר, למשל רציני או לא רשמי.
editorialChanges

string

אופציונלי. שינויים עריכתיים בנתוני המוצרים שנוצרו. לדוגמה, החלפת המילה Small באות S, לא לשנות את הצבע אם הוא כבר קיים.

TitleExample

דוגמה לשיפור שם מוצר שנעשה באופן ידני. הדוגמאות האלה מסופקות ל-AI כדי לשפר את האיכות שלו.

ייצוג ב-JSON 
{
  "productInfo": {
    string: string,
    ...
  },
  "finalProductInfo": {
    string: string,
    ...
  },
  "titleFormat": string,
  "category": string
}
שדות
productInfo

map (key: string, value: string)

חובה. מפה שמכילה את כל פרטי המוצרים הקיימים. לדוגמה: ‫{"title": "dress", "description": "A red dress", "brand": "Dresses4All"} כל מידע שאולי תשתמשו בו כדי לאכלס את פיד המוצרים.

אובייקט שמכיל רשימה של "key": value זוגות. דוגמה: { "name": "wrench", "mass": "1.3kg", "count": "3" }
finalProductInfo

map (key: string, value: string)

חובה. מיפוי באותו פורמט כמו productInfo אבל עם כל השיפורים. לדוגמה: ‪{"brand": "Dresses4All", "product": "dress", "color": "red", ...} בשלב הזה, צריך לסדר את המאפיינים בסדר שבו רוצים שהם יופיעו בשם הפריט הסופי. לדוגמה, השם שמופיע למעלה יהפוך ל: Dresses4All dress | red

אובייקט שמכיל רשימה של "key": value זוגות. דוגמה: { "name": "wrench", "mass": "1.3kg", "count": "3" }
titleFormat

string

חובה. המאפיינים או המאפיינים המשוערים שמרכיבים את שם הפריט. לדוגמה, שם הפריט 'Google GShoe M' יכול להיות בפורמט 'מותג | מוצר | מידה'.
category

string

חובה. הקטגוריה של המוצר. כך ה-AI מבין מתי דוגמאות מסוימות רלוונטיות יותר מאחרות.

ProductTextGenerationSuggestion

טקסט שנוצר למוצר, כולל ציון האיכות שלו (אופציונלי).

ייצוג ב-JSON 
{
  "text": string,
  "score": number,
  "changeSummary": string
}
שדות
text

string

הטקסט שנוצר
score

number

ציון האיכות שמשויך ליצירה. היוריסטיקה הוטמעה בהתאם לסגנונות ההטמעה של צוות feedgen.
changeSummary

string

סיכום קצר של כל השינויים שבוצעו.

ProductTextGenerationMetadata

סוג נתונים של Wrapper לכל מטא-נתונים שמשויכים ליצירת טקסט.

ייצוג ב-JSON 
{
  "metadata": {
    object
  }
}
שדות
metadata

object (Struct format)

מטא-נתונים הם מושג די רחב. הנתונים ממודלים כאן כמפה כדי לציין שאין מבנה מובטח לפלט מעבר לשיוך פשוט של מפתח:ערך. מקרה השימוש הראשון הוא מעקב אחרי מילים שנוספו, הוסרו או שונו ביצירות.