REST Resource: accounts.productInputs

المورد: ProductInput

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

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

السمات التالية مطلوبة: feedLabel وcontentLanguage وofferId.

بعد إدخال بيانات منتج أو تعديلها أو حذفها، قد يستغرق استرجاع المنتج الذي تمت معالجته عدة دقائق.

تتطابق جميع الحقول في إدخال المنتج ورسائله الفرعية مع الاسم الإنجليزي لسمته المقابلة في مواصفات المجال، مع بعض الاستثناءات.

تمثيل JSON 
{
  "name": string,
  "product": string,
  "channel": enum (ChannelEnum),
  "offerId": string,
  "contentLanguage": string,
  "feedLabel": string,
  "attributes": {
    object (Attributes)
  },
  "customAttributes": [
    {
      object (CustomAttribute)
    }
  ],
  "versionNumber": string
}
الحقول
name

string

المعرّف اسم إدخال المنتج. التنسيق: "{productinput.name=accounts/{account}/productInputs/{productinput}}" حيث يتألّف القسم الأخير productinput من 4 أجزاء: channel~contentLanguage~feedLabel~offerId، على سبيل المثال، اسم إدخال المنتج هو "accounts/123/productInputs/online~en~US~sku123".
product

string

النتائج فقط. اسم المنتج الذي تمّت معالجته التنسيق: "{product.name=accounts/{account}/products/{product}}"
channel

enum (ChannelEnum)

مطلوب. غير قابل للتغيير القناة التي ينتمي إليها المنتج
offerId

string

مطلوب. غير قابل للتغيير المعرّف الفريد للمنتج وينطبق ذلك أيضًا على إدخال المنتج والمنتج الذي تمت معالجته. تتم إزالة المسافات البيضاء البادئة واللاحقة، ويتم استبدال المسافات البيضاء المتعددة بمسافة بيضاء واحدة عند الإرسال. اطّلِع على مواصفات بيانات المنتجات للاطّلاع على التفاصيل.
contentLanguage

string

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

string

مطلوب. غير قابل للتغيير تصنيف الخلاصة للمنتج.
attributes

object (Attributes)

اختيارية: قائمة بسمات المنتجات
customAttributes[]

object (CustomAttribute)

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

string (int64 format)

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

في حال ضبطها، يتم منع الإدراج عندما يكون رقم الإصدار أقل من رقم الإصدار الحالي للمنتج الحالي. يمكن إجراء إعادة الإدراج (على سبيل المثال، إعادة عرض المنتج بعد 30 يومًا) باستخدام versionNumber الحالية.

لا يمكن استخدامها إلا للإدراج في مصادر البيانات الأساسية.

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

الطُرق

delete

 يؤدي هذا الإجراء إلى حذف إدخال منتج من حسابك على Merchant Center.

insert

 لتحميل إدخال منتج إلى حسابك على Merchant Center