使用 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"
}

如需了解详情，请参阅 Merchant Data Sources API 概览。

创建商品评价

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

请求的形式：

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

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

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

  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。GET 方法会返回相应的商品评价资源。

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

列出商品评价

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

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

删除商品评价

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

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

商品评价状态

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