जानें कि 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: {
|
रकम के माइक्रो और मुद्रा फ़ील्ड, Price टाइप के साथ एक फ़ील्ड में मर्ज कर दिए गए हैं
|
metrics.orders,
|
इनकी अनुमति नहीं है | '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: {
|
रकम के माइक्रो और मुद्रा फ़ील्ड, Price टाइप के साथ एक फ़ील्ड में मर्ज कर दिए गए हैं
|
productView.aggregated_destination_status : स्ट्रिंग
|
aggregated_reporting_context_status : स्ट्रिंग
|
aggregated_destination_status फ़ील्ड का नाम बदलकर aggregated_reporting_context_status किया गया है. वैल्यू में कोई बदलाव नहीं किया गया है
|
productView.item_issues: [
|
item_issues: [
|
ItemIssue की परिभाषा बदल गई है
|
इनकी अनुमति नहीं है | feedLabel : स्ट्रिंग
|
feedLabel फ़ील्ड को दिखाया गया
|
कीमत के बारे में अहम जानकारी
यहां बताया गया है कि व्यापारी/कंपनी/कारोबारी के रिपोर्ट एपीआई में, कीमत की अहम जानकारी वाले व्यू में क्या बदलाव हुए हैं:
Content API | व्यापारी/कंपनी का एपीआई | ब्यौरा |
productView.id : स्ट्रिंग
|
id : स्ट्रिंग
|
फ़ील्ड फ़ॉर्मैट, channel:language:targetCountry:offerId से channel~language~feedLabel~offerId में बदल जाता है
|
productView.priceMicros : पूर्णांक
productView.currencyCode : स्ट्रिंग
|
price: {
|
रकम के माइक्रो और मुद्रा फ़ील्ड, Price टाइप के साथ एक फ़ील्ड में मर्ज कर दिए गए हैं
|
priceInsights.suggestedPriceMicros : पूर्णांक
priceInsights.suggestedPriceCurrencyCode : स्ट्रिंग
|
suggestedPrice: {
|
रकम के माइक्रो और मुद्रा फ़ील्ड, 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: {
|
रकम के माइक्रो और मुद्रा फ़ील्ड, Price टाइप के साथ एक फ़ील्ड में मर्ज कर दिए गए हैं
|
priceCompetitiveness.countryCode : स्ट्रिंग
|
reportCountryCode : स्ट्रिंग
|
countryCode फ़ील्ड का नाम बदलकर reportCountryCode किया गया
|
priceCompetitiveness.benchmarkPriceMicros : पूर्णांक
priceCompetitiveness.benchmarkPriceCurrencyCode : स्ट्रिंग
|
benchmarkPrice: {
|
रकम के माइक्रो और मुद्रा फ़ील्ड, 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 किया गया
|