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
僅供輸出。ID。LfpSale 資源的名稱。格式:accounts/{account}/lfpSales/{sale}
|
targetAccount |
string (int64 format)
必要欄位。要提交銷售資料的商家 Merchant Center ID。
|
storeCode |
string
必要欄位。商家商店的 ID。透過 API 插入的 storeCode ,或是商家檔案中商店的代碼。
|
offerId |
string
必要欄位。產品的專屬 ID。如果商家同時提交商品目錄和銷售資料,則這項 ID 應與相同產品相符。 注意:如果商家販售同款的全新產品和二手產品,則兩者的 ID 不得相同。
|
regionCode |
string
必要欄位。產品銷售國家/地區的 CLDR 區域代碼。
|
contentLanguage |
string
必要欄位。商品的雙字母格式 ISO 639-1 語言編碼。
|
gtin |
string
必要欄位。售出產品的全球交易品項識別碼。
|
price |
object (Price )
必要欄位。產品的單價。
|
quantity |
string (int64 format)
必要欄位。可用數量的相對變化。如果是退回的商品,則為負值。
|
saleTime |
string (Timestamp format)
必要欄位。銷售時間戳記。
|
uid |
string
僅供輸出。系統為 LfpSale 產生的全球唯一 ID。
|
feedLabel |
string
選用設定。產品的動態饋給標籤。如果未設定,則預設為 regionCode 。
|
除非另有註明,否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權,程式碼範例則為阿帕契 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. |"]]