卖家评价能帮助用户发现提供优质客户体验的商家，对商家产生信任感，从而做出明智的购买决定。因此，商店评分有助于商家提升广告和自然搜索结果的效果，吸引更多符合条件的客户访问其着陆页。
本页介绍了如何使用 Merchant API 管理卖家评价。
前提条件
Google 需要您提供具体信息。您必须具备以下条件：
- Google Merchant Center 中有效的商家评价数据源。
- 您的账号必须已加入商店评分计划。如果您不确定自己是否已注册，请查看 Merchant Center。如果您尚未注册，请提交申请表单。
创建数据源
使用 accounts.dataSources.create 方法创建商家评价 Feed。如果有现有的商家评价 Feed，请使用 accounts.dataSources.get 提取 dataSource.name 字段。
请求的形式如下：
POST https://merchantapi.googleapis.com/datasources/v1beta/accounts/{ACCOUNT_ID}/dataSources/{DATASOURCE_ID}
示例
该示例展示了一个典型的请求和响应。
请求
POST https://merchantapi.googleapis.com/datasources/v1beta/accounts/123/dataSources {"displayName": "test api feed", "merchantReviewDataSource":{} }
答案
{
"name": "accounts/123/dataSources/1000000573361824",
"dataSourceId": "1000000573361824",
"displayName": "test api feed",
"merchantReviewDataSource": {},
"input": "API"
}
如需了解详情，请参阅 Merchant Data Sources API 概览。
创建商家评价
您可以使用 accounts.merchantReviews.insert 方法创建或更新卖家评价。accounts.merchantReviews.insert 方法将 merchantreview 资源和数据源名称作为输入。如果成功，则返回新的或更新后的商家评价。创建商家评价需要 datasource.name。
请求的形式：
POST https://merchantapi.googleapis.com/reviews/v1beta/{parent=accounts/*/}merchantReviews:insert
请参阅以下商家评价示例，以供参考。
POST https://merchantapi.googleapis.com/reviews/v1beta/accounts/{ACCOUNT_ID}/merchantReviews:insert?dataSource=accounts/{ACCOUNT_ID}/dataSources/{DATASOURCE_ID}
merchantReviewId = 'my_own_review'
attributes {
merchantId = 'merchant_id'
merchantDisplayName = 'merchant_display_name'
merchantLink = 'publisher_name'
merchantRatingLink = 'https://www.google.com'
minRating = 1
maxRating = 10
rating = 7.9
title = 'Amazing Merchant'
content = 'This is an incredible merchant'
reviewerId = 'reviewer_id'
reviewerUsername = 'reviewer_username'
isAnonymous = false
collectionMethod = 'AFTER_FULFILLMENT'
reviewTime = '2024-04-01T00:00:00Z'
reviewLanguage = 'en'
reviewCountry = 'US'
}
创建商家评价后，评价可能需要几分钟才能传播。
查看对商家的评价
如需查看商家评价，请使用 accounts.merchantReviews.get。此字段是只读字段。它要求您在名称字段中提供 merchantId 和商家评价的 ID。get 方法会返回相应的商家评价资源。
例如：
GET https://merchantapi.googleapis.com/reviews/v1beta/{name=accounts/*/merchantReviews/*}
如需检索指定 Merchant Center 账号中的单个商品，您可以使用 google.shopping.merchant.accounts.v1beta.GetProductRequest 方法，如以下示例所示。
Java
public static void getProduct(Config config, String product) throws Exception {
// Obtains OAuth token based on the user's configuration.
GoogleCredentials credential = new Authenticator().authenticate();
// Creates service settings using the credentials retrieved above.
ProductsServiceSettings productsServiceSettings =
ProductsServiceSettings.newBuilder()
.setCredentialsProvider(FixedCredentialsProvider.create(credential))
.build();
// Calls the API and catches and prints any network failures/errors.
try (ProductsServiceClient productsServiceClient =
ProductsServiceClient.create(productsServiceSettings)) {
// The name has the format: accounts/{account}/products/{productId}
GetProductRequest request = GetProductRequest.newBuilder().setName(product).build();
System.out.println("Sending get product request:");
Product response = productsServiceClient.getProduct(request);
System.out.println("Retrieved Product below");
System.out.println(response);
} catch (Exception e) {
System.out.println(e);
}
}
列出商家评价
您可以使用 accounts.merchantReviews.list 方法查看所有已创建的商家评价。
GET https://merchantapi.googleapis.com/reviews/v1beta/accounts/{ACCOUNT_ID}/merchantReviews
删除商家评价
如需删除商家评价，请使用 accounts.merchantReviews.delete。与 accounts.merchantReviews.get 方法类似，此方法需要创建期间返回的商家评价的名称字段。
例如：
DELETE https://merchantapi.googleapis.com/reviews/v1beta/{name=accounts/*/merchantReviews/*}
商家审核状态
商家评价资源包含与其他 API 类似的状态，该状态是资源不可或缺的一部分，并遵循相同的问题和目标结构。