CssProductInput

يمثّل هذا المرجع بيانات الإدخال التي ترسلها لمنتج CSS، وليس منتج CSS الذي تمت معالجته والذي يظهر لك في CSS Center أو في إعلانات Shopping أو على مساحات العرض في Google.

تمثيل JSON
{
  "name": string,
  "finalName": string,
  "rawProvidedId": string,
  "contentLanguage": string,
  "feedLabel": string,
  "freshnessTime": string,
  "attributes": {
    object (Attributes)
  },
  "customAttributes": [
    {
      object (CustomAttribute)
    }
  ]
}
الحقول
name

string

المعرّف اسم إدخال المنتج في CSS التنسيق: accounts/{account}/cssProductInputs/{cssProductInput}، حيث يتألّف القسم الأخير cssProductInput من 3 أجزاء: contentLanguage~feedLabel~offerId. مثال: accounts/123/cssProductInputs/de~DE~rawProvidedId123

finalName

string

النتائج فقط. اسم منتج CSS الذي تمت معالجته التنسيق: accounts/{account}/cssProducts/{css_product} "

rawProvidedId

string

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

contentLanguage

string

مطلوب. رمز اللغة المكوَّن من حرفَين وفقًا لمعيار ISO 639-1 لمنتج CSS

feedLabel

string

مطلوب. تصنيف الخلاصة لمنتج CSS يُعدّ تصنيف الخلاصة مرادفًا لـ "البلد المستهدَف"، وبالتالي يجب أن يكون دائمًا رمز منطقة صالحًا. على سبيل المثال: "DE" لألمانيا و"FR" لفرنسا.

freshnessTime
(deprecated)

string (Timestamp format)

متوقف استخدِم expirationDate بدلاً من ذلك. يمثّل الإصدار الحالي (الحداثة) لمنتج CSS، والذي يمكن استخدامه للحفاظ على الترتيب الصحيح عند إجراء عدّة تعديلات في الوقت نفسه.

يجب عدم ضبط هذا الحقل على وقت في المستقبل.

في حال ضبط هذا الخيار، يتم منع التحديث إذا كان هناك إصدار أحدث من المنتج في نظامنا (أي أنّ وقت آخر تعديل للمنتجات الحالية في CSS كان بعد وقت التحديث المحدّد في التحديث). وفي حال حدوث التحديث، يتم ضبط وقت آخر تحديث على وقت التحديث هذا.

في حال عدم ضبط هذا الإعداد، لن يتم منع التعديل، وسيتم ضبط وقت التعديل الأخير تلقائيًا على وقت استلام CSS API لهذا الطلب.

في حال منع العملية، سيتم طرح استثناء تم إلغاؤه.

attributes

object (Attributes)

قائمة بسمات المنتجات في CSS

customAttributes[]

object (CustomAttribute)

قائمة بالسمات المخصّصة (التي يوفّرها CSS) ويمكن استخدامه أيضًا لإرسال أي سمة من مواصفات الخلاصة بصورتها العامة (على سبيل المثال: { "name": "size type", "value": "regular" }). ويُعدّ ذلك مفيدًا لإرسال السمات التي لا تعرضها واجهة برمجة التطبيقات بشكل صريح، مثل السمات الإضافية المستخدَمة في ميزة "الشراء على Google".