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 ID。
|
storeCode |
string
必需。商家商店的标识符。通过 API 插入的 storeCode ,或商家资料中商店的代码。
|
offerId |
string
必需。商品的唯一标识符。如果为某个商家提交了商品目录和销售信息,则同一商品的此 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
可选。商品的 Feed 标签。如果未设置此值,则默认为 regionCode 。
|
如未另行说明,那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可,并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情,请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2024-11-21。
[null,null,["最后更新时间 (UTC):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. |"]]