Method: projects.generateProductTextAttributes

יוצר מאפיינים חסרים מפרטי המוצר.

בקשת HTTP

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

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

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

פרמטרים
parent

string

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

גוף הבקשה

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

ייצוג ב-JSON 
{
  "inputAttributes": [
    {
      object (Attribute)
    }
  ],
  "generativeAttributes": [
    {
      object (Attribute)
    }
  ],
  "offerImage": {
    object (Image)
  },
  "clientRequestContext": {
    object (ClientRequestContext)
  },
  "allowAnyConfidenceSuggestions": boolean
}
שדות
inputAttributes[]

object (Attribute)

אופציונלי. מאפייני הקלט ששימשו ליצירת ההצעות. הערכים הנתמכים הם: שם הפריט [title], תיאור [description]. המאפיינים האלה לא ייכללו בתגובה ולא ישתנו.
generativeAttributes[]

object (Attribute)

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

object (Image)

חובה. תמונה שמשויכת למוצר.
clientRequestContext

object (ClientRequestContext)

חובה. מידע על הלקוח ששולח את הבקשה.
allowAnyConfidenceSuggestions

boolean

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

גוף התשובה

תגובה ל-projects.generateProductTextAttributes.

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

ייצוג ב-JSON 
{
  "suggestions": [
    {
      object (Attribute)
    }
  ]
}
שדות
suggestions[]

object (Attribute)

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

מאפיין

מאפיין מוצר שמשמש בבקשה ובתגובה.

ייצוג ב-JSON 
{
  "key": string,
  "textValue": string,
  "confidenceLevel": enum (ConfidenceLevel)
}
שדות
key

string

חובה. שם המאפיין כפי שסופק על ידי המוכר.
textValue

string

אופציונלי. מאחסנת את ערך הטקסט של המאפיין. צריך להגדיר את המאפיין הזה ב-inputAttributes ב-GenerateProductTextAttributesRequest וב-suggestions ב-GenerateProductTextAttributesResponse. בשלב הזה נעשה שימוש רק במאפייני טקסט או שהם נוצרים, ולכן לא מוגדרים attribute_type(למשל: INT, ‏ RICH_TEXT) וערכי פורמט אחרים(למשל: float_value, ‏ rich_text_value).
confidenceLevel

enum (ConfidenceLevel)

אופציונלי. המאפיין הזה מופיע רק בתשובה, והוא קובע את רמת הסמך של הצעת המאפיין שנוצרה.

ConfidenceLevel

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

טיפוסים בני מנייה (enum)
CONFIDENCE_LEVEL_UNSPECIFIED רמת סמך לא מוגדרת.
LOW רמת סמך נמוכה.
MEDIUM רמת סמך בינונית.
HIGH רמת מהימנות גבוהה.

ClientRequestContext

מידע על הלקוח ששולח את הבקשה.

ייצוג ב-JSON 
{
  "partnerProductId": string
}
שדות
partnerProductId

string

חובה. מזהה המוצר שהוגדר על ידי השותף.