تحمّل إدخال منتج إلى حسابك على Merchant Center. في حال توفُّر مُدخل يتضمّن contentLanguage وOfferId وdataSource نفسهما، ستحلّ هذه الطريقة محلّ هذا الإدخال.
بعد إدخال منتج أو تعديله أو حذفه، قد يستغرق استرداد المنتج الذي تمت معالجته عدة دقائق.
طلب HTTP
POST https://merchantapi.googleapis.com/products/v1beta/{parent=accounts/*}/productInputs:insert
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
مَعلمات المسار
المعلمات | |
---|---|
parent |
مطلوب. تمثّل هذه السمة الحساب الذي سيتم إدراج هذا المنتج فيه. التنسيق: accounts/{account} |
معامِلات طلب البحث
المعلمات | |
---|---|
dataSource |
مطلوب. اسم مصدر بيانات المنتجات الأساسي أو التكميلي إذا كان المنتج متوفّرًا من قبل وكان مصدر البيانات المقدَّم مختلفًا، سيتم نقل المنتج إلى مصدر بيانات جديد. التنسيق: |
نص الطلب
يحتوي نص الطلب على مثال ProductInput
.
نص الاستجابة
يمثّل هذا المرجع بيانات الإدخال التي ترسلها لأحد المنتجات، ولا يمثّل المنتج الذي تمت معالجته الظاهر في Merchant Center أو في إعلانات Shopping أو على مساحات عرض Google. ويتم دمج إدخالات المنتجات وقواعدها وبيانات مصادر البيانات التكميلية لإنشاء [product][google.shopping.content.bundles.Products.Product] الذي تمت معالجته.
إنّ السمات المطلوبة لإدخال المنتج لاجتياز عمليات التحقّق من صحة البيانات يتم تحديدها بشكل أساسي في مواصفات بيانات المنتجات.
يجب تضمين السمات التالية: [feedLabel][google.shopping.content.bundles.Products.feed_label] و[contentLanguage][google.shopping.content.bundles.Products.content_language] و[offerId][google.shopping.content.bundles.Products.offer_id].
بعد إدخال منتج أو تعديله أو حذفه، قد يستغرق استرداد المنتج الذي تمت معالجته عدة دقائق.
تتطابق جميع الحقول في إدخال المنتج ورسائله الفرعية مع الاسم باللغة الإنجليزية للسمة المقابلة في مواصفات العمود مع بعض الاستثناءات.
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
تمثيل JSON |
---|
{ "name": string, "product": string, "channel": enum ( |
الحقول | |
---|---|
name |
المُعرّف. اسم المنتج الذي تم إدخاله. تنسيق الملف: |
product |
النتائج فقط. تمثّل هذه السمة اسم المنتج الذي تمت معالجته. تنسيق الملف: |
channel |
مطلوب. غير قابل للتغيير. قناة المنتج. |
offerId |
مطلوب. غير قابل للتغيير. معرّف فريد للمنتج ينطبق ذلك أيضًا على المنتجات التي تم إدخالها والمنتج الذي تمت معالجته. تتم إزالة المسافات البيضاء البادئة واللاحقة ويتم استبدال المسافات البيضاء المتعددة بمسافة بيضاء واحدة عند الإرسال. لمزيد من التفاصيل، يمكنك الاطّلاع على مواصفات بيانات المنتجات. |
contentLanguage |
مطلوب. غير قابل للتغيير. تمثّل هذه السمة رمز اللغة ISO 639-1 المكوّن من حرفَين للمنتج. |
feedLabel |
مطلوب. غير قابل للتغيير. تصنيف الخلاصة للمنتج. |
attributes |
اختياريّ. قائمة بسمات المنتج |
customAttributes[] |
اختياريّ. قائمة بالسمات المخصّصة (المقدّمة من التاجر). ويمكن استخدامها أيضًا لإرسال أي سمة لمواصفات البيانات بشكلها العام (على سبيل المثال، |
versionNumber |
اختياريّ. تُمثِّل هذه السمة الإصدار الحالي (حداثة) المنتج، والذي يمكن استخدامه للحفاظ على الترتيب الصحيح عند إجراء عدة تعديلات في الوقت نفسه. وفي حال ضبطها، يتم منع الإدراج عندما يكون رقم الإصدار أقل من رقم الإصدار الحالي للمنتج الحالي. يمكن إعادة الإدراج (مثلاً، إعادة تحميل المنتج بعد 30 يومًا) باستخدام لا يتاح إلا للإدراج في مصادر البيانات الأساسية. في حال منع العملية، سيتم طرح استثناء تم إلغاؤه. |
نطاقات الأذونات
يجب توفير نطاق OAuth التالي:
https://www.googleapis.com/auth/content
لمزيد من المعلومات، يُرجى الاطِّلاع على نظرة عامة على OAuth 2.0.