Merchant API

以程序化方式管理您的 Merchant Center 账号。

服务:merchantapi.googleapis.com

如要调用此服务,我们建议您使用 Google 提供的客户端库。如果您的应用需要使用您自己的库来调用此服务,则在发出 API 请求时应使用以下信息。

发现文档

发现文档是用于说明和使用 REST API 的机器可读规范。它用于构建客户端库、IDE 插件以及与 Google API 交互的其他工具。一项服务可能会提供多个发现文档。此服务提供了以下发现文档:

服务端点

服务端点是指定 API 服务的网络地址的基本网址。一项服务可能有多个服务端点。此服务具有以下服务端点,下面的所有 URI 都与此服务端点相关:

  • https://merchantapi.googleapis.com

REST 资源:reports_v1beta.accounts.reports

方法
search POST /reports/v1beta/{parent=accounts/*}/reports:search
) 检索由搜索查询定义的报告。

REST 资源:quota_v1beta.accounts.quotas

方法
list GET /quota/v1beta/{parent=accounts/*}/quotas
) 列出您的 Merchant Center 账号的每日通话配额和每个群组的用量。

REST 资源:promotions_v1beta.accounts.promotions

方法
get GET /promotions/v1beta/{name=accounts/*/promotions/*}
) 从您的 Merchant Center 账号中检索促销活动。
insert POST /promotions/v1beta/{parent=accounts/*}/promotions:insert
) 为您的 Merchant Center 账号插入促销活动。
list GET /promotions/v1beta/{parent=accounts/*}/promotions
) 列出您的 Merchant Center 账号中的促销活动。

REST 资源:products_v1beta.accounts.productInputs

方法
delete DELETE /products/v1beta/{name=accounts/*/productInputs/*}
) 从 Merchant Center 账号中删除输入的商品。
insert POST /products/v1beta/{parent=accounts/*}/productInputs:insert
) 将输入的产品上传至 Merchant Center 账号。

REST 资源:products_v1beta.accounts.products

方法
get GET /products/v1beta/{name=accounts/*/products/*}
) 从您的 Merchant Center 账号中检索已处理的产品。
list GET /products/v1beta/{parent=accounts/*}/products
) 列出您的 Merchant Center 账号中已处理的产品。

REST 资源:notifications_v1beta.accounts.notificationsubscriptions

方法
create POST /notifications/v1beta/{parent=accounts/*}/notificationsubscriptions
) 为商家创建通知订阅。
delete DELETE /notifications/v1beta/{name=accounts/*/notificationsubscriptions/*}
) 删除商家的通知订阅。
get GET /notifications/v1beta/{name=accounts/*/notificationsubscriptions/*}
) 获取某个账号的通知订阅。
list GET /notifications/v1beta/{parent=accounts/*}/notificationsubscriptions
) 获取商家的所有通知订阅。
patch PATCH /notifications/v1beta/{notificationSubscription.name=accounts/*/notificationsubscriptions/*}
) 更新商家的现有通知订阅。

REST 资源:lfp_v1beta.accounts.lfpInventories

方法
insert POST /lfp/v1beta/{parent=accounts/*}/lfpInventories:insert
) 插入给定目标商家账号的 LfpInventory 资源。

REST 资源:lfp_v1beta.accounts.lfpSales

方法
insert POST /lfp/v1beta/{parent=accounts/*}/lfpSales:insert
) 为指定商家插入 LfpSale

REST 资源:lfp_v1beta.accounts.lfpStores

方法
delete DELETE /lfp/v1beta/{name=accounts/*/lfpStores/*}
) 删除目标商家的商店。
get GET /lfp/v1beta/{name=accounts/*/lfpStores/*}
) 检索有关商店的信息。
insert POST /lfp/v1beta/{parent=accounts/*}/lfpStores:insert
) 为目标商家插入商店。
list GET /lfp/v1beta/{parent=accounts/*}/lfpStores
) 列出目标商家的商店,由 ListLfpStoresRequest 中的过滤条件指定。

REST 资源:inventories_v1beta.accounts.products.localInventories

方法
delete DELETE /inventories/v1beta/{name=accounts/*/products/*/localInventories/*}
) 从商家账号中的指定商品中删除指定的 LocalInventory
insert POST /inventories/v1beta/{parent=accounts/*/products/*}/localInventories:insert
) 将 LocalInventory 资源插入您的商家账号中的商品。
list GET /inventories/v1beta/{parent=accounts/*/products/*}/localInventories
) 列出您的商家账号中指定商品的 LocalInventory 资源。

REST 资源:inventories_v1beta.accounts.products.regionalInventories

方法
delete DELETE /inventories/v1beta/{name=accounts/*/products/*/regionalInventories/*}
) 从商家账号中的指定商品中删除指定的 RegionalInventory 资源。
insert POST /inventories/v1beta/{parent=accounts/*/products/*}/regionalInventories:insert
) 将 RegionalInventory 插入商家账号中的指定商品。
list GET /inventories/v1beta/{parent=accounts/*/products/*}/regionalInventories
) 列出您的商家账号中指定商品的 RegionalInventory 资源。

REST 资源:datasources_v1beta.accounts.dataSources

方法
create POST /datasources/v1beta/{parent=accounts/*}/dataSources
) 为给定账号创建新的数据源配置。
delete DELETE /datasources/v1beta/{name=accounts/*/dataSources/*}
) 从您的 Merchant Center 账号中删除数据源。
fetch POST /datasources/v1beta/{name=accounts/*/dataSources/*}:fetch
) 立即对 Merchant Center 账号中的数据源执行数据提取(即使在提取时间安排之外)。
get GET /datasources/v1beta/{name=accounts/*/dataSources/*}
) 检索指定账号的数据源配置。
list GET /datasources/v1beta/{parent=accounts/*}/dataSources
) 列出指定账号的数据源配置。
patch PATCH /datasources/v1beta/{dataSource.name=accounts/*/dataSources/*}
) 更新现有数据源配置。

REST 资源:conversions_v1beta.accounts.conversionSources

方法
create POST /conversions/v1beta/{parent=accounts/*}/conversionSources
) 创建新的转化来源。
delete DELETE /conversions/v1beta/{name=accounts/*/conversionSources/*}
) 归档现有转化来源。
get GET /conversions/v1beta/{name=accounts/*/conversionSources/*}
) 获取转化来源。
list GET /conversions/v1beta/{parent=accounts/*}/conversionSources
) 检索调用者有权访问的转化来源列表。
patch PATCH /conversions/v1beta/{conversionSource.name=accounts/*/conversionSources/*}
) 更新现有转化来源的信息。
undelete POST /conversions/v1beta/{name=accounts/*/conversionSources/*}:undelete
) 重新启用已归档的转化来源。

REST 资源:accounts_v1beta.accounts

方法
createAndConfigure POST /accounts/v1beta/accounts:createAndConfigure
) 创建具有额外配置的独立 Merchant Center 账号。
delete DELETE /accounts/v1beta/{name=accounts/*}
) 删除指定的账号,而不考虑其类型:独立账号、MCA 账号或子账号。
get GET /accounts/v1beta/{name=accounts/*}
) 用于检索 Merchant Center 账号中的一个账号。
list GET /accounts/v1beta/accounts
) 列出调用用户可访问且符合请求限制条件(如页面大小或过滤条件)的账号。
listSubaccounts GET /accounts/v1beta/{provider=accounts/*}:listSubaccounts
) 列出给定多客户账号的所有子账号。
patch PATCH /accounts/v1beta/{account.name=accounts/*}
) 更新账号,而不考虑其类型:独立账号、MCA 账号或子账号。

REST 资源:accounts_v1beta.accounts.businessIdentity

方法
getBusinessIdentity GET /accounts/v1beta/{name=accounts/*/businessIdentity}
) 检索账号的商家身份。
updateBusinessIdentity PATCH /accounts/v1beta/{businessIdentity.name=accounts/*/businessIdentity}
) 更新账号的商家身份。

REST 资源:accounts_v1beta.accounts.businessInfo

方法
getBusinessInfo GET /accounts/v1beta/{name=accounts/*/businessInfo}
) 检索账号的商家信息。
updateBusinessInfo PATCH /accounts/v1beta/{businessInfo.name=accounts/*/businessInfo}
) 更新账号的商家信息。

REST 资源:accounts_v1beta.accounts.emailpreferences

方法
getEmailPreferences GET /accounts/v1beta/{name=accounts/*/users/*/emailPreferences}
) 返回 Merchant Center 账号用户的电子邮件接收设置。
updateEmailPreferences PATCH /accounts/v1beta/{emailPreferences.name=accounts/*/users/*/emailPreferences}
) 更新 Merchant Center 账号用户的电子邮件接收设置。

REST 资源:accounts_v1beta.accounts.homepage

方法
claim POST /accounts/v1beta/{name=accounts/*/homepage}:claim
) 声明商店首页的所有权。
getHomepage GET /accounts/v1beta/{name=accounts/*/homepage}
) 检索商店的首页。
unclaim POST /accounts/v1beta/{name=accounts/*/homepage}:unclaim
) 取消声明商店首页的所有权。
updateHomepage PATCH /accounts/v1beta/{homepage.name=accounts/*/homepage}
) 更新商店的首页。

REST 资源:accounts_v1beta.accounts.issues

方法
list GET /accounts/v1beta/{parent=accounts/*}/issues
) 列出 Merchant Center 账号的所有账号问题。

REST 资源:accounts_v1beta.accounts.onlineReturnPolicies

方法
get GET /accounts/v1beta/{name=accounts/*/onlineReturnPolicies/*}
) 获取现有退货政策。
list GET /accounts/v1beta/{parent=accounts/*}/onlineReturnPolicies
) 列出所有现有的退货政策。

REST 资源:accounts_v1beta.accounts.programs

方法
disable POST /accounts/v1beta/{name=accounts/*/programs/*}:disable
) 禁止该账号参与指定计划。
enable POST /accounts/v1beta/{name=accounts/*/programs/*}:enable
) 允许该账号参与指定计划。
get GET /accounts/v1beta/{name=accounts/*/programs/*}
) 检索账号的指定计划。
list GET /accounts/v1beta/{parent=accounts/*}/programs
) 检索账号的所有程序。

REST 资源:accounts_v1beta.accounts.regions

方法
create POST /accounts/v1beta/{parent=accounts/*}/regions
) 在 Merchant Center 账号中创建地区定义。
delete DELETE /accounts/v1beta/{name=accounts/*/regions/*}
) 从您的 Merchant Center 账号中删除地区定义。
get GET /accounts/v1beta/{name=accounts/*/regions/*}
) 检索 Merchant Center 账号中定义的地区。
list GET /accounts/v1beta/{parent=accounts/*}/regions
) 列出了您的 Merchant Center 账号中的地区。
patch PATCH /accounts/v1beta/{region.name=accounts/*/regions/*}
) 更新 Merchant Center 账号中的地区定义。

REST 资源:accounts_v1beta.accounts.shippingSettings

方法
getShippingSettings GET /accounts/v1beta/{name=accounts/*/shippingSettings}
) 检索运费设置信息。
insert POST /accounts/v1beta/{parent=accounts/*}/shippingSettings:insert
) 将商家的运费设置替换为申请配送设置。

REST 资源:accounts_v1beta.accounts.termsOfServiceAgreementStates

方法
get GET /accounts/v1beta/{name=accounts/*/termsOfServiceAgreementStates/*}
) 返回服务条款协议的状态。
retrieveForApplication GET /accounts/v1beta/{parent=accounts/*}/termsOfServiceAgreementStates:retrieveForApplication
) 检索应用服务条款的协议状态。

REST 资源:accounts_v1beta.accounts.users

方法
create POST /accounts/v1beta/{parent=accounts/*}/users
) 创建 Merchant Center 账号用户。
delete DELETE /accounts/v1beta/{name=accounts/*/users/*}
) 删除 Merchant Center 账号用户。
get GET /accounts/v1beta/{name=accounts/*/users/*}
) 检索 Merchant Center 账号用户。
list GET /accounts/v1beta/{parent=accounts/*}/users
) 列出某个 Merchant Center 账号的所有用户。
patch PATCH /accounts/v1beta/{user.name=accounts/*/users/*}
) 更新 Merchant Center 账号用户。

REST 资源:accounts_v1beta.termsOfService

方法
accept GET /accounts/v1beta/{name=termsOfService/*}:accept
) 接受 TermsOfService
get GET /accounts/v1beta/{name=termsOfService/*}
) 检索与提供的版本关联的 TermsOfService
retrieveLatest GET /accounts/v1beta/termsOfService:retrieveLatest
) 检索给定 kindregion_code 的最新版本 TermsOfService