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

Satıcı Raporlarını nasıl entegre edebileceğiniz aşağıda açıklanmıştır: API'yi kullanarak mevcut Content API'niz Alışveriş uygulaması.

İstekler

Satıcı Raporları API'si 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, Content API for Shopping'in Satıcı ile örnek bir karşılaştırması verilmiştir search istekleri için Reports API:

Content API Satıcı API'si
URL https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/reports/search https://merchantapi.googleapis.com/reports/v1beta/{parent}/reports:search
Tanımlayıcılar {merchantId} {parent}

Yöntemler

Rapor Yöneticisi'nin ReportService.Search yöntemidir.

Görüntüleme sayısı

Merchant API'de, CammelCase olan tablo adları snake_case olarak değiştirilir.

MerchantPerformanceView artık product_performance_view.

Aşağıda, Content API for Shopping'deki tablo adları ile Satıcı API'si:

Content API Satıcı API'si
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 bir alan öneki belirterek (ör. segments.offer_id) artık gerekli değil. Bunun yerine, offer_id alan adını kullanmanız yeterlidir.

Burada, Content API for Shopping'deki sorgular ile Satıcı API'si:

Content API Satıcı API'si 
   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 Satıcı API'si 
{
  "segments":{
    "offerId":"abc"
  },
  "metrics":{
    "clicks":"123"
  }
}

{
  "productPerformanceView" : {
    "offerId": "abc",
    "clicks": "123"
  }
}

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

Performans

Merchant Reports API'deki performans görünümüyle ilgili değişiklikleri aşağıda bulabilirsiniz:

Content API Satıcı API'si Açıklama
segments.program: dize marketing_method: dize program segmenti, yeni bir marketing_method alanıyla değiştirildi. 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)
} 		Tutar mikroları ve para birimi alanları Price türüyle tek bir alanda birleştirilir
metrics.orders,
metrics.orderedItems,
… 		Desteklenmiyor Google ile Satın Al metrikleri, Satıcı Raporları API'sinde desteklenmez

Yeni pazarlama yöntemi değerleri

segments.program ile marketing_method değerleri arasındaki eşleme şöyledir:

Content API Satıcı API'si
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üyle ilgili değişiklikleri aşağıda bulabilirsiniz:

Content API Satıcı API'si Açıklama
productView.id: dize id: dize channel:language:targetCountry:offerId olan alan biçimi
channel~language~feedLabel~offerId olarak değişir
productView.priceMicros: tam sayı
productView.currencyCode: dize 		price: {
object (Price)
} 		Tutar mikroları ve para birimi alanları Price türüyle 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üyle ilgili değişiklikleri aşağıda bulabilirsiniz:

Content API Satıcı API'si Açıklama
productView.id: dize id: dize channel:language:targetCountry:offerId olan alan biçimi channel~language~feedLabel~offerId olarak değişir
productView.priceMicros: tam sayı
productView.currencyCode: dize 		price: {
object (Price)
} 		Tutar mikroları ve para birimi alanları Price türüyle tek bir alanda birleştirilir
priceInsights.suggestedPriceMicros: tam sayı
priceInsights.suggestedPriceCurrencyCode: dize 		suggestedPrice: {
object (Price)
} 		Tutar mikroları ve para birimi alanları Price türüyle tek bir alanda birleştirilir
priceInsights.predictedGrossProfitChangeFraction: çift
priceInsights.predictedMonthlyGrossProfitChangeMicros: tam sayı
priceInsights.predictedMonthlyGrossProfitChangeCurrencyCode: dize 		Desteklenmiyor Brüt kâr değişikliğiyle ilgili alanlar Merchant Reports API'de desteklenmiyor

Fiyat Rekabetçiliği

Satıcı Raporları'ndaki fiyat rekabetçiliği görünümüyle ilgili değişiklikleri aşağıda bulabilirsiniz API:

Content API Satıcı API'si Açıklama
productView.id: dize id: dize channel:language:targetCountry:offerId olan alan biçimi channel~language~feedLabel~offerId olarak değişir
productView.priceMicros: tam sayı
productView.currencyCode: dize 		price: {
object (Price)
} 		Tutar mikroları ve para birimi alanları Price türüyle 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)
} 		Tutar mikroları ve para birimi alanları Price türüyle tek bir alanda birleştirilir

Çok satanlar

Satıcı Raporları API'sindeki çok satanlar görünümleriyle ilgili değişiklikleri aşağıda bulabilirsiniz:

Content API Satıcı API'si 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 görünürlük rekabeti görünümlerinde yapılan değişiklikler:

Content API Satıcı API'si 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ı

Önceki
Dönüşüm kaynakları yönetimini taşı
Sonraki
Yerel feed'ler iş ortaklığı yönetimini taşıyın