تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

Method: accounts.productInputs.insert

طلب HTTP
مَعلمات المسار
معامِلات طلب البحث
نص الطلب
نص الاستجابة
- تمثيل JSON
نطاقات التفويض

تحمّل إدخال منتج إلى حسابك على Merchant Center. في حال توفُّر مُدخل يتضمّن contentLanguage و offerId وdataSource نفسهما، ستحلّ هذه الطريقة محلّ هذا الإدخال.

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

طلب HTTP

POST https://merchantapi.googleapis.com/products/v1beta/{parent=accounts/*}/productInputs:insert

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

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

المعلمات

المعلمات
`parent`	`string` مطلوبة. تمثّل هذه السمة الحساب الذي سيتم إدراج هذا المنتج فيه. التنسيق: accounts/{account}

parent

string

مطلوبة. تمثّل هذه السمة الحساب الذي سيتم إدراج هذا المنتج فيه. التنسيق: accounts/{account}

معلمات طلب البحث

المعلمات

المعلمات
`dataSource`	`string` مطلوبة. اسم مصدر بيانات المنتجات الأساسي أو التكميلي إذا كان المنتج متوفّرًا من قبل وكان مصدر البيانات المقدَّم مختلفًا، سيتم نقل المنتج إلى مصدر بيانات جديد. التنسيق: `accounts/{account}/dataSources/{datasource}`

dataSource

string

مطلوبة. اسم مصدر بيانات المنتجات الأساسي أو التكميلي إذا كان المنتج متوفّرًا من قبل وكان مصدر البيانات المقدَّم مختلفًا، سيتم نقل المنتج إلى مصدر بيانات جديد. التنسيق: accounts/{account}/dataSources/{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

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

{
  "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}}"`
`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 (يمثل مجموع الأحرف للاسم والقيمة). يمكن ضبط 2, 500 سمة مخصّصة كحدّ أقصى لكل منتج، ويبلغ إجمالي حجمها 102.4 كيلوبايت. يتم استبدال الشُرط السفلية في أسماء السمات المخصّصة بمسافات عند الإدراج.
`versionNumber`	`string (int64 format)` اختياريّ. تُمثِّل هذه السمة الإصدار الحالي (حداثة) المنتج، والذي يمكن استخدامه للحفاظ على الترتيب الصحيح عند إجراء عدة تعديلات في الوقت نفسه. وفي حال ضبطها، يتم منع الإدراج عندما يكون رقم الإصدار أقل من رقم الإصدار الحالي للمنتج الحالي. يمكن إعادة الإدراج (مثلاً، إعادة تحميل المنتج بعد 30 يومًا) باستخدام `versionNumber` الحالي. لا يتاح إلا للإدراج في مصادر البيانات الأساسية. في حال منع العملية، سيتم طرح استثناء تم إلغاؤه.

نطاقات الأذونات

يجب توفير نطاق OAuth التالي:

https://www.googleapis.com/auth/content

لمزيد من المعلومات، يُرجى الاطِّلاع على نظرة عامة على OAuth 2.0.