Shopping के लिए Content API से रिपोर्टिंग माइग्रेट करना

जानें कि Merchant रिपोर्ट एपीआई को Shopping के लिए Content API लागू करने की मौजूदा सुविधा के साथ कैसे इंटिग्रेट किया जा सकता है.

अनुरोध

मर्चेंट रिपोर्ट API के लिए, नीचे दिए गए अनुरोध यूआरएल फ़ॉर्मैट का इस्तेमाल करें:

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

यहां search अनुरोधों के लिए, Shopping के लिए Content API और Merchant रिपोर्ट एपीआई की तुलना का सैंपल दिया गया है:

Content API व्यापारी/कंपनी का एपीआई
यूआरएल https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/reports/search https://merchantapi.googleapis.com/reports/v1beta/{parent}/reports:search
आइडेंटिफ़ायर {merchantId} {parent}

तरीके

आपके पास ReportService.Search तरीके को कॉल करके, Merchant Reports API से क्वेरी करने का विकल्प है.

व्यू

Merchant API में, टेबल के नाम CammelCase से बदलकर snake_case किए जाते हैं.

MerchantPerformanceView अब product_performance_view है.

यहां Content API for Shopping और Merchant API में टेबल के नामों के बीच मैपिंग की जानकारी दी गई है:

Content 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 और Merchant API में क्वेरी की तुलना का सैंपल दिया गया है:

Content 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

यहां जवाब का एक उदाहरण दिया गया है:

Content API व्यापारी/कंपनी का एपीआई 
{
  "segments":{
    "offerId":"abc"
  },
  "metrics":{
    "clicks":"123"
  }
}

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

टेबल के नाम का इस्तेमाल, फ़ील्ड के प्रीफ़िक्स के तौर पर किया जा सकता है. उदाहरण के लिए, Merchant API क्वेरी में offer_id और product_performance_view.offer_id, दोनों को स्वीकार किया जाता है.

परफ़ॉर्मेंस

यहां बताया गया है कि Merchant Reports API में, परफ़ॉर्मेंस व्यू में क्या बदलाव हुए हैं:

Content API व्यापारी/कंपनी का एपीआई ब्यौरा
segments.program: स्ट्रिंग marketing_method: स्ट्रिंग program सेगमेंट को नए marketing_method फ़ील्ड से बदल दिया गया है. ज़्यादा जानकारी के लिए, marketing method की नई वैल्यू देखें.
metrics.ctr: डबल clickThroughRate: डबल ctr मेट्रिक का नाम बदलकर clickThroughRate किया गया
metrics.conversionValueMicros: पूर्णांक
segments.currencyCode: स्ट्रिंग 		conversionValue: {
object (Price)
} 		रकम के माइक्रो और मुद्रा फ़ील्ड, Price टाइप के साथ एक फ़ील्ड में मर्ज कर दिए गए हैं
metrics.orders,
metrics.orderedItems,
… 		इनकी अनुमति नहीं है 'Google पर खरीदें' वाली मेट्रिक, Merchant Report API में काम नहीं करतीं

मार्केटिंग के नए तरीके की वैल्यू

यहां segments.program और marketing_method वैल्यू के बीच की मैपिंग दी गई है:

Content API व्यापारी/कंपनी का एपीआई
SHOPPING_ADS ADS
FREE_PRODUCT_LISTING ORGANIC
FREE_LOCAL_PRODUCT_LISTING ORGANIC
BUY_ON_GOOGLE_LISTING इनकी अनुमति नहीं है

प्रॉडक्ट

यहां बताया गया है कि व्यापारी/कंपनी/कारोबारी के रिपोर्ट एपीआई में, प्रॉडक्ट व्यू में क्या बदलाव हुए हैं:

Content API व्यापारी/कंपनी का एपीआई ब्यौरा
productView.id: स्ट्रिंग id: स्ट्रिंग फ़ील्ड फ़ॉर्मैट channel:language:targetCountry:offerId से
channel~language~feedLabel~offerId में बदल जाता है
productView.priceMicros: पूर्णांक
productView.currencyCode: स्ट्रिंग 		price: {
object (Price)
} 		रकम के माइक्रो और मुद्रा फ़ील्ड, Price टाइप के साथ एक फ़ील्ड में मर्ज कर दिए गए हैं
productView.aggregated_destination_status: स्ट्रिंग aggregated_reporting_context_status: स्ट्रिंग aggregated_destination_status फ़ील्ड का नाम बदलकर aggregated_reporting_context_status किया गया है. वैल्यू में कोई बदलाव नहीं किया गया है
productView.item_issues: [
{
object (ItemIssue)
}
] 		item_issues: [
{
object (ItemIssue)
}
] 		ItemIssue की परिभाषा बदल गई है
इनकी अनुमति नहीं है feedLabel: स्ट्रिंग feedLabel फ़ील्ड को दिखाया गया

कीमत के बारे में अहम जानकारी

यहां बताया गया है कि व्यापारी/कंपनी/कारोबारी के रिपोर्ट एपीआई में, कीमत की अहम जानकारी वाले व्यू में क्या बदलाव हुए हैं:

Content API व्यापारी/कंपनी का एपीआई ब्यौरा
productView.id: स्ट्रिंग id: स्ट्रिंग फ़ील्ड फ़ॉर्मैट, channel:language:targetCountry:offerId से channel~language~feedLabel~offerId में बदल जाता है
productView.priceMicros: पूर्णांक
productView.currencyCode: स्ट्रिंग 		price: {
object (Price)
} 		रकम के माइक्रो और मुद्रा फ़ील्ड, Price टाइप के साथ एक फ़ील्ड में मर्ज कर दिए गए हैं
priceInsights.suggestedPriceMicros: पूर्णांक
priceInsights.suggestedPriceCurrencyCode: स्ट्रिंग 		suggestedPrice: {
object (Price)
} 		रकम के माइक्रो और मुद्रा फ़ील्ड, Price टाइप के साथ एक फ़ील्ड में मर्ज कर दिए गए हैं
priceInsights.predictedGrossProfitChangeFraction: डबल
priceInsights.predictedMonthlyGrossProfitChangeMicros: पूर्णांक
priceInsights.predictedMonthlyGrossProfitChangeCurrencyCode: स्ट्रिंग 		इनकी अनुमति नहीं है कुल मुनाफ़े में हुए बदलाव से जुड़े फ़ील्ड, Merchant Reports API में काम नहीं करते

कीमतों की तुलना

यहां बताया गया है कि Merchant Center API में, प्रॉडक्ट की कीमतों की तुलना वाले व्यू में क्या बदलाव हुए हैं:

Content API व्यापारी/कंपनी का एपीआई ब्यौरा
productView.id: स्ट्रिंग id: स्ट्रिंग फ़ील्ड फ़ॉर्मैट, channel:language:targetCountry:offerId से channel~language~feedLabel~offerId में बदल जाता है
productView.priceMicros: पूर्णांक
productView.currencyCode: स्ट्रिंग 		price: {
object (Price)
} 		रकम के माइक्रो और मुद्रा फ़ील्ड, Price टाइप के साथ एक फ़ील्ड में मर्ज कर दिए गए हैं
priceCompetitiveness.countryCode: स्ट्रिंग reportCountryCode: स्ट्रिंग countryCode फ़ील्ड का नाम बदलकर reportCountryCode किया गया
priceCompetitiveness.benchmarkPriceMicros: पूर्णांक
priceCompetitiveness.benchmarkPriceCurrencyCode: स्ट्रिंग 		benchmarkPrice: {
object (Price)
} 		रकम के माइक्रो और मुद्रा फ़ील्ड, Price टाइप के साथ एक फ़ील्ड में मर्ज कर दिए गए हैं

सबसे ज़्यादा बिकने वाले प्रॉडक्ट और ब्रैंड

सबसे ज़्यादा बिकने वाले प्रॉडक्ट और ब्रैंड के व्यू में, मर्चेंट रिपोर्ट एपीआई में हुए बदलावों के बारे में यहां बताया गया है:

Content API व्यापारी/कंपनी का एपीआई ब्यौरा
bestSellers.countryCode: स्ट्रिंग reportCountryCode: स्ट्रिंग countryCode फ़ील्ड का नाम बदलकर reportCountryCode किया गया
bestSellers.categoryId: इंटरसेप्शन reportCategoryId: इंटरसेप्शन categoryId फ़ील्ड का नाम बदलकर reportCategoryId किया गया

आपके जैसे दूसरे कारोबारों की परफ़ॉर्मेंस

यहां बताया गया है कि Merchant Report API में, आपके जैसे दूसरे कारोबारों के प्रॉडक्ट के दिखने की संभावना में क्या बदलाव हुए हैं:

Content API व्यापारी/कंपनी का एपीआई ब्यौरा
competitiveVisibility.countryCode: स्ट्रिंग reportCountryCode: स्ट्रिंग countryCode फ़ील्ड का नाम बदलकर reportCountryCode किया गया
competitiveVisibility.categoryId: पूर्णांक reportCategoryId: पूर्णांक categoryId फ़ील्ड का नाम बदलकर reportCategoryId किया गया

पीछे जाएं
कन्वर्ज़न के सोर्स का मैनेजमेंट माइग्रेट करें
आगे बढ़ें
लोकल फ़ीड पार्टनरशिप मैनेजमेंट को माइग्रेट करना