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 帐号中的帐号。
getBusinessIdentity GET /accounts/v1beta/{name=accounts/*/businessIdentity}
检索帐号的商家身份。
getBusinessInfo GET /accounts/v1beta/{name=accounts/*/businessInfo}
检索帐号的商家信息。
getHomepage GET /accounts/v1beta/{name=accounts/*/homepage}
检索商店的首页。
getShippingSettings GET /accounts/v1beta/{name=accounts/*/shippingSettings}
检索运费设置信息。
list GET /accounts/v1beta/accounts
列出调用方用户可以访问且符合请求限制条件（例如页面大小或过滤条件）的帐号。
listSubaccounts GET /accounts/v1beta/{provider=accounts/*}:listSubaccounts
列出指定多客户账号的所有子账号。
patch PATCH /accounts/v1beta/{account.name=accounts/*}
更新帐号，而不考虑帐号类型：独立帐号、MCA 帐号或子帐号。
updateBusinessIdentity PATCH /accounts/v1beta/{businessIdentity.name=accounts/*/businessIdentity}
更新帐号的商家身份。
updateBusinessInfo PATCH /accounts/v1beta/{businessInfo.name=accounts/*/businessInfo}
更新帐号的商家信息。
updateHomepage PATCH /accounts/v1beta/{homepage.name=accounts/*/homepage}
更新商店首页。

REST 资源：accounts_v1beta.accounts.accounttax

方法
get GET /accounts/v1beta/{name=accounts/*/accounttax/*}
返回与 GetAccountTaxRequest 的条件匹配的税费规则
list GET /accounts/v1beta/{parent=accounts/*}/accounttax
仅在您的 Merchant Center 账号中列出子账号的税费设置。
patch PATCH /accounts/v1beta/{accountTax.name=accounts/*/accounttax/*}
更新帐号的税费设置。

REST 资源：accounts_v1beta.accounts.homepage

方法
claim POST /accounts/v1beta/{name=accounts/*/homepage}:claim
声明商店首页的所有权。
unclaim POST /accounts/v1beta/{name=accounts/*/homepage}:unclaim
取消声明商店首页的所有权。

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

方法
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 帐号用户。
getEmailPreferences GET /accounts/v1beta/{name=accounts/*/users/*/emailPreferences}
返回 Merchant Center 帐号用户的电子邮件接收设置。
list GET /accounts/v1beta/{parent=accounts/*}/users
列出某个 Merchant Center 帐号的所有用户。
patch PATCH /accounts/v1beta/{user.name=accounts/*/users/*}
更新 Merchant Center 帐号用户。
updateEmailPreferences PATCH /accounts/v1beta/{emailPreferences.name=accounts/*/users/*/emailPreferences}
更新 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。