Method: projects.generateProductText

تنشئ هذه الدالة مجموعة من النصوص المقترَحة/الردود المقترَحة من معلومات المنتج.

طلب HTTP

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

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

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

المعلمات
parent

string

مطلوب. عرض الشاشة لإجراء مكالمة يجب أن يشير إلى مشروع المتصل. التنسيق: projects/{project-id}

نص الطلب

يحتوي نص الطلب على بيانات بالبنية التالية:

تمثيل JSON 
{
  "titleExamples": [
    {
      object (TitleExample)
    }
  ],
  "productInfo": {
    object (ProductInfo)
  },
  "outputSpec": {
    object (OutputSpec)
  }
}
الحقول
titleExamples[]

object (TitleExample)

اختيارية: قدِّم بعض الأمثلة المصمَّمة يدويًا لتحسين العناوين والتي تكون فريدة لحالة الاستخدام الخاصة بك. ‫TiDe هي أداة عامة تتعامل مع فئات منتجات متعددة، ولكن قد تتطلّب هوية علامتك التجارية وظائف مخصّصة. يمكنك تحديد ذلك هنا.
productInfo

object (ProductInfo)

مطلوب. المعلومات المتاحة حول المنتج تُستخدَم هذه البيانات لإبلاغ نماذج الذكاء الاصطناعي التوليدي.
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

المعلومات المتاحة حول المنتج تُستخدَم هذه البيانات لإبلاغ نماذج الذكاء الاصطناعي التوليدي.

تمثيل 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

اختيارية: أي تغييرات تحريرية على بيانات المنتج التي تم إنشاؤها، مثل استبدال "صغير" بالحرف "S"، وعدم تعديل اللون إذا كان متوفّرًا

TitleExample

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

تمثيل 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"، يمكن أن يكون titleFormat هو "العلامة التجارية | المنتج | المقاس".
category

string

مطلوب. فئة المنتج يساعد ذلك الذكاء الاصطناعي في تحديد الحالات التي تكون فيها بعض الأمثلة أكثر صلةً من غيرها.

ProductTextGenerationSuggestion

نص تم إنشاؤه لمنتج، ويمكن أن يتضمّن نقاط الجودة.

تمثيل JSON 
{
  "text": string,
  "score": number,
  "changeSummary": string
}
الحقول
text

string

النص الذي تم إنشاؤه
score

number

تشير إلى نقاط الجودة المرتبطة بالإنشاء. تم تنفيذ التجربة الاسترشادية وفقًا لأساليب التنفيذ التي يتبعها فريق feedgen.
changeSummary

string

تمثّل هذه السمة ملخّصًا موجزًا لجميع التغييرات التي تم إجراؤها.

ProductTextGenerationMetadata

نوع بيانات حاوية لأي بيانات وصفية مرتبطة بإنشاء النصوص

تمثيل JSON 
{
  "metadata": {
    object
  }
}
الحقول
metadata

object (Struct format)

بيانات التعريف هي مفهوم فضفاض إلى حدّ ما. يتم تصميم البيانات كخريطة هنا للإشارة إلى أنّه لا يوجد هيكل مضمون للإخراج بعد ربط بسيط بين المفتاح والقيمة. تتمثّل حالة الاستخدام الأولى في تتبُّع الكلمات التي تمت إضافتها أو إزالتها أو تغييرها في النصوص التي تم إنشاؤها.