Memigrasikan pelaporan dari Content API for Shopping

Berikut cara mengintegrasikan Laporan Penjual API dengan Content API for yang sudah ada untuk implementasi Shopping.

Permintaan

Gunakan format URL permintaan berikut untuk Merchant Reports API:

POST https://merchantapi.googleapis.com/reports/v1beta/{parent}/reports:search

Berikut contoh perbandingan Content API for Shopping dengan Penjual Reports API untuk permintaan search:

Content API API Penjual
URL https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/reports/search https://merchantapi.googleapis.com/reports/v1beta/{parent}/reports:search
Pengenal {merchantId} {parent}

Metode

Anda dapat membuat kueri Merchant Reports API dengan memanggil ReportService.Search .

Penayangan

Di Merchant API, nama tabel diubah dari CammelCase menjadi snake_case.

MerchantPerformanceView sekarang menjadi product_performance_view.

Berikut adalah pemetaan antara nama tabel di Content API for Shopping dan API Penjual:

Content API API Penjual
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

Di Merchant API, menentukan awalan kolom, misalnya, segments.offer_id tidak lagi diperlukan. Sebagai gantinya, cukup gunakan nama kolom, offer_id.

Berikut contoh perbandingan kueri di Content API for Shopping dan API Penjual:

Content API API Penjual
   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
   

Berikut adalah contoh respons:

Content API API Penjual
{
  "segments":{
    "offerId":"abc"
  },
  "metrics":{
    "clicks":"123"
  }
}
{
  "productPerformanceView" : {
    "offerId": "abc",
    "clicks": "123"
  }
}

Nama tabel dapat digunakan sebagai awalan kolom. Misalnya, offer_id dan product_performance_view.offer_id diterima di kueri Merchant API.

Performa

Berikut yang berubah untuk tampilan performa di Merchant Reports API:

Content API API Penjual Deskripsi
segments.program: string marketing_method: string Segmen program diganti dengan kolom marketing_method baru. Lihat Nilai marketing method baru untuk mengetahui detailnya.
metrics.ctr: ganda clickThroughRate: ganda Nama metrik ctr diganti menjadi clickThroughRate
metrics.conversionValueMicros: bilangan bulat
segments.currencyCode: string
conversionValue: {
object (Price)
}
Kolom jumlah mikro dan mata uang digabungkan menjadi satu kolom dengan jenis Price
metrics.orders,
metrics.orderedItems,
Tidak didukung Metrik Beli dengan Google tidak didukung di Merchant Reports API

Nilai metode pemasaran baru

Berikut adalah pemetaan antara nilai segments.program dan marketing_method:

Content API API Penjual
SHOPPING_ADS ADS
FREE_PRODUCT_LISTING ORGANIC
FREE_LOCAL_PRODUCT_LISTING ORGANIC
BUY_ON_GOOGLE_LISTING Tidak didukung

Produk

Berikut yang berubah untuk tampilan produk di Merchant Reports API:

Content API API Penjual Deskripsi
productView.id: string id: string Format kolom berubah dari channel:language:targetCountry:offerId menjadi
channel~language~feedLabel~offerId
productView.priceMicros: bilangan bulat
productView.currencyCode: string
price: {
object (Price)
}
Kolom jumlah mikro dan mata uang digabungkan menjadi satu kolom dengan jenis Price
productView.aggregated_destination_status: string aggregated_reporting_context_status: string Kolom aggregated_destination_status diganti namanya menjadi aggregated_reporting_context_status, nilai tidak berubah
productView.item_issues: [
{
object (ItemIssue)
}
]
item_issues: [
{
object (ItemIssue)
}
]
Definisi ItemIssue telah berubah
Tidak didukung feedLabel: string Kolom feedLabel diperkenalkan

Info Harga

Berikut yang berubah untuk tampilan analisis harga di Merchant Reports API:

Content API API Penjual Deskripsi
productView.id: string id: string Format kolom berubah dari channel:language:targetCountry:offerId menjadi channel~language~feedLabel~offerId
productView.priceMicros: bilangan bulat
productView.currencyCode: string
price: {
object (Price)
}
Kolom jumlah mikro dan mata uang digabungkan menjadi satu kolom dengan jenis Price
priceInsights.suggestedPriceMicros: bilangan bulat
priceInsights.suggestedPriceCurrencyCode: string
suggestedPrice: {
object (Price)
}
Kolom jumlah mikro dan mata uang digabungkan menjadi satu kolom dengan jenis Price
priceInsights.predictedGrossProfitChangeFraction: ganda
priceInsights.predictedMonthlyGrossProfitChangeMicros: bilangan bulat
priceInsights.predictedMonthlyGrossProfitChangeCurrencyCode: string
Tidak didukung Kolom yang terkait dengan perubahan laba kotor tidak didukung di Merchant Reports API

Daya Saing Harga

Berikut yang berubah untuk tampilan persaingan harga di Laporan Penjual API:

Content API API Penjual Deskripsi
productView.id: string id: string Format kolom berubah dari channel:language:targetCountry:offerId menjadi channel~language~feedLabel~offerId
productView.priceMicros: bilangan bulat
productView.currencyCode: string
price: {
object (Price)
}
Kolom jumlah mikro dan mata uang digabungkan menjadi satu kolom dengan jenis Price
priceCompetitiveness.countryCode: string reportCountryCode: string Kolom countryCode diganti namanya menjadi reportCountryCode
priceCompetitiveness.benchmarkPriceMicros: bilangan bulat
priceCompetitiveness.benchmarkPriceCurrencyCode: string
benchmarkPrice: {
object (Price)
}
Kolom jumlah mikro dan mata uang digabungkan menjadi satu kolom dengan jenis Price

Terlaris

Berikut yang berubah untuk tampilan item terlaris di Merchant Reports API:

Content API API Penjual Deskripsi
bestSellers.countryCode: string reportCountryCode: string Kolom countryCode diganti namanya menjadi reportCountryCode
bestSellers.categoryId: int reportCategoryId: int Kolom categoryId diganti namanya menjadi reportCategoryId

Visibilitas kompetitif

Berikut adalah hal yang berubah untuk tampilan visibilitas kompetitif di Merchant Reports API:

Content API API Penjual Deskripsi
competitiveVisibility.countryCode: string reportCountryCode: string Kolom countryCode diganti namanya menjadi reportCountryCode
competitiveVisibility.categoryId: bilangan bulat reportCategoryId: bilangan bulat Kolom categoryId diganti namanya menjadi reportCategoryId