نوضّح في ما يلي كيفية دمج Merchant Reports API مع عملية تنفيذ Content API for Shopping الحالية.
الكائن Requests
استخدِم التنسيق التالي لعنوان URL الخاص بالطلب في Merchant Reports API:
POST https://merchantapi.googleapis.com/reports/v1beta/{parent}/reports:search
في ما يلي نموذج للمقارنة بين Content API for Shopping وMerchant
Reports API لطلبات search
:
Content API | واجهة برمجة تطبيقات التاجر | |
عنوان URL | https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/reports/search | https://merchantapi.googleapis.com/reports/v1beta/{parent}/reports:search |
المعرّفات | {merchantId}
|
{parent}
|
الطُرق
يمكنك إجراء طلب بحث في Merchant Reports API من خلال استدعاء الطريقة
ReportService.Search
.
المشاهدات
في 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" } } |
يمكن استخدام اسم الجدول كبادئة حقل. على سبيل المثال، يمكن قبول كلّ من offer_id
وproduct_performance_view.offer_id
في طلب بحث Merchant 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 Reports 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 |
مكانة السعر في المنافسة
في ما يلي التغييرات التي طرأت على طريقة عرض "مكانة السعر في المنافسة" في واجهة برمجة تطبيقات "تقارير التجار":
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 ".
|
مستوى الظهور التنافسي
في ما يلي التغييرات التي طرأت على طرق العرض التنافسية لمستوى الظهور في واجهة برمجة تطبيقات تقارير التجار:
Content API | واجهة برمجة تطبيقات التاجر | الوصف |
competitiveVisibility.countryCode : سلسلة
|
reportCountryCode : سلسلة
|
تمت إعادة تسمية حقل "countryCode " إلى "reportCountryCode ".
|
competitiveVisibility.categoryId : عدد صحيح
|
reportCategoryId : عدد صحيح
|
تمت إعادة تسمية حقل "categoryId " إلى "reportCategoryId ".
|