إنشاء اقتراحات نصية

تستفيد Text Suggestions API من أدوات الذكاء الاصطناعي التوليدي في Product Studio API لإنشاء عناوين المنتجات وأوصافها وتحسينها. ويمكنك استخدامها لتحسين تفاعل العملاء ومعدّل الإحالات الناجحة، وتبسيط عملية إدارة معلومات المنتجات وتعديلها. يمكن أن تساعدك ميزات Product Studio API في تحسين أداء منتجاتك في قطاع البيع بالتجزئة.

ما الذي يمكنك إنشاؤه باستخدام واجهة برمجة التطبيقات؟

تساعدك واجهة Text Suggestions API في تنفيذ ما يلي:

  • عناوين وأوصاف مقترَحة للمنتجات استنادًا إلى صورة المنتج و/أو سماته
  • عناوين محسّنة لمنتجاتك وفقًا لمحركات البحث
  • عناوين منتجاتك بتنسيق مخصّص
  • أوصاف المنتجات من خلاصة منتجاتك

يمكنك أيضًا تحديد أسلوب الرسائل للأوصاف والحفاظ على الاتساق في جميع بيانات منتجاتك.

البدء السريع

يمكن أن تنشئ طريقة GenerateProductTextSuggestions عناوين المنتجات وأوصافها أو تحسّنها باستخدام معلومات منتجاتك.

تقبل واجهة برمجة التطبيقات ما يلي:

  • سمات المنتج (قاموس JSON): عنصر JSON يحتوي على سمات المنتج (مثل {"title": "White Tee", "brand": "MyBrand", "size": "XL"})
  • صورة المنتج: معرّف موارد منتظم (URI) يشير إلى صورة المنتج (مثل {"uri": "https://my-store.com/img/1.png"})
  • خيارات تنسيق العناوين: معلَمات لتخصيص إنشاء العناوين، بما في ذلك:
    • ‫attribute_separator: تحدّد هذه السمة الفاصل بين السمات.
    • ‫target_language: لضبط لغة الناتج
    • ‫attribute_order: تحدّد هذه السمة ترتيب السمات في العنوان الذي يتم إنشاؤه.
  • أمثلة على تصنيف البيانات: يمكنك الاطّلاع على مثال على كيفية إنشاء عنوان من وصف.
  • رقم تعريف سير العمل (output_spec.workflow_id): يحدّد الحقل workflow_id ضمن عنصر output_spec نوع إنشاء النص:
    • ‫title: لإنشاء عنوان المنتج أو تحسينه
    • ‫description: لإنشاء وصف المنتج أو تحسينه
    • ‫tide: لإنشاء عنوان المنتج ووصفه أو تحسينهما.

أمثلة

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

إنشاء عناوين محسّنة

يوضّح المثال كيفية إنشاء عنوان مثالي.

طلب

يحتوي نص الطلب على معلومات المنتج التي يجب استخدامها لتحسين العنوان. في ما يلي مثال على بنية الطلب:

POST https://merchantapi.googleapis.com/productstudio/v1alpha/accounts/{ACCOUNT_ID}:generateProductTextSuggestions

{
   "product_info": {
      "product_attributes": {
         "title": "Nike Mens shoes",
         "description": "Give strength to your step with the Nike Air Zoom Pegasus 38 shoe for Men with shoe size 12. Ensuring the fit is loved by the runners. This shoes comes in Blue color.",
         "brand": "Nike"
      }
   },
   "output_spec": {
      "workflow_id": "title"
   }
}

الردّ

يمكنك توقّع ردّ مثل:

{
  "title": {
    "text": "Nike Mens shoes Air Zoom Pegasus 38 Running Shoes, Blue, Size 12"
  },
  "metadata": {
    "metadata": {
      "attributes": {
        "color": "Blue",
        "size": "12",
        "product": "Running shoes",
        "model": "Air Zoom Pegasus 38"
      },
    }
  }
}

إنشاء عنوان من صورة فقط

يوضّح المثال كيفية تقديم صورة منتج وإنشاء عنوان مثالي.

طلب

POST https://merchantapi.googleapis.com/productstudio/v1alpha/accounts/{ACCOUNT_ID}:generateProductTextSuggestions

{
   "product_info": {
      "product_image":{
         "uri": "https://cdn.shopify.com/s/files/1/0653/5879/0892/products/1672082339438_550x825.jpg?v=1672082415"
      }
   },
   "output_spec": {
      "workflow_id": "title",
      "attribute_separator": "-"
   }
}

الردّ

{
  "title": {
    "text": "Rustic Ceramic & Leather Leaves Necklace"
  },
  "metadata": {
    "metadata": {
      "attributes": {
        "material": "Rustic Ceramic & Leather",
        "pattern": "Leaves",
        "product": "Necklace"
      },
    }
  }
}

إنشاء عنوان من وصف

يوضّح المثال كيفية تقديم وصف للمنتج وإنشاء عنوان مثالي.

طلب

POST https://merchantapi.googleapis.com/productstudio/v1alpha/accounts/{ACCOUNT_ID}:generateProductTextSuggestions

{
   "product_info": {
      "product_attributes": {
         "description": "selling size 12 nike dunks. oh they are red by the way!"
      }
   },
   "output_spec": {
      "workflow_id": "title",
   }
}

الردّ

{
  "title": {
    "text": "Nike Dunks Red Size 12"
  },
  "metadata": {
    "metadata": {
      "attributes": {
        "brand": "Nike",
        "color": "Red",
        "size": "12",
        "product": "Dunks"
      },
    }
  }
}

تحسين العناوين من عنوان ووصف (مع مثال مخصّص)

في هذا المثال، نحدّد بوضوح سمات المنتج التي نريد من الذكاء الاصطناعي التعرّف عليها وترتيب السمات في الناتج.

طلب

POST https://merchantapi.googleapis.com/productstudio/v1alpha/accounts/{ACCOUNT_ID}:generateProductTextSuggestions

{
   "product_info": {
      "product_attributes": {
         "title": "Volumizing & Lengthening Mascara - Dark Brown",
         "description": "This high-impact mascara delivers both voluptuous volume and dramatic length without clumping or smudging.",
         "brand": "Luxe Beauty"
      }
   },
   "output_spec": {
      "workflow_id": "title"
   }
   "title_examples": [
    {
      "product_info": {
        "title": "Lash Paradise Volumizing & Lengthening Mascara - Waterproof - Blackest Black",
        "colour": "Black"
      },
      "title_format": "product",
      "category": "mascara",
      "final_product_info": {
        "product": "Mascara",
        "brand": "Lash Paradise",
        "mascara_type": "Volumizing & Lengthening",
        "colour": "Blackest Black",
        "waterproof": "Waterproof",
      }
    },
    {
      "product_info": {
        "title": "Hypnose Drama Instant Full Body Volume Mascara - Black",
        "colour": "Black"
      },
      "title_format": "product",
      "category": "mascara",
      "final_product_info": {
        "product": "Mascara",
        "brand": "Hypnose",
        "sub_brand": "Drama",
        "mascara_type": "Full Body Volume",
        "colour": "Black",
        "eye_lash_type": "All lash types"
      }
    }
  ]
}

الردّ

{
  "title": {
    "text": "Luxe Beauty Dark Brown Volumizing & Lengthening Mascara"
  },
  "metadata": {
    "metadata": {
      "attributes": {
        "brand": "Luxe Beauty",
        "colour": "Dark Brown",
        "mascara_type": "Volumizing & Lengthening",
        "product": "Mascara"
      },
    }
  }
}

إنشاء وصف من عنوان

يوضّح المثال كيفية تقديم عنوان منتج والطلب من واجهة برمجة التطبيقات إنشاء وصف منتج مطابق.

طلب

POST https://merchantapi.googleapis.com/productstudio/v1alpha/accounts/{ACCOUNT_ID}:generateProductTextSuggestions

{
   "product_info": {
      "product_attributes": {
         "title": "Rustic Ceramic & Leather Leaves Necklace",
      }
   },
   "output_spec": {
      "workflow_id": "description"
   }
}

الردّ

{
  "description": {
    "text": "Rustic Ceramic & Leather Leaves Necklace is a beautiful necklace made from high-quality ceramic and leather. It features a unique design that is sure to turn heads.
"
  },
}

إنشاء عنوان ووصف من سمات المنتج (مثل العلامة التجارية واللون)

يوضّح هذا المثال كيفية تقديم سمات المنتج لإنشاء عنوان ووصف مثاليَين للمنتج.

طلب

POST https://merchantapi.googleapis.com/productstudio/v1alpha/accounts/{ACCOUNT_ID}:generateProductTextSuggestions

{
   "product_info": {
      "product_attributes": {
         "brand": "Mr. Beast",
         "color": "purple",
      },
      "product_image":{
         "uri": "https://mrbeast.store/cdn/shop/files/0015dlv_0000_327.jpg?v=1702754475&width=500"
       }
   },
   "output_spec": {
      "workflow_id": "description"
   }
}

الردّ

{
  "title": {
    "text": "Pajamas - Mr. Beast | Purple"
  },
  "description": {
    "text": "Slip into the ultimate comfort and style with these Mr. Beast pajamas in a vibrant shade of purple. Crafted from the softest materials, these pajamas will envelop you in a cozy embrace, ensuring a restful night's sleep. The shorts feature a relaxed fit, allowing for easy movement, while the top boasts a classic design with a comfortable neckline. Whether you're lounging at home or drifting off to dreamland, these Mr. Beast pajamas are the perfect choice for a peaceful and stylish slumber."
  },
}

اللغات الهدف المتاحة

يحدّد هذا الحقل لغة نص الوصف الذي يتم إنشاؤه في الردّ من واجهة برمجة التطبيقات. يمكنك إضافة target_language كجزء من مَعلمات output_spec:

{
    "output_spec": {
        "target_language": "language"
    }
}

أمثلة على القيم:

"korean" (Korean)
"english" (English)
"spanish" (Spanish)
"french" (French)

مثال على الطلب

POST https://merchantapi.googleapis.com/productstudio/v1alpha/accounts/{ACCOUNT_ID}:generateProductTextSuggestions

{
   "product_info": {
      "product_attributes": {
         "title": "Granos de café negro",
         "description": "Los granos de café negro en California",
         "brand": "Parfums de Paris",
         "scent": "Floral",
      },
      "product_image":{
         "uri": "https://mrbeast.store/cdn/shop/files/0015dlv_0000_327.jpg?v=1702754475&width=500"
       }
   },
   "output_spec": {
      "workflow_id": "description",
      "target_language": "japanese",
      "attribute_order": ["scent", "product"],
      "tone": "playful",
   }
}

الردّ

{
  "description": {
    "text": "カリフォルニアの黒いコーヒー豆は、あなたの鼻をくすぐる、甘く、フローラルな香りです。この香りは、コーヒー豆の豊かな香りと、ジャスミンとバラの繊細な花の香りをブレンドしたものです。カリフォルニアの黒いコーヒー豆は、あなたの家を居心地の良いカフェに変え、あなたをリラックスした気分にさせてくれるでしょう。この香りは、コーヒー好きにも、フローラルな香り好きにも最適です。カリフォルニアの黒いコーヒー豆で、あなたの家を幸せな香りで満たしましょう！."
  },
}

تخصيص أسلوب العلامة التجارية لإنشاء الأوصاف

للمساعدة في ترسيخ علامتك التجارية وتمييز متجرك على الإنترنت عن المتاجر الأخرى، يمكنك تخصيص أسلوب صياغة الأوصاف التي يتم إنشاؤها. توفّر Text API خيارَين:

  • اختيار أسلوب محدّد مسبقًا: يمكنك الاختيار من قائمة أساليب لإنشاء أوصاف جديدة. تتضمّن القائمة أساليب النبرة التالية:
    • التلقائي: بسيط وواضح وأنيق.
    • مرح: أسلوب مبهج يستخدم لغة إيجابية وفكاهة (نكات وتلاعب بالكلمات) ومبالغة (بدون سخرية أو تهكّم أو رموز إيموجي).
    • رسمي: لغة إنجليزية عادية، وقواعد نحوية صحيحة، وجمل كاملة، بدون لغة عامية أو اختصارات.
    • مقنعة: منطقية وموجزة وتعتمد على الحجج لإقناع القارئ.
    • أسلوب حواري: لغة ودية وسهلة الفهم ومألوفة.
  • أسلوب الرسائل الخاص بالعلامة التجارية: يمكنك تقديم أوصاف حالية أو مواد عرض نصية أخرى بأسلوب الرسائل الخاص بعلامتك التجارية. سيحلّل نموذج الذكاء الاصطناعي التوليدي أسلوب النص وينشئ "واصفًا لأسلوب الكتابة" وفقًا للجوانب التالية:
    • مستوى اللغة الرسمية (مثل رسمية أو غير رسمية)
    • الإسهاب (مثل، موجز، مطوّل جدًا)
    • الأسلوب (مثل أسلوب مهني أو إعلامي أو إيجابي أو إقناعي)
    • بنية الجملة (مثل "جملة بسيطة مع عدد قليل من أدوات الربط")
    • الكلمات والعبارات الأكثر استخدامًا

مكتبات العملاء

ننصحك باستخدام مكتبات العملاء لإرسال طلباتك. سنشارك مكتبات البرامج معك والتي يمكنك تثبيتها في مشروع Maven.

عيّنات تعليمات برمجية

اختَر طريقة المصادقة، واضبط عينات التعليمات البرمجية هذه باتّباع هذه التعليمات. إليك نموذج يمكنك استخدامه لإنشاء اقتراحات نصية.

جافا

import com.google.api.gax.core.FixedCredentialsProvider;
import com.google.auth.oauth2.GoogleCredentials;
import com.google.shopping.merchant.productstudio.v1alpha.GenerateProductTextSuggestionsRequest;
import com.google.shopping.merchant.productstudio.v1alpha.GenerateProductTextSuggestionsResponse;
import com.google.shopping.merchant.productstudio.v1alpha.OutputSpec;
import com.google.shopping.merchant.productstudio.v1alpha.ProductInfo;
import com.google.shopping.merchant.productstudio.v1alpha.TextSuggestionsServiceClient;
import com.google.shopping.merchant.productstudio.v1alpha.TextSuggestionsServiceSettings;
import shopping.merchant.samples.utils.Authenticator;
import shopping.merchant.samples.utils.Config;

/** This class demonstrates how to generate product text suggestions. */
public class GenerateProductTextSuggestionsSample {

  private static String getName(String accountId) {
    return String.format("accounts/%s", accountId);
  }

  public static void generateProductTextSuggestions(Config config) throws Exception {
    // Obtains OAuth token based on the user's configuration.
    GoogleCredentials credential = new Authenticator().authenticate();

    TextSuggestionsServiceSettings textSuggestionsServiceSettings =
        TextSuggestionsServiceSettings.newBuilder()
            .setCredentialsProvider(FixedCredentialsProvider.create(credential))
            .build();

    String name = getName(config.getAccountId().toString());

    // Calls the API and catches and prints any network failures/errors.
    try (TextSuggestionsServiceClient textSuggestionsServiceClient =
        TextSuggestionsServiceClient.create(textSuggestionsServiceSettings)) {

      ProductInfo productInfo =
          ProductInfo.newBuilder()
              .putProductAttributes("title", "Mens shirt")
              .putProductAttributes("description", "A blue shirt for men in size S")
              .build();

      OutputSpec outputSpec = OutputSpec.newBuilder().setWorkflowId("title").build();

      GenerateProductTextSuggestionsRequest request =
          GenerateProductTextSuggestionsRequest.newBuilder()
              .setName(name)
              .setProductInfo(productInfo)
              .setOutputSpec(outputSpec)
              .build();

      System.out.println("Sending GenerateProductTextSuggestions request: " + name);
      GenerateProductTextSuggestionsResponse response =
          textSuggestionsServiceClient.generateProductTextSuggestions(request);
      System.out.println("Generated product text suggestions response below:");
      System.out.println(response);
    } catch (Exception e) {
      System.out.println("An error has occured: ");
      System.out.println(e);
    }
  }

  public static void main(String[] args) throws Exception {
    Config config = Config.load();
    generateProductTextSuggestions(config);
  }
}

Python

"""A module to generate product text suggestions."""

from examples.authentication import configuration
from examples.authentication import generate_user_credentials
from google.shopping.merchant_productstudio_v1alpha import GenerateProductTextSuggestionsRequest
from google.shopping.merchant_productstudio_v1alpha import OutputSpec
from google.shopping.merchant_productstudio_v1alpha import ProductInfo
from google.shopping.merchant_productstudio_v1alpha import TextSuggestionsServiceClient


# Fetches the Merchant Center account ID from the configuration file.
# This ID is used to construct the 'name' for the API request.
_ACCOUNT_ID = configuration.Configuration().read_merchant_info()
# The parent resource name for the GenerateProductTextSuggestionsRequest.
# Format: "accounts/{account}"
_PARENT_RESOURCE_NAME = f"accounts/{_ACCOUNT_ID}"


def generate_product_text_suggestions_sample():
  """Generates product text suggestions for a given product."""

  # Gets OAuth Credentials.
  credentials = generate_user_credentials.main()

  # Creates a client for the TextSuggestionsService.
  client = TextSuggestionsServiceClient(credentials=credentials)

  # Defines the product information for which suggestions are needed.
  # This includes attributes like title and description.
  product_info = ProductInfo(
      product_attributes={
          "title": "Mens shirt",
          "description": "A blue shirt for men in size S",
      }
  )

  # Defines the output specification.
  # The 'workflow_id' specifies the type of text suggestion, e.g., "title".
  output_spec = OutputSpec(workflow_id="title")

  # Creates the request object for generating product text suggestions.
  # It includes the parent resource name, product information, and output
  # specification.
  request = GenerateProductTextSuggestionsRequest(
      name=_PARENT_RESOURCE_NAME,
      product_info=product_info,
      output_spec=output_spec,
  )

  # Sends the request to the API.
  print(
      f"Sending GenerateProductTextSuggestions request: {_PARENT_RESOURCE_NAME}"
  )
  try:
    response = client.generate_product_text_suggestions(request=request)
    # Prints the generated suggestions.
    print("Generated product text suggestions response below:")
    print(response)
  except RuntimeError as e:
    # Catches and prints any errors that occur during the API call.
    print("An error has occured: ")
    print(e)


if __name__ == "__main__":
  generate_product_text_suggestions_sample()

الأخطاء والمشاكل الشائعة

في ما يلي بعض الأخطاء الشائعة وحلولها.

يجب إدخال معلومات المنتج لإنشاء اقتراحات نصية

إذا ظهرت لك رسالة الخطأ التالية

Error message:
"error": {
    "code": 400,
    "message": "[product_info] Product info is required to generate text suggestions.",
    "status": "INVALID_ARGUMENT",
 ...
}

يُرجى إضافة product_info في نص الطلب وملء سمة واحدة على الأقل من السمتَين product_attributes أو product_image بشكل صحيح.

على سبيل المثال، سيؤدي نشر ما يلي إلى حدوث خطأ.

POST https://merchantapi.googleapis.com/productstudio/v1alpha/accounts/{ACCOUNT_ID}:generateProductTextSuggestions

{
   "output_spec": {
      "workflow_id": "title"
   }
}

يجب ملء حقل واحد على الأقل من product_info لإنشاء اقتراحات نصّ من إنشاء الذكاء الاصطناعي

هذا الخطأ

{
  "error": {
    "code": 400,
    "message": "[product_info.product_attributes] At least one field of product_info is required to generate text suggestions.",
    "status": "INVALID_ARGUMENT",
 ...
}

تشير إلى أنّه عليك تضمين حقل product_info واحد على الأقل في نص الطلب.

على سبيل المثال، سيؤدي نشر هذا إلى حدوث خطأ.

POST https://merchantapi.googleapis.com/productstudio/v1alpha/accounts/{ACCOUNT_ID}:generateProductTextSuggestions

{
   "product_info": {
   },
   "output_spec": {
      "workflow_id": "title"
   }
}

استخدِم بدلاً من ذلك شيئًا مثل

   "product_info": {
        "product_attributes": {
         "description": "Selling size 12 Nike dunks. Oh they are red by the way!"
      }
   }

أو

"product_info": {
    "product_image":{
        "uri": "https://cdn.shopify.com/s/files/1/0653/5879/0892/products/1672082339438_550x825.jpg?v=1672082415"
    }
}

(Something) is required in each title_example

أخطاء مثل الأمثلة الأربعة التالية

{
  "error": {
    "code": 400,
    "message": "[title_examples.product_info] At least one field of product_info is required in each title_example.",
    "status": "INVALID_ARGUMENT",
 ...
}

أو

{
  ...
    "message": "[title_examples.category] Category is required in each title_example.",
  ...
}

أو

{
  ...
    "message": "[title_examples.title_format] Title format is required in each title_example.",
  ...
}

أو

{
  ...
    "message": "[title_examples.final_product_info] At least one field of final_product_info is required in each title_example.",
  ...
}

تشير إلى أنّك لم تملأ حقلاً فرعيًا مطلوبًا.

على سبيل المثال، سيؤدي الطلب التالي إلى ظهور خطأ.

POST https://merchantapi.googleapis.com/productstudio/v1alpha/accounts/{ACCOUNT_ID}:generateProductTextSuggestions

{
    "product_info": {
        "product_attributes": {
            "description": "selling size 12 nike dunks. oh they are red by the way!"
        }
    },
    "output_spec": {
        "workflow_id": "title"
    },
    "title_examples": []
}

لحلّ هذه المشكلة، يجب ملء جميع الحقول الفرعية التالية لكل title_example محدّد في الطلب:

  • product_info
  • category
  • title_format
  • final_product_info

إليك مثال على ذلك:

{
   "product_info": {
      "product_attributes": {
         "title": "Volumizing & Lengthening Mascara - Dark Brown",
         "description": "This high-impact mascara delivers both voluptuous volume and dramatic length without clumping or smudging.",
      }
   },
   "output_spec": {
      "workflow_id": "title"
   },
   "title_examples": [
    {
      "product_info": {
        "title": "Lash Paradise Volumizing & Lengthening Mascara - Waterproof - Blackest Black",
        "colour": "Black"
      },
      "title_format": "product",
      "category": "mascara",
      "final_product_info": {
        "product": "Mascara",
        "brand": "Lash Paradise",
        "mascara_type": "Volumizing & Lengthening",
        "colour": "Blackest Black",
        "waterproof": "Waterproof",
      }
    }
  ]
}

‫workflow_id غير متوافق

هذا النوع من الأخطاء

{
  "error": {
    "code": 400,
    "message": "[\u003ceye3 title='/ProductStudioTextGenerationService.GenerateProductText, INVALID_ARGUMENT'/\u003e APPLICATION_ERROR; ... ;Unsupported workflow_id: attributes. Supported workflows are: [\"title\", \"description\", \"tide\"];AppErrorCode=3;StartTimeMs=1740696804045;unknown;ResFormat=uncompressed;ServerTimeSec=0.005976589;LogBytes=256;Non-FailFast;EffSecLevel=none;ReqFormat=uncompressed;ReqID=4d1786f59faa3ea7;GlobalID=0;Server=[2002:a05:6e16:618:b0:2c2:7cfc:bebd]:14001] Invalid value",
    "status": "INVALID_ARGUMENT",
 ...
}

ستنتج عن طلب مثل

POST https://merchantapi.googleapis.com/productstudio/v1alpha/accounts/{ACCOUNT_ID}:generateProductTextSuggestions

{
   "product_info": {
      "product_attributes": {
         "title": "Volumizing & Lengthening Mascara - Dark Brown",
         "description": "This high-impact mascara delivers both voluptuous volume and dramatic length without clumping or smudging.",
   },
   "output_spec": {
      "workflow_id": "attributes"
   }
}

يضبط الطلب workflow_id على "attributes"، ولكن هذا الحقل يتيح استخدام قيمة واحدة فقط من القيم التالية:

  • العنوان: لإنشاء عنوان المنتج أو تحسينه.
  • description: لإنشاء وصف المنتج أو تحسينه
  • tide: لإنشاء عنوان المنتج ووصفه أو تحسينهما

النبرة غير متوافقة

خطأ "نبرة غير متوافقة"، مثل:

{
  "error": {
    "code": 400,
    "message": "[\u003ceye3 title='/ProductStudioTextGenerationService.GenerateProductText, INVALID_ARGUMENT'/\u003e APPLICATION_ERROR; ... ; Unsupported tone: 'asdf'. Supported tones are: [\"default\", \"playful\", \"formal\", \"persuasive\", \"conversational\"];AppErrorCode=3;StartTimeMs=1740697325058;unknown;ResFormat=uncompressed;ServerTimeSec=7.45346E-4;LogBytes=256;Non-FailFast;EffSecLevel=none;ReqFormat=uncompressed;ReqID=f7d9bbbc73a1d342;GlobalID=0;Server=[2002:a05:6918:3486:b0:2bc:ccd4:79e6]:14001] Invalid value",
    "status": "INVALID_ARGUMENT",
 ...
}

ستنتج عن طلب مثل

POST https://merchantapi.googleapis.com/productstudio/v1alpha/accounts/{ACCOUNT_ID}:generateProductTextSuggestions

{
   "product_info": {
      "product_attributes": {
         "title": "Volumizing & Lengthening Mascara - Dark Brown",
         "description": "This high-impact mascara delivers both voluptuous volume and dramatic length without clumping or smudging.",
   },
   "output_spec": {
      "workflow_id": "description"
      "tone": "cheerful"
   }
}

يُرجى العِلم أنّه تم ضبط السمة tone على "cheerful"، ولكن هذا الحقل لا يتيح سوى إحدى القيم التالية:

  • default: بسيطة وواضحة وأنيقة.
  • مرحة: مرحة، تستخدم لغة إيجابية، وفكاهة (نكات، تلاعب بالكلمات)، و مبالغة (بدون سخرية أو تهكّم أو رموز تعبيرية).
  • رسمي: لغة إنجليزية عادية، وقواعد نحوية صحيحة، وجمل كاملة، بدون لغة عامية أو اختصارات.
  • مقنعة: منطقية وموجزة وقائمة على الحجج لإقناع القارئ.
  • أسلوب حواري: لغة ودية وسهلة الفهم ومألوفة.