Method: accounts.lfpInventories.insert

تدرِج مورد LfpInventory لحساب التاجر المستهدَف المحدّد. إذا كان المورد موجودًا من قبل، فسيتم استبداله. تنتهي صلاحية المستودع تلقائيًا بعد 30 يومًا.

طلب HTTP

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

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

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

المعلمات
parent

string

مطلوب. حساب مقدّم خدمة LFP تنسيق الملف: accounts/{account}

نص الطلب

يحتوي نص الطلب على مثال LfpInventory.

نص الاستجابة

المنتجات المتوفّرة داخل المتجر للتاجر

إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:

تمثيل JSON
{
  "name": string,
  "targetAccount": string,
  "storeCode": string,
  "offerId": string,
  "regionCode": string,
  "contentLanguage": string,
  "price": {
    object (Price)
  },
  "availability": string,
  "collectionTime": string,
  "gtin": string,
  "quantity": string,
  "pickupMethod": string,
  "pickupSla": string,
  "feedLabel": string
}
الحقول
name

string

النتائج فقط. المُعرّف. اسم المورد LfpInventory تنسيق الملف: accounts/{account}/lfpInventories/{target_merchant}~{storeCode}~{offer}

targetAccount

string (int64 format)

مطلوب. معرّف Merchant Center للتاجر المطلوب إرسال المستودع له.

storeCode

string

مطلوب. معرّف متجر التاجر. إمّا رمز المتجر المُدرَج من خلال InsertLfpStore أو رمز المتجر في الملف التجاري

offerId

string

مطلوب. غير قابل للتغيير. معرّف فريد للمنتج إذا تم إرسال كلّ من المستودعات والمبيعات لتاجر، يجب أن يتطابق هذا المعرّف مع المنتج نفسه.

ملاحظة: إذا كان التاجر يبيع المنتج نفسه جديدًا ومستعمَلاً، يجب أن يكون له معرّف مختلف في كل حالة.

regionCode

string

مطلوب. رمز CLDR للمنطقة للبلد الذي يتم بيع المنتج فيه.

contentLanguage

string

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

price

object (Price)

اختياريّ. السعر الحالي للمنتج.

availability

string

مطلوب. مدى توفّر المنتج في هذا المتجر للاطّلاع على قيم السمات المقبولة، يُرجى مراجعة مواصفات بيانات مستودع المنتجات داخل المتجر.

collectionTime

string (Timestamp format)

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

gtin

string

اختياريّ. تمثّل هذه السمة الرقم التجاري العالمي للسلعة للمنتج.

quantity

string (int64 format)

اختياريّ. كمية المنتج المتوفّرة في هذا المتجر يجب أن تكون القيمة أكبر من أو تساوي صفرًا.

pickupMethod

string

اختياريّ. طريقة الاستلام المتوافقة في هذا العرض ويجب إرسال هذا الحقل مع pickupSla ما لم تكن القيمة "غير متاح". للاطّلاع على قيم السمات المقبولة، يُرجى الاطّلاع على مواصفات بيانات مستودع المنتجات داخل المتجر.

pickupSla

string

اختياريّ. التاريخ المتوقّع الذي سيكون فيه الطلب جاهزًا للاستلام حسب تاريخ الطلب يجب إرسالها مع pickupMethod. للاطّلاع على قيم السمات المقبولة، يُرجى الاطّلاع على مواصفات بيانات مستودع المنتجات داخل المتجر.

feedLabel

string

اختياريّ. تصنيف الخلاصة للمنتج. وفي حال ترك هذه السياسة بدون ضبط، سيتم ضبط القيمة التلقائية على regionCode.

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

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

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

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