Package google.shopping.merchant.lfp.v1beta

索引

• LfpInventoryService（界面）
• LfpSaleService（界面）
• LfpStoreService（界面）
• DeleteLfpStoreRequest（消息）
• GetLfpStoreRequest（消息）
• InsertLfpInventoryRequest（消息）
• InsertLfpSaleRequest（消息）
• InsertLfpStoreRequest（消息）
• LfpInventory（消息）
• LfpSale（消息）
• LfpStore（消息）
• LfpStore.StoreMatchingState（枚举）
• ListLfpStoresRequest（消息）
• ListLfpStoresResponse（消息）

LfpInventoryService

一项服务，可让 LFP 合作伙伴为商家提交本地商品目录。

InsertLfpInventory
rpc InsertLfpInventory(InsertLfpInventoryRequest) returns (LfpInventory) 插入指定目标商家帐号的 LfpInventory 资源。如果资源已存在，则会被替换。广告资源会在 30 天后自动过期。 授权范围 需要以下 OAuth 作用域： https://www.googleapis.com/auth/content 有关详情，请参阅 OAuth 2.0 概览。

LfpSaleService

一项服务，供 LFP 合作伙伴为商家提交销售数据。

InsertLfpSale
rpc InsertLfpSale(InsertLfpSaleRequest) returns (LfpSale) 针对指定商家插入 LfpSale。 授权范围 需要以下 OAuth 作用域： https://www.googleapis.com/auth/content 有关详情，请参阅 OAuth 2.0 概览。

LfpStoreService

一项 LFP 合作伙伴提供的服务，用于为商家提交本地商店信息。

DeleteLfpStore
rpc DeleteLfpStore(DeleteLfpStoreRequest) returns (Empty) 删除目标商家的商店。 授权范围 需要以下 OAuth 作用域： https://www.googleapis.com/auth/content 有关详情，请参阅 OAuth 2.0 概览。

GetLfpStore
rpc GetLfpStore(GetLfpStoreRequest) returns (LfpStore) 检索有关存储区的信息。 授权范围 需要以下 OAuth 作用域： https://www.googleapis.com/auth/content 有关详情，请参阅 OAuth 2.0 概览。

InsertLfpStore
rpc InsertLfpStore(InsertLfpStoreRequest) returns (LfpStore) 插入目标商家的商店。如果具有相同商店代码的商店已存在，则将被替换。 授权范围 需要以下 OAuth 作用域： https://www.googleapis.com/auth/content 有关详情，请参阅 OAuth 2.0 概览。

ListLfpStores
rpc ListLfpStores(ListLfpStoresRequest) returns (ListLfpStoresResponse) 列出目标商家的商店（由 ListLfpStoresRequest 中的过滤条件指定）。 授权范围 需要以下 OAuth 作用域： https://www.googleapis.com/auth/content 有关详情，请参阅 OAuth 2.0 概览。

DeleteLfpStoreRequest

DeleteLfpStore 方法的请求消息。

字段
name	string 必需。要为目标商家帐号删除的商店的名称。格式：accounts/{account}/lfpStores/{target_merchant}~{store_code}

GetLfpStoreRequest

对 GetLfpStore 方法的请求消息。

字段
name	string 必需。要检索的商店的名称。格式：accounts/{account}/lfpStores/{target_merchant}~{store_code}

InsertLfpInventoryRequest

对 InsertLfpInventory 方法的请求消息。

字段
parent	string 必需。LFP 提供商帐号。格式：accounts/{account}
lfp_inventory	LfpInventory 必需。要插入的广告资源。

InsertLfpSaleRequest

InsertLfpSale 方法的请求消息。

字段
parent	string 必需。LFP 提供商帐号。格式：accounts/{lfp_partner}
lfp_sale	LfpSale 必需。要插入的促销活动。

InsertLfpStoreRequest

InsertLfpStore 方法的请求消息。

字段
parent	string 必需。LFP 提供方账号格式：accounts/{account}
lfp_store	LfpStore 必需。要插入的商店。

LfpInventory

商家的本地商品目录。

字段
name	string 仅限输出。标识符。LfpInventory 资源的名称。格式：accounts/{account}/lfpInventories/{target_merchant}~{store_code}~{offer}
target_account	int64 必需。要为其提交商品目录的商家的 Merchant Center ID。
store_code	string 必需。商家商店的标识符。通过 InsertLfpStore 插入的商店代码或通过商家资料中的商店代码。
offer_id	string 必需。不可变。商品的唯一标识符。如果商家同时提交了商品目录和销售数据，则此 ID 应与同一商品匹配。 注意：如果商家销售的是同一款商品的新品和二手货，则商品 ID 应该不同。
region_code	string 必需。商品销往的国家/地区的 CLDR 地区代码。
content_language	string 必需。商品的 ISO 639-1 语言代码（由两个字母组成）。
price	Price 可选。商品的当前价格。
availability	string 必需。此商店的商品库存状况。如需了解可接受的属性值，请参阅本地商品目录数据规范
collection_time	Timestamp 可选。收集广告资源的时间。如果未设置，则设置为广告资源提交时间。
gtin	string 可选。商品的全球贸易项目代码。
quantity	int64 可选。此商店所售商品的数量。必须大于或等于零。
pickup_method	string 可选。此优惠支持的提货方法。除非值为“not supported”，否则此字段必须与“pickupSla”一起提交。如需了解可接受的属性值，请参阅本地商品目录数据规范。
pickup_sla	string 可选。订单可提货的预计日期（相对于下单日期）。必须与“pickupMethod”一起提交。如需了解可接受的属性值，请参阅本地商品目录数据规范。
feed_label	string 可选。产品的 Feed 标签。如果未设置，则默认为 regionCode。

LfpSale

商家的销售交易。

字段
name	string 仅限输出。标识符。LfpSale 资源的名称。格式：accounts/{account}/lfpSales/{sale}
target_account	int64 必需。要提交销售交易的商家的 Merchant Center ID。
store_code	string 必需。商家商店的标识符。通过 API 插入的 storeCode，或商家资料中商店的代码。
offer_id	string 必需。商品的唯一标识符。如果商家同时提交了商品目录和销售数据，则此 ID 应与同一商品匹配。 注意：如果商家销售的是同一款商品的新品和二手货，则商品 ID 应该不同。
region_code	string 必需。商品销往的国家/地区的 CLDR 地区代码。
content_language	string 必需。商品的 ISO 639-1 语言代码（由两个字母组成）。
gtin	string 必需。售出产品的全球贸易项目代码。
price	Price 必需。商品的单价。
quantity	int64 必需。可售数量的相对变化。如果是退货商品，则为负数。
sale_time	Timestamp 必需。销售活动的时间戳。
uid	string 仅限输出。系统为 LfpSale 生成的全局唯一 ID。
feed_label	string 可选。产品的 Feed 标签。如果未设置，则默认为 regionCode。

LfpStore

商家的商店。这将用于与目标商家的 Google 商家资料下的商店进行匹配。如果找不到匹配的商店，系统将不会使用随商店代码提交的商品目录或销售交易。

字段
name	string 仅限输出。标识符。LfpStore 资源的名称。格式：accounts/{account}/lfpStores/{target_merchant}~{store_code}
target_account	int64 必需。要为其提交商店的商家的 Merchant Center ID。
store_code	string 必需。不可变。目标商家独有的商店标识符。
store_address	string 必需。商店的街道地址。例如：1600 Amphitheatre Pkwy, Mountain View, CA 94043, USA。
gcid_category[]	string 可选。“Google 我的商家”类别 ID。
matching_state	StoreMatchingState 可选。仅限输出。与 Google 商家资料的匹配状态。如果找不到匹配项，请参阅 matchingStateHint 了解详情。
store_name	string 可选。商家或商店的名称。
phone_number	string 可选。商店电话号码，采用 E.164 格式。示例：[phone]
website_uri	string 可选。商店或商家的网站网址。
place_id	string 可选。商店位置的 Google Place Id。
matching_state_hint	string 可选。仅限输出。关于匹配失败原因的提示。仅当 matchingState=STORE_MATCHING_STATE_FAILED 时才会设置此字段。 可能的值包括： “linked-store-not-found”：没有任何 Google 商家资料商店可匹配。 “store-match-not-found”：提供的 LfpStore 无法与任何关联的 Google 商家资料商店相匹配。Merchant Center 账号已正确关联，Google 商家资料中提供了商店，但 LfpStore 营业地点地址与 Google 商家资料中的商店地址不符。请更新 LfpStore 地址或 Google 商家资料中的商店地址以正确匹配。 “store-match-unverified”：提供的 LfpStore 无法与任何关联的 Google 商家资料商店相匹配，因为匹配的 Google 商家资料商店未经验证。请完成 Google 商家资料验证流程，以便正确匹配。

StoreMatchingState

将 LfpStore 与 Google 商家资料匹配的状态。

枚举
STORE_MATCHING_STATE_UNSPECIFIED	未指定存储匹配状态。
STORE_MATCHING_STATE_MATCHED	LfpStore 已成功与 Google 商家资料商店匹配。
STORE_MATCHING_STATE_FAILED	LfpStore 与 Google 商家资料商店不匹配。

ListLfpStoresRequest

ListLfpStores 方法的请求消息。

字段
parent	string 必需。LFP 合作伙伴。格式：accounts/{account}
target_account	int64 必需。要列出其商店的商家的 Merchant Center ID。
page_size	int32 可选。指定帐号要返回的 LfpStore 项资源数量上限。如果指定帐号的商店数量少于 pageSize，服务会返回小于此值的值。默认值为 250。最大值为 1000；如果指定的值大于最大值，则 pageSize 将默认为最大值。
page_token	string 可选。从之前的 ListLfpStoresRequest 调用接收的页面令牌。提供页面令牌以检索后续页面。进行分页时，提供给 ListLfpStoresRequest 的所有其他参数必须与提供页面令牌的调用匹配。在对上一个请求的响应中作为 nextPageToken 返回的令牌。

ListLfpStoresResponse

ListLfpStores 方法的响应消息。

字段
lfp_stores[]	LfpStore 指定商家的商店。
next_page_token	string 可作为 pageToken 发送并用于检索下一页的令牌。如果省略此字段，则不存在后续页面。