使用 Merchant API 審查產品

產品評論是購物體驗中重要的一環 供客戶參考這些評分和評論有助於顧客研究產品與決定消費，正面的產品評論有助於吸引更多合格 將客戶帶往賣家的產品網頁來源包括賣家、評論集結網站、評論網站和 Google 使用者。

本頁面說明如何使用 Merchant API 管理產品評論。

必要條件

Google 需要你提供特定資訊。你必須具備下列條件：

  • 在 Google Merchant Center 中具備有效的產品評論動態饋給。
  • 你的帳戶必須加入產品評分計畫。如果你不確定是否已註冊，請前往 Merchant Center 查看。如果您是 未註冊，請進一步瞭解如何加入產品評分計畫 計畫。
  • 如要使用 Merchant API 審查產品，請使用這份 表單。

建立資料來源

使用 datasource.create API 建立產品評論動態饋給。如果已有 有可用的產品評論動態饋給，請使用 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， 名稱欄位中。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 類似的狀態， 是資源不可或缺的一環，也遵循同樣的問題，目的地 成本中心的架構