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 可选。此优惠支持的提货方法。除非值为“不受支持”，否则必须将此字段与 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 地点 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 发送并用于检索下一页的令牌。如果省略此字段，则不存在后续页面。