販売者レポートを統合する方法は次のとおりです。 API を既存の Content API for Education の ショッピングの実装。
リクエスト
Merchant Reports API には、次のリクエスト URL 形式を使用します。
POST https://merchantapi.googleapis.com/reports/v1beta/{parent}/reports:search
Content API for Shopping と販売者の比較例
search リクエスト用の Reports API:
| コンテンツ API | 販売者 API | |
| URL | https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/reports/search | https://merchantapi.googleapis.com/reports/v1beta/{parent}/reports:search |
| ID | {merchantId}
|
{parent}
|
メソッド
Merchant Reports API にクエリを実行するには、
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 と
product_performance_view.offer_id が Merchant API クエリで受け入れられます。
パフォーマンス
Merchant Reports API のパフォーマンス ビューの変更点は次のとおりです。
| コンテンツ API | 販売者 API | 説明 |
segments.program: 文字列
|
marketing_method: 文字列
|
program セグメントが新しい marketing_method フィールドに置き換えられました。詳細については、新しい marketing method 値をご覧ください。
|
metrics.ctr: double 型
|
clickThroughRate: double 型
|
指標「ctr」の名前が「clickThroughRate」に変更されました
|
metrics.conversionValueMicros: 整数
segments.currencyCode: 文字列
|
conversionValue: {
|
金額のマイクロと通貨のフィールドを 1 つのフィールド（Price 型）に統合しました
|
metrics.orders,
|
サポート対象外 | Merchant Reports API では「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: {
|
金額のマイクロと通貨のフィールドを 1 つのフィールド（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 Reports API の価格分析ビューの変更点は次のとおりです。
| コンテンツ API | 販売者 API | 説明 |
productView.id: 文字列
|
id: 文字列
|
フィールドの形式が channel:language:targetCountry:offerId から channel~language~feedLabel~offerId に変更されます。
|
productView.priceMicros: 整数
productView.currencyCode: 文字列
|
price: {
|
金額のマイクロと通貨のフィールドを 1 つのフィールド（Price 型）に統合しました
|
priceInsights.suggestedPriceMicros: 整数
priceInsights.suggestedPriceCurrencyCode: 文字列
|
suggestedPrice: {
|
金額のマイクロと通貨のフィールドを 1 つのフィールド（Price 型）に統合しました
|
priceInsights.predictedGrossProfitChangeFraction: double 型
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: {
|
金額のマイクロと通貨のフィールドを 1 つのフィールド（Price 型）に統合しました
|
priceCompetitiveness.countryCode: 文字列
|
reportCountryCode: 文字列
|
countryCode フィールドの名前が reportCountryCode に変更されました。
|
priceCompetitiveness.benchmarkPriceMicros: 整数
priceCompetitiveness.benchmarkPriceCurrencyCode: 文字列
|
benchmarkPrice: {
|
金額のマイクロと通貨のフィールドを 1 つのフィールド（Price 型）に統合しました
|
ベストセラー
Merchant Reports API のベストセラー ビューの変更点は次のとおりです。
| コンテンツ API | 販売者 API | 説明 |
bestSellers.countryCode: 文字列
|
reportCountryCode: 文字列
|
countryCode フィールドの名前が reportCountryCode に変更されました。
|
bestSellers.categoryId: 整数
|
reportCategoryId: 整数
|
categoryId フィールドの名前が reportCategoryId に変更されました。
|
競合視認性
Merchant Reports API の競合視認性ビューの変更点は次のとおりです。
| コンテンツ API | 販売者 API | 説明 |
competitiveVisibility.countryCode: 文字列
|
reportCountryCode: 文字列
|
countryCode フィールドの名前が reportCountryCode に変更されました。
|
competitiveVisibility.categoryId: 整数
|
reportCategoryId: 整数
|
categoryId フィールドの名前が reportCategoryId に変更されました。
|