以编程方式管理 Merchant Center 账号。
- REST 资源:reviews_v1beta.accounts.merchantReviews
- REST 资源:reviews_v1beta.accounts.productReviews
- REST 资源:reports_v1beta.accounts.reports
- REST 资源:quota_v1beta.accounts.quotas
- REST 资源:promotions_v1beta.accounts.promotions
- REST 资源:products_v1beta.accounts.productInputs
- REST 资源:products_v1beta.accounts.products
- REST 资源:notifications_v1beta.accounts.notificationsubscriptions
- REST 资源:lfp_v1beta.accounts.lfpInventories
- REST 资源:lfp_v1beta.accounts.lfpSales
- REST 资源:lfp_v1beta.accounts.lfpStores
- REST 资源:inventories_v1beta.accounts.products.localInventories
- REST 资源:inventories_v1beta.accounts.products.regionalInventories
- REST 资源:datasources_v1beta.accounts.dataSources
- REST 资源:datasources_v1beta.accounts.dataSources.fileUploads
- REST 资源:conversions_v1beta.accounts.conversionSources
- REST 资源:accounts_v1beta.accounts
- REST 资源:accounts_v1beta.accounts.autofeedSettings
- REST 资源:accounts_v1beta.accounts.businessIdentity
- REST 资源:accounts_v1beta.accounts.businessInfo
- REST 资源:accounts_v1beta.accounts.emailPreferences
- REST 资源:accounts_v1beta.accounts.homepage
- REST 资源:accounts_v1beta.accounts.issues
- REST 资源:accounts_v1beta.accounts.onlineReturnPolicies
- REST 资源:accounts_v1beta.accounts.programs
- REST 资源:accounts_v1beta.accounts.regions
- REST 资源:accounts_v1beta.accounts.shippingSettings
- REST 资源:accounts_v1beta.accounts.termsOfServiceAgreementStates
- REST 资源:accounts_v1beta.accounts.users
- REST 资源:accounts_v1beta.termsOfService
服务:merchantapi.googleapis.com
如要调用此服务,我们建议您使用 Google 提供的客户端库。如果您的应用需要使用您自己的库来调用此服务,则在发出 API 请求时应使用以下信息。
发现文档
发现文档是用于说明和使用 REST API 的机器可读规范。它用于构建客户端库、IDE 插件以及与 Google API 交互的其他工具。一项服务可能会提供多个发现文档。此服务提供了以下发现文档:
- https://merchantapi.googleapis.com/$discovery/rest?version=reviews_v1beta
- https://merchantapi.googleapis.com/$discovery/rest?version=reports_v1beta
- https://merchantapi.googleapis.com/$discovery/rest?version=quota_v1beta
- https://merchantapi.googleapis.com/$discovery/rest?version=promotions_v1beta
- https://merchantapi.googleapis.com/$discovery/rest?version=products_v1beta
- https://merchantapi.googleapis.com/$discovery/rest?version=notifications_v1beta
- https://merchantapi.googleapis.com/$discovery/rest?version=lfp_v1beta
- https://merchantapi.googleapis.com/$discovery/rest?version=inventories_v1beta
- https://merchantapi.googleapis.com/$discovery/rest?version=datasources_v1beta
- https://merchantapi.googleapis.com/$discovery/rest?version=conversions_v1beta
- https://merchantapi.googleapis.com/$discovery/rest?version=accounts_v1beta
服务端点
服务端点是指定 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
方法 | |
---|---|
create |
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 列出可供发起调用的用户访问且与请求的约束条件(例如页面大小或过滤条件)匹配的账号。 |
list |
GET /accounts/v1beta/{provider=accounts/*}:listSubaccounts 列出指定多客户账号的所有子账号。 |
patch |
PATCH /accounts/v1beta/{account.name=accounts/*} 更新账号,无论其类型为何(独立账号、MCA 或子账号)。 |
REST 资源:accounts_v1beta.accounts.autofeedSettings
方法 | |
---|---|
get |
GET /accounts/v1beta/{name=accounts/*/autofeedSettings} 检索账号的自动 Feed 设置。 |
update |
PATCH /accounts/v1beta/{autofeedSettings.name=accounts/*/autofeedSettings} 更新账号的自动 Feed 设置。 |
REST 资源:accounts_v1beta.accounts.businessIdentity
方法 | |
---|---|
get |
GET /accounts/v1beta/{name=accounts/*/businessIdentity} 检索账号的商家身份。 |
update |
PATCH /accounts/v1beta/{businessIdentity.name=accounts/*/businessIdentity} 更新账号的商家身份。 |
REST 资源:accounts_v1beta.accounts.businessInfo
方法 | |
---|---|
get |
GET /accounts/v1beta/{name=accounts/*/businessInfo} 检索账号的商家信息。 |
update |
PATCH /accounts/v1beta/{businessInfo.name=accounts/*/businessInfo} 更新账号的商家信息。 |
REST 资源:accounts_v1beta.accounts.emailPreferences
方法 | |
---|---|
get |
GET /accounts/v1beta/{name=accounts/*/users/*/emailPreferences} 返回 Merchant Center 账号用户的电子邮件接收设置。 |
update |
PATCH /accounts/v1beta/{emailPreferences.name=accounts/*/users/*/emailPreferences} 更新 Merchant Center 账号用户的电子邮件接收设置。 |
REST 资源:accounts_v1beta.accounts.homepage
方法 | |
---|---|
claim |
POST /accounts/v1beta/{name=accounts/*/homepage}:claim 声明商店的首页。 |
get |
GET /accounts/v1beta/{name=accounts/*/homepage} 检索商店的首页。 |
unclaim |
POST /accounts/v1beta/{name=accounts/*/homepage}:unclaim 取消声明商店的首页。 |
update |
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
方法 | |
---|---|
get |
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/*} 返回服务条款协议的状态。 |
retrieve |
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 。 |
retrieve |
GET /accounts/v1beta/termsOfService:retrieveLatest 根据给定的 kind 和 region_code 检索最新版本的 TermsOfService 。 |