Merchant API

以编程方式管理 Merchant Center 账号。

服务:merchantapi.googleapis.com

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

发现文档

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

服务端点

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

  • https://merchantapi.googleapis.com

REST 资源:reviews_v1beta.accounts.merchantReviews

方法
delete DELETE /reviews/v1beta/{name=accounts/*/merchantReviews/*}
删除商家评价。
get GET /reviews/v1beta/{name=accounts/*/merchantReviews/*}
获取商家评价。
insert POST /reviews/v1beta/{parent=accounts/*}/merchantReviews:insert
为您的 Merchant Center 账号插入评价。
list GET /reviews/v1beta/{parent=accounts/*}/merchantReviews
列出商家评价。

REST 资源:reviews_v1beta.accounts.productReviews

方法
delete DELETE /reviews/v1beta/{name=accounts/*/productReviews/*}
删除商品评价。
get GET /reviews/v1beta/{name=accounts/*/productReviews/*}
获取商品评价。
insert POST /reviews/v1beta/{parent=accounts/*}/productReviews:insert
插入商品评价。
list GET /reviews/v1beta/{parent=accounts/*}/productReviews
列出商品评价。

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 资源:datasources_v1beta.accounts.dataSources.fileUploads

方法
get GET /datasources/v1beta/{name=accounts/*/dataSources/*/fileUploads/*}
获取最新的数据源文件上传内容。

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

方法
getAutofeedSettings GET /accounts/v1beta/{name=accounts/*/autofeedSettings}
检索账号的自动 Feed 设置。
updateAutofeedSettings PATCH /accounts/v1beta/{autofeedSettings.name=accounts/*/autofeedSettings}
更新账号的自动 Feed 设置。

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