Merchant API (v1beta) 將於 2026 年 2 月 28 日終止服務並停用。如要瞭解如何改用最新穩定版，請參閱「從 v1beta 遷移至 v1」。

評估產品

你可以使用 Merchant Reports API 查看成效資料、依特定屬性篩選產品，以及改善價格。

評估成效

你可以使用 Merchant Reports API product_performance_view 擷取帳戶的成效指標。

需求條件

如要擷取這份報表，您必須具備成效和洞察角色。

如要將「成效和洞察」角色指派給現有使用者，請建立 PATCH 要求，並將 PERFORMANCE_REPORTING 存取權指派給該使用者。下列要求說明如何建立修補要求，以指派 PERFORMANCE_REPORTING 存取權：

PATCH https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/users/{EMAIL_ID}

{
  "accessRights": [
    "PERFORMANCE_REPORTING"
  ]
}

更改下列內容：

{ACCOUNT_ID}：Merchant Center 帳戶的專屬 ID。
{EMAIL_ID}：要指派角色的使用者電子郵件地址。

查詢範例

下列查詢會擷取特定 30 天期間內，帳戶中所有產品的 impressions、clicks 和 click_through_rate。如要提出要求，請將下列 Merchant Center 查詢語言陳述式傳遞至 accounts.reports.search 方法：

SELECT impressions, clicks, click_through_rate
FROM product_performance_view
WHERE date BETWEEN '2020-12-01' AND '2020-12-30'

如要進一步瞭解成效報表，請參閱「成效報表」指南。

篩選產品

你可以使用 Merchant Reports API 的 product_view 顯示產品資料的篩選檢視畫面，包括產品狀態。舉例來說，你可以查詢 product_view 列出有問題的產品，或是取得新產品清單並驗證放送狀態。

您必須在查詢的 SELECT 子句中加入 id 欄位。id 與產品的 REST ID 具有相同的值。

您可以根據所有可用欄位進行篩選，但下列欄位除外：

status_per_reporting_context
item_issues。

您可以根據所有可用欄位排序回應，但下列欄位除外：

gtin
status_per_reporting_context
item_issues

你可以查看 aggregated_reporting_context_status 欄位，瞭解產品的整體資格。這個欄位會匯總產品所有報表環境的狀態。

以下範例會傳回狀態為「已匯總」ELIGIBLE_LIMITED的產品，表示這些產品符合在至少一個目標報表環境中放送的資格，但並非所有環境都符合資格。您可以要求提供各回報情境的詳細產品狀態，以及產品問題，以便進一步調查。如要提出要求，請將下列 Merchant Center 查詢語言陳述式傳遞至 accounts.reports.search 方法：

SELECT
  id,
  offer_id,
  feed_label,
  title,
  aggregated_reporting_context_status,
  status_per_reporting_context,
  item_issues
FROM product_view
WHERE aggregated_reporting_context_status = 'ELIGIBLE_LIMITED'

以下是上述查詢的範例回應：

{
  "results": [
    {
      "productView": {
        "id": "en~US~id0",
        "offerId": "id0",
        "feedLabel": "US",
        "aggregatedReportingContextStatus": "ELIGIBLE_LIMITED",
        "statusPerReportingContext": [
          {
            "reportingContext": "SHOPPING_ADS",
            "disapprovedCountries": [
              "US"
            ]
          },
          {
            "reportingContext": "FREE_LISTINGS",
            "approvedCountries": [
              "US"
            ]
          }
        ]
        "itemIssues": [
          {
            "type": {
              "code": "invalid_string_value",
              "canonicalAttribute": "n:product_code"
            },
            "severity": {
              "severityPerReportingContext": [
                {
                  "reportingContext": "SHOPPING_ADS",
                  "disapprovedCountries": [
                    "US"
                  ]
                },
                {
                  "reportingContext": "FREE_LISTINGS",
                  "disapprovedCountries": [
                    "US"
                  ]
                }
              ],
              "aggregatedSeverity": "DISAPPROVED"
            },
            "resolution": "MERCHANT_ACTION"
          },
          {
            "type": {
              "code": "apparel_missing_brand",
              "canonicalAttribute": "n:brand"
            },
            "severity": {
              "severityPerReportingContext": [
                {
                  "reportingContext": "SHOPPING_ADS",
                  "disapprovedCountries": [
                    "US"
                  ]
                }
              ],
              "aggregatedSeverity": "DEMOTED"
            },
            "resolution": "MERCHANT_ACTION"
          }
        ]
      }
    }
  ]
}

您可以在 WHERE 子句中使用 reporting_context 篩選器，查看特定報表環境的產品詳細資料。篩選依據為 reporting_context 時，aggregated_reporting_context_status 只會根據所選報表內容計算，而 status_per_reporting_context 和 item_issues 只會傳回該內容的詳細資料。

如要進一步瞭解可供查詢的欄位，請參閱「product_view 資料表中的欄位」。

改善定價

你可以使用價格深入分析檢視畫面，查看產品的建議特價，以及更新產品價格後的預期成效預測。價格深入分析報表可協助你更有效地設定產品價格。

詳情請參閱「透過價格深入分析報表改善產品價格」。

查詢 price_insights_product_view 查看產品的建議特價。

你可以使用以下範例，查看產品的建議售價。如要提出要求，請將下列 Merchant Center 查詢語言陳述式傳遞至 accounts.reports.search 方法：

SELECT
  id,
  title,
  brand,
  price,
  suggested_price,
  predicted_impressions_change_fraction,
  predicted_clicks_change_fraction,
  predicted_conversion_change_fraction
FROM price_insights_product_view