Method: accounts.lfpSales.insert

يتم إدراج LfpSale للتاجر المحدّد.

طلب HTTP

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

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

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

المعلمات
parent

string

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

نص الطلب

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

نص الاستجابة

عملية بيع للتاجر:

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

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

string

النتائج فقط. المُعرّف. اسم المورد LfpSale. تنسيق الملف: accounts/{account}/lfpSales/{sale}

targetAccount

string (int64 format)

مطلوب. معرّف Merchant Center للتاجر المطلوب إرسال عملية البيع من أجله.

storeCode

string

مطلوب. معرّف متجر التاجر. يجب إدخال storeCode من خلال واجهة برمجة التطبيقات أو رمز المتجر في "الملف التجاري".

offerId

string

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

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

regionCode

string

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

contentLanguage

string

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

gtin

string

مطلوب. الرقم التجاري العالمي للسلعة للمنتج المُباع.

price

object (Price)

مطلوب. سعر الوحدة للمنتج.

quantity

string (int64 format)

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

saleTime

string (Timestamp format)

مطلوب. الطابع الزمني لعملية البيع

uid

string

النتائج فقط. أنشأه النظام معرّفًا فريدًا عالميًا لـ LfpSale.

feedLabel

string

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

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

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

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

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