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.