Method: projects.generateProductTextAttributes

تنشئ هذه الطريقة السمات الناقصة من معلومات المنتج.

طلب HTTP

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

يستخدِم عنوان URL بنية تحويل الترميز gRPC.

مَعلمات المسار

المعلمات
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

اختيارية: إذا كانت القيمة "صحيح"، سيتم تضمين اقتراحات السمات بجميع مستويات الثقة في الردّ. بشكلٍ تلقائي، يتم تضمين الاقتراحات ذات درجة الثقة العالية فقط لجميع السمات.

نص الاستجابة

استجابة لطلب projects.generateProductTextAttributes

إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:

تمثيل JSON 
{
  "suggestions": [
    {
      object (Attribute)
    }
  ]
}
الحقول
suggestions[]

object (Attribute)

اقتراحات سمات المنتجات التي تم إنشاؤها يمكن أن يكون هذا الحقل فارغًا إذا لم يتمكّن النموذج من اقتراح سمات ذات نتائج ثقة كافية. يمكن أن تكون الاقتراحات أيًا من الجنس والفئة العمرية واللون والمقاس استنادًا إلى attributes_to_generate في الطلب.

السمة

سمة منتج مستخدَمة في الطلب والاستجابة

تمثيل JSON 
{
  "key": string,
  "textValue": string,
  "confidenceLevel": enum (ConfidenceLevel)
}
الحقول
key

string

مطلوب. اسم السمة كما يقدّمه التاجر.
textValue

string

اختيارية: تخزِّن هذه السمة القيمة النصية للسمة. يجب ضبط هذه السمة لـ inputAttributes في GenerateProductTextAttributesRequest وللاقتراحات في GenerateProductTextAttributesResponse. يتم في هذه المرحلة استخدام/إنشاء سمات نصية فقط، وبالتالي لا يتم تحديد attribute_type(مثل INT أو RICH_TEXT) وقيم التنسيق الأخرى(مثل float_value أو rich_text_value).
confidenceLevel

enum (ConfidenceLevel)

اختيارية: تتوفّر هذه السمة في الردّ فقط، وستحدّد مستوى الثقة في اقتراح السمة الذي تم إنشاؤه.

ConfidenceLevel

مستوى الثقة في اقتراح السمة الذي أنشأه نموذج الذكاء الاصطناعي يُخرج النموذج درجة ثقة لكل اقتراح ويتم تصنيفه في أحد مستويات الثقة. تم تحديد حدود الثقة لكل مجموعة استنادًا إلى تقييمات أجراها مراجعون لمخرجات النموذج.

عمليات التعداد
CONFIDENCE_LEVEL_UNSPECIFIED مستوى الثقة غير محدّد.
LOW مستوى ثقة منخفض
MEDIUM مستوى ثقة متوسط
HIGH مستوى ثقة عالٍ

ClientRequestContext

تمثّل هذه السمة معلومات عن العميل الذي يقدّم الطلب.

تمثيل JSON 
{
  "partnerProductId": string
}
الحقول
partnerProductId

string

مطلوب. معرّف المنتج الذي يحدّده الشريك.