REST Resource: accounts.lfpSales
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
المرجع: 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 .
|
الطُرق |
|
إدراج LfpSale للتاجر المحدّد |
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2024-11-21 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2024-11-21 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eThe Local Inventory Feed Sale (LfpSale) resource represents a sale for a merchant, allowing them to submit sales data for products.\u003c/p\u003e\n"],["\u003cp\u003eLfpSale data includes product identifiers (offerId, gtin), location and language (regionCode, contentLanguage), pricing and quantity (price, quantity), and sale timing (saleTime).\u003c/p\u003e\n"],["\u003cp\u003eMerchants can use the \u003ccode\u003einsert\u003c/code\u003e method to submit new LfpSale data to their Local Inventory Feed.\u003c/p\u003e\n"],["\u003cp\u003eA unique \u003ccode\u003eLfpSale\u003c/code\u003e identifier (\u003ccode\u003ename\u003c/code\u003e) and a system-generated ID (\u003ccode\u003euid\u003c/code\u003e) are automatically assigned upon insertion.\u003c/p\u003e\n"]]],["The content details the \"LfpSale\" resource, representing a merchant's sale. Key information includes: a sale's `name`, the `targetAccount` (merchant ID), `storeCode`, `offerId` (product identifier), `regionCode`, `contentLanguage`, `gtin` (product number), `price`, sold `quantity`, and `saleTime`. A sale can have a `feedLabel`. The `insert` method allows creating an LfpSale record for a specified merchant. Each sale has a system-generated `uid`.\n"],null,["# REST Resource: accounts.lfpSales\n\n- [Resource: LfpSale](#LfpSale)\n - [JSON representation](#LfpSale.SCHEMA_REPRESENTATION)\n- [Methods](#METHODS_SUMMARY)\n\nResource: LfpSale\n-----------------\n\nA sale for the merchant.\n\n| JSON representation |\n|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"name\": string, \"targetAccount\": string, \"storeCode\": string, \"offerId\": string, \"regionCode\": string, \"contentLanguage\": string, \"gtin\": string, \"price\": { object (/merchant/api/reference/rest/Shared.Types/Price) }, \"quantity\": string, \"saleTime\": string, \"uid\": string, \"feedLabel\": string } ``` |\n\n| Fields ||\n|-------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `name` | `string` Output only. Identifier. The name of the `LfpSale` resource. Format: `accounts/{account}/lfpSales/{sale}` |\n| `targetAccount` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` Required. The Merchant Center ID of the merchant to submit the sale for. |\n| `storeCode` | `string` Required. The identifier of the merchant's store. Either a `storeCode` inserted through the API or the code of the store in the Business Profile. |\n| `offerId` | `string` Required. A unique identifier for the product. If both inventories and sales are submitted for a merchant, this id should match for the same product. **Note**: if the merchant sells the same product new and used, they should have different IDs. |\n| `regionCode` | `string` Required. The [CLDR territory code](https://github.com/unicode-org/cldr/blob/latest/common/main/en.xml) for the country where the product is sold. |\n| `contentLanguage` | `string` Required. The two-letter ISO 639-1 language code for the item. |\n| `gtin` | `string` Required. The Global Trade Item Number of the sold product. |\n| `price` | `object (`[Price](/merchant/api/reference/rest/Shared.Types/Price)`)` Required. The unit price of the product. |\n| `quantity` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` Required. The relative change of the available quantity. Negative for items returned. |\n| `saleTime` | `string (`[Timestamp](https://protobuf.dev/reference/protobuf/google.protobuf/#timestamp)` format)` Required. The timestamp for the sale. |\n| `uid` | `string` Output only. System generated globally unique ID for the `LfpSale`. |\n| `feedLabel` | `string` Optional. The [feed label](https://developers.google.com/shopping-content/guides/products/feed-labels) for the product. If this is not set, it will default to `regionCode`. |\n\n| Methods ------- ||\n|--------------------------------------------------------------------------------|---------------------------------------------|\n| ### [insert](/merchant/api/reference/rest/lfp_v1beta/accounts.lfpSales/insert) | Inserts a `LfpSale` for the given merchant. |"]]