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.accounttax

方法
get GET /accounts/v1beta/{name=accounts/*/accounttax/*}（
） 返回与 GetAccountTaxRequest 的条件匹配的税费规则
patch PATCH /accounts/v1beta/{accountTax.name=accounts/*/accounttax/*}（
） 更新账号的税费设置。

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（
） 检索给定 kind 和 region_code 的最新版本 TermsOfService。