使用 Merchant API 审核商品

商品评价是客户购物体验的重要组成部分。这些评分和评价有助于客户研究商品和做出购买决定，好评可以吸引更多优质客户访问卖家的商品页面。来源包括卖家、评价集合商家、评价网站和 Google 用户。

本页介绍了如何使用 Merchant API 管理商品评价。

前提条件

Google 需要您提供具体信息。必须具备以下条件：

  • Google Merchant Center 中有效的商品评价 Feed。
  • 您的账号必须已加入商品评分计划。如果您 不确定您是否已经注册，请查看 Merchant Center。如果您 未加入该计划，请详细了解如何加入商品评分计划 计划。
  • 如需使用 Merchant API 审核商品，请使用此表单提交请求。

创建数据源

使用 datasource.create API 创建商品评价 Feed。如果有现有商品评价 Feed，请使用 accounts.dataSources.get 提取 accounts.dataSources.name。请求的形式如下所示：

POST https://merchantapi.googleapis.com/datasources/v1beta/accounts/{account}/dataSources/{datasource}

示例

该示例展示了典型的请求和响应。

请求

POST https://merchantapi.googleapis.com/datasources/v1beta/accounts/123/dataSources {"displayName": "test api feed", "productReviewDataSource":{} }

答案

{
  "name": "accounts/123/dataSources/1000000573361824",
  "dataSourceId": "1000000573361824",
  "displayName": "test api feed",
  "productReviewDataSource": {},
  "input": "API"
}

创建商品评价

您可以使用 accounts.productreviews.insert 方法创建或更新 商品评价。accounts.productreviews.insert 方法接受一个 productreview 资源和数据源名称作为输入。如果成功，则返回新的或更新后的 productreview。如需创建商品评价，您必须 拥有 datasource.name。

请求的形式：

POST https://merchantapi.googleapis.com/reviews/v1beta/{parent=accounts/{accountId}/}productReviews:insert

以下示例请求展示了如何创建商品评价。

POST https://merchantapi.googleapis.com/reviews/v1beta/accounts/{accountId}/productReviews:insert?dataSource=accounts/{accountId}/dataSources/{dataSourceId}

  productReviewId = 'my_product_review'
  attributes {
    aggregatorName = 'aggregator_name'
    subclientName = 'subclient_name'
    publisherName = 'publisher_name'
    publisherFavicon = 'https://www.google.com/favicon.ico'
    reviewerId = 'reviewer_id'
    reviewerIsAnonymous = false
    reviewerUsername = 'reviewer_username'
    reviewLanguage = 'en'
    reviewCountry = 'US'
    reviewTime = '2024-04-01T00:00:00Z'
    title = 'Incredible product'
    content = 'This is an incredible product.'
    pros = ['pro1', 'pro2']
    cons = ['con1', 'con2']
    reviewLink = {
      type = 'SINGLETON'
      link = 'https://www.google.com'
    }
    reviewerImageLink = 'https://www.google.com/reviewer.png'
    minRating = 1
    maxRating = 10
    rating = 8.5
    productName = 'product_name'
    productLink = 'https://www.google.com/product'
    asins = ['asin1', 'asin2']
    gtins = ['gtin1', 'gtin2']
    mpns = ['mpn1', 'mpn2']
    skus = ['sku1', 'sku2']
    brands = ['brand1', 'brand2']
    isSpam = false
    collectionMethod = 'POST_FULFILLMENT'
    transactionId = 'transaction_id'
  }

创建商品评价后，评价可能需要几分钟时间才能体现出来 传播。

查看商品评价

如需查看商品评价，请使用 accounts.productreviews.get。只读字段。 您需要提供 accountId 和商品评论的 ID name 字段。GET 方法会返回相应的商品评价资源。

GET https://merchantapi.googleapis.com/reviews/v1beta/{name=accounts/{accountId}/productReviews/*}

列出商品评价

您可以使用 productreviews.list 方法查看所有已创建的商品 审核。

GET https://merchantapi.googleapis.com/reviews/v1beta/{parent=accounts/{accountId}}/productReviews

删除商品评价

如需删除商品评价，请使用 accounts.productreviews.delete。类似于 GET 方法，此方法需要返回的商品评价的名称字段 创建过程。

DELETE https://merchantapi.googleapis.com/reviews/v1beta/{name=accounts/{accountId}/productReviews/*}

商品评价状态

商品评价资源包含与其他 API 类似的状态，该状态是资源不可或缺的一部分，并遵循相同的问题和目标结构。