نقل التقارير من Content API for Shopping

نوضّح في ما يلي كيفية دمج 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: {
object (Price)
} 		تم دمج حقول العملة والمبلغ بالمايكرو في حقل واحد بالنوع Price.
metrics.orders,
metrics.orderedItems,
… 		غير متاح لا يمكن استخدام مقاييس "الشراء على 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: {
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

مكانة السعر في المنافسة

في ما يلي التغييرات التي طرأت على طريقة عرض "مكانة السعر في المنافسة" في واجهة برمجة تطبيقات "تقارير التجار":

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".

مستوى الظهور التنافسي

في ما يلي التغييرات التي طرأت على طرق العرض التنافسية لمستوى الظهور في واجهة برمجة تطبيقات تقارير التجار:

Content API واجهة برمجة تطبيقات التاجر الوصف
competitiveVisibility.countryCode: سلسلة reportCountryCode: سلسلة تمت إعادة تسمية حقل "countryCode" إلى "reportCountryCode".
competitiveVisibility.categoryId: عدد صحيح reportCategoryId: عدد صحيح تمت إعادة تسمية حقل "categoryId" إلى "reportCategoryId".

السابق
إدارة مصادر الإحالات الناجحة
التالي
نقل بيانات إدارة الشراكة في الخلاصات المحلية