以下說明如何整合商家報表 將 API 換成現有 Content API for Education 購物導入作業。
要求
請使用下列 Merchant Reporting API 要求網址格式：
POST https://merchantapi.googleapis.com/reports/v1beta/{parent}/reports:search
以下是 Content API for Shopping 與商家的差異範例
「search」要求的 Reports API：
| 內容 API | 商家 API | |
| 網址 | https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/reports/search | https://merchantapi.googleapis.com/reports/v1beta/{parent}/reports:search |
| ID | {merchantId}
|
{parent}
|
方法
您可以呼叫
ReportService.Search敬上
方法。
觀看次數
在 Merchant API 中，資料表名稱已從 CammelCase 變更為 snake_case。
MerchantPerformanceView 現在是 product_performance_view。
以下將說明 Content API for Shopping 和 商家 API：
| 內容 API | 商家 API |
MerchantPerformanceView
|
product_performance_view
|
ProductView
|
product_view
|
PriceCompetitivenesProductView
|
price_competitiveness_product_view
|
PriceInsightsProductView
|
price_insights_product_view
|
BestSellersBrandView
|
best_sellers_brand_view
|
BestSellersProductClusterView
|
best_sellers_product_cluster_view
|
CompetitiveVisibilityCompetitorView
|
competitive_visibility_competitor_view
|
CompetitiveVisibilityTopMerchantView
|
competitive_visibility_top_merchant_view
|
CompetitiveVisibilityBenchmarkView
|
competitive_visibility_benchmark_view
|
在 Merchant API 中指定欄位前置字串，例如 segments.offer_id
也不再需要使用只要使用欄位名稱 offer_id 即可。
以下是 Content API for Shopping 和 商家 API：
| 內容 API | 商家 API |
SELECT
segments.offer_id,
metrics.clicks
FROM MerchantPerformanceView
WHERE segments.date DURING LAST_7_DAYS
|
SELECT
offer_id,
clicks
FROM product_performance_view
WHERE date DURING LAST_7_DAYS
|
回應範例如下：
| 內容 API | 商家 API |
{
"segments":{
"offerId":"abc"
},
"metrics":{
"clicks":"123"
}
}
|
{
"productPerformanceView" : {
"offerId": "abc",
"clicks": "123"
}
}
|
資料表名稱可以當做欄位前置字串。例如，offer_id 和
系統接受 Merchant API 查詢中的 product_performance_view.offer_id。
成效
Merchant Reports API 成效檢視畫面的異動如下：
| 內容 API | 商家 API | 說明 |
segments.program：字串
|
marketing_method：字串
|
「program」區隔由新的 marketing_method 欄位取代。詳情請參閱新的 marketing method 值。
|
metrics.ctr：雙精準數
|
clickThroughRate：雙精準數
|
「ctr」指標已重新命名為「clickThroughRate」
|
metrics.conversionValueMicros：整數
segments.currencyCode：字串
|
conversionValue: {
|
金額 (微量) 和貨幣欄位會合併為一個 Price 類型的欄位
|
metrics.orders,
|
不支援 | Merchant Reports API 不支援 Buy on Google 指標 |
新的行銷方式價值
以下是 segments.program 和 marketing_method 值的對應：
| 內容 API | 商家 API |
SHOPPING_ADS
|
ADS
|
FREE_PRODUCT_LISTING
|
ORGANIC
|
FREE_LOCAL_PRODUCT_LISTING
|
ORGANIC
|
BUY_ON_GOOGLE_LISTING
|
不支援 |
產品
以下是 Merchant Reports API 中產品檢視畫面的異動：
| 內容 API | 商家 API | 說明 |
productView.id：字串
|
id：字串
|
欄位格式將從 channel:language:targetCountry:offerId 變更為 channel~language~feedLabel~offerId
|
productView.priceMicros：整數
productView.currencyCode：字串
|
price: {
|
金額 (微量) 和貨幣欄位會合併為一個 Price 類型的欄位
|
productView.aggregated_destination_status：字串
|
aggregated_reporting_context_status：字串
|
aggregated_destination_status 欄位已重新命名為 aggregated_reporting_context_status，但值維持不變
|
productView.item_issues: [
|
item_issues: [
|
「ItemIssue」定義已變更
|
| 不支援 | feedLabel：字串
|
加入「feedLabel」欄位
|
價格分析
Merchant Reporting API 中的價格分析檢視畫面異動如下：
| 內容 API | 商家 API | 說明 |
productView.id：字串
|
id：字串
|
欄位格式將從 channel:language:targetCountry:offerId 變更為 channel~language~feedLabel~offerId
|
productView.priceMicros：整數
productView.currencyCode：字串
|
price: {
|
金額 (微量) 和貨幣欄位會合併為一個 Price 類型的欄位
|
priceInsights.suggestedPriceMicros：整數
priceInsights.suggestedPriceCurrencyCode：字串
|
suggestedPrice: {
|
金額 (微量) 和貨幣欄位會合併為一個 Price 類型的欄位
|
priceInsights.predictedGrossProfitChangeFraction：雙精準數
priceInsights.predictedMonthlyGrossProfitChangeMicros：整數
priceInsights.predictedMonthlyGrossProfitChangeCurrencyCode：字串
|
不支援 | Merchant Reports API 不支援與毛利變化相關的欄位 |
價格競爭力
商家報表中的價格競爭力檢視畫面異動如下 API：
| 內容 API | 商家 API | 說明 |
productView.id：字串
|
id：字串
|
欄位格式將從 channel:language:targetCountry:offerId 變更為 channel~language~feedLabel~offerId
|
productView.priceMicros：整數
productView.currencyCode：字串
|
price: {
|
金額 (微量) 和貨幣欄位會合併為一個 Price 類型的欄位
|
priceCompetitiveness.countryCode：字串
|
reportCountryCode：字串
|
「countryCode」欄位已重新命名為「reportCountryCode」
|
priceCompetitiveness.benchmarkPriceMicros：整數
priceCompetitiveness.benchmarkPriceCurrencyCode：字串
|
benchmarkPrice: {
|
金額 (微量) 和貨幣欄位會合併為一個 Price 類型的欄位
|
暢銷商品
Merchant Reports API 中的暢銷商品資料檢視將有下列異動：
| 內容 API | 商家 API | 說明 |
bestSellers.countryCode：字串
|
reportCountryCode：字串
|
「countryCode」欄位已重新命名為「reportCountryCode」
|
bestSellers.categoryId: int
|
reportCategoryId: int
|
「categoryId」欄位已重新命名為「reportCategoryId」
|
競爭曝光率
Merchant Reporting API 中的競爭曝光率檢視畫面異動如下：
| 內容 API | 商家 API | 說明 |
competitiveVisibility.countryCode：字串
|
reportCountryCode：字串
|
「countryCode」欄位已重新命名為「reportCountryCode」
|
competitiveVisibility.categoryId：整數
|
reportCategoryId：整數
|
「categoryId」欄位已重新命名為「reportCategoryId」
|