Content API for Shopping'den raporları taşıma

Satıcı Raporları API'yi mevcut Content API for Shopping uygulamanızla nasıl entegre edebileceğinizi burada bulabilirsiniz.

İstekler

Merchant Reports API için aşağıdaki istek URL'si biçimini kullanın:

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

Aşağıda, search istekleri için Content API for Shopping ile Merchant Reports API'nin karşılaştırmasını görebilirsiniz:

Content API Merchant API
URL https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/reports/search https://merchantapi.googleapis.com/reports/v1beta/{PARENT}/reports:search
Tanımlayıcılar {MERCHANT_ID} {PARENT}

Yöntemler

ReportService.Search yöntemini çağırarak Merchant Reports API'yi sorgulayabilirsiniz.

Görüntüleme sayısı

Merchant API'de tablo adları CammelCase yerine snake_case olarak değiştirildi.

MerchantPerformanceView artık product_performance_view.

Content API for Shopping ve Merchant API'deki tablo adları arasındaki eşlemeyi aşağıda bulabilirsiniz:

Content API Merchant 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'de artık segments.offer_id gibi bir alan ön ekiyle belirtme zorunluluğu yoktur. Bunun yerine, offer_id alan adını kullanın.

Content API for Shopping ve Merchant API'deki sorguların örnek bir karşılaştırmasını aşağıda bulabilirsiniz:

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

Aşağıda örnek bir yanıt verilmiştir:

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

Tablo adı, alan ön eki olarak kullanılabilir. Örneğin, Merchant API sorgusunda hem offer_id hem de product_performance_view.offer_id kabul edilir.

Performans

Merchant Reports API'deki performans görünümünde yapılan değişiklikler aşağıda açıklanmıştır:

Content API Merchant API Açıklama
segments.program: dize marketing_method: dize program segmenti yeni bir marketing_method alanıyla değiştirilir. Ayrıntılar için Yeni marketing method değerleri bölümüne bakın.
metrics.ctr: çift clickThroughRate: çift ctr metriği, clickThroughRate olarak yeniden adlandırıldı
metrics.conversionValueMicros: tam sayı
segments.currencyCode: dize
conversionValue: {
object (Price)
}
Mikro tutarlar ve para birimi alanları, Price türüne sahip tek bir alanda birleştirilir
metrics.orders,
metrics.orderedItems,
Desteklenmiyor Google ile Satın Al metrikleri Merchant Reports API'de desteklenmez

Yeni pazarlama yöntemi değerleri

segments.program ve marketing_method değerleri arasındaki eşleme şu şekildedir:

Content API Merchant API
SHOPPING_ADS ADS
FREE_PRODUCT_LISTING ORGANIC
FREE_LOCAL_PRODUCT_LISTING ORGANIC
BUY_ON_GOOGLE_LISTING Desteklenmiyor

Ürün

Merchant Reports API'deki ürün görünümünde yapılan değişiklikler aşağıda açıklanmıştır:

Content API Merchant API Açıklama
productView.id: dize id: dize Alan biçimi channel:language:targetCountry:offerId yerine
channel~language~feedLabel~offerId olarak değiştirilir.
productView.priceMicros: tam sayı
productView.currencyCode: dize
price: {
object (Price)
}
Mikro tutarlar ve para birimi alanları, Price türüne sahip tek bir alanda birleştirilir
productView.aggregated_destination_status: dize aggregated_reporting_context_status: dize aggregated_destination_status alanı aggregated_reporting_context_status olarak yeniden adlandırıldı, değerler değişmedi
productView.item_issues: [
{
object (ItemIssue)
}
]
item_issues: [
{
object (ItemIssue)
}
]
ItemIssue tanımı değişti
Desteklenmiyor feedLabel: dize feedLabel alanı kullanıma sunuldu

Fiyat Analizleri

Merchant Reports API'deki fiyat analizleri görünümünde yapılan değişiklikleri aşağıda bulabilirsiniz:

Content API Merchant API Açıklama
productView.id: dize id: dize Alan biçimi channel:language:targetCountry:offerId yerine channel~language~feedLabel~offerId olarak değiştirilir.
productView.priceMicros: tam sayı
productView.currencyCode: dize
price: {
object (Price)
}
Mikro tutarlar ve para birimi alanları, Price türüne sahip tek bir alanda birleştirilir
priceInsights.suggestedPriceMicros: tam sayı
priceInsights.suggestedPriceCurrencyCode: dize
suggestedPrice: {
object (Price)
}
Mikro tutarlar ve para birimi alanları, Price türüne sahip tek bir alanda birleştirilir
priceInsights.predictedGrossProfitChangeFraction: çift temsili sayı
priceInsights.predictedMonthlyGrossProfitChangeMicros: tam sayı
priceInsights.predictedMonthlyGrossProfitChangeCurrencyCode: dize
Desteklenmiyor Brüt kâr değişikliğiyle ilgili alanlar Merchant Reports API'de desteklenmez.

Fiyat Rekabeti

Merchant Reports API'deki fiyat rekabetçiliği görünümünde yapılan değişiklikler aşağıda açıklanmıştır:

Content API Merchant API Açıklama
productView.id: dize id: dize Alan biçimi channel:language:targetCountry:offerId yerine channel~language~feedLabel~offerId olarak değiştirilir.
productView.priceMicros: tam sayı
productView.currencyCode: dize
price: {
object (Price)
}
Mikro tutarlar ve para birimi alanları, Price türüne sahip tek bir alanda birleştirilir
priceCompetitiveness.countryCode: dize reportCountryCode: dize countryCode alanı, reportCountryCode olarak yeniden adlandırıldı
priceCompetitiveness.benchmarkPriceMicros: tam sayı
priceCompetitiveness.benchmarkPriceCurrencyCode: dize
benchmarkPrice: {
object (Price)
}
Mikro tutarlar ve para birimi alanları, Price türüne sahip tek bir alanda birleştirilir

En çok satanlar

Merchant Reports API'deki çok satanlar görünümlerinde yapılan değişiklikler aşağıda açıklanmıştır:

Content API Merchant API Açıklama
bestSellers.countryCode: dize reportCountryCode: dize countryCode alanı, reportCountryCode olarak yeniden adlandırıldı
bestSellers.categoryId: int reportCategoryId: int categoryId alanı, reportCategoryId olarak yeniden adlandırıldı

Görünürlük rekabeti

Merchant Reports API'deki rekabetçi görünürlük görünümlerinde yapılan değişiklikler aşağıda açıklanmıştır:

Content API Merchant API Açıklama
competitiveVisibility.countryCode: dize reportCountryCode: dize countryCode alanı, reportCountryCode olarak yeniden adlandırıldı
competitiveVisibility.categoryId: tam sayı reportCategoryId: tam sayı categoryId alanı, reportCategoryId olarak yeniden adlandırıldı