در اینجا نحوه ادغام Merchant Reports API با Content API موجود برای اجرای خرید آورده شده است.
درخواست ها
از فرمت URL درخواست زیر برای Merchant Reports API استفاده کنید:
POST https://merchantapi.googleapis.com/reports/v1beta/{PARENT} /reports:search
در اینجا نمونه ای از مقایسه Content API برای خرید با Merchant Reports API برای درخواست های search
آمده است:
Content API | Merchant API | |
URL | https://shoppingcontent.googleapis.com/content/v2.1/ | https://merchantapi.googleapis.com/reports/v1beta/ |
شناسه ها | {MERCHANT_ | {PARENT} |
روش ها
می توانید با فراخوانی روش ReportService.Search
از API Merchant Reports پرس و جو کنید.
بازدیدها
در Merchant API، نام جدول از CammelCase
به snake_case
تغییر میکند.
MerchantPerformanceView
اکنون product_performance_view
است.
در اینجا یک نقشه بین نام جدول در Content API برای خرید و Merchant API آمده است:
Content API | Merchant API |
MerchantPerformanceView | product_ |
ProductView | product_ |
PriceCompetitivenesProductView | price_ |
PriceInsightsProductView | price_ |
BestSellersBrandView | best_ |
BestSellersProductClusterView | best_ |
CompetitiveVisibilityCompetitorView | competitive_ |
CompetitiveVisibilityTopMerchantView | competitive_ |
CompetitiveVisibilityBenchmarkView | competitive_ |
در Merchant API، تعیین یک پیشوند فیلد، به عنوان مثال، segments.offer_id
دیگر مورد نیاز نیست. در عوض، فقط از نام فیلد، offer_id
استفاده کنید.
در اینجا نمونه ای از مقایسه پرس و جوها در Content API برای خرید و Merchant API آمده است:
Content API | Merchant API |
SELECT | SELECT |
در اینجا یک نمونه پاسخ آمده است:
Content API | Merchant API |
{ | { |
نام جدول را می توان به عنوان پیشوند فیلد استفاده کرد. برای مثال، هر دو offer_id
و product_performance_view.offer_id
در جستار Merchant API پذیرفته می شوند.
عملکرد
آنچه برای نمای عملکرد در Merchant Reports API تغییر کرده است:
Content API | Merchant API | توضیحات |
segments.program : رشته | marketing_method : رشته | بخش program با یک فیلد marketing_method جدید جایگزین می شود. برای جزئیات بیشتر به مقادیر marketing method جدید مراجعه کنید. |
metrics.ctr : دو برابر | clickThroughRate : دو برابر | متریک ctr به clickThroughRate تغییر نام داد |
metrics.conversionValueMicros : عدد صحیحsegments.currencyCode : رشته | conversionValue: { | فیلدهای مقدار میکرو و ارز در یک فیلد با نوع Price ادغام می شوند |
metrics.orders, | پشتیبانی نمی شود | معیارهای خرید در Google در API گزارشهای تجاری پشتیبانی نمیشوند |
ارزش های روش بازاریابی جدید
در اینجا نگاشت بین مقادیر segments.program
و marketing_method
آمده است:
Content API | Merchant API |
SHOPPING_ADS | ADS |
FREE_PRODUCT_LISTING | ORGANIC |
FREE_LOCAL_PRODUCT_LISTING | ORGANIC |
BUY_ON_GOOGLE_LISTING | پشتیبانی نمی شود |
محصول
آنچه برای نمای محصول در Merchant Reports API تغییر کرده است:
Content API | Merchant 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 معرفی شده است |
بینش قیمت
این چیزی است که برای نمای آماری قیمت در API گزارشهای تجاری تغییر کرده است:
Content API | Merchant 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 : string | پشتیبانی نمی شود | فیلدهای مربوط به تغییر سود ناخالص در API گزارشهای تجاری پشتیبانی نمیشوند |
رقابت پذیری قیمت
آنچه برای نمای رقابتی قیمت در Merchant Reports API تغییر کرده است:
Content API | Merchant API | توضیحات |
productView.id : رشته | id : رشته | قالب فیلد از channel:language:targetCountry:offerId به channel~language~feedLabel~offerId تغییر می کند |
productView.priceMicros : عدد صحیحproductView.currencyCode : رشته | price: { | فیلدهای مقدار میکرو و ارز در یک فیلد با نوع Price ادغام می شوند |
priceCompetitiveness.countryCode : string | reportCountryCode : رشته | فیلد countryCode به reportCountryCode تغییر نام داده است |
priceCompetitiveness.benchmarkPriceMicros : عدد صحیحpriceCompetitiveness.benchmarkPriceCurrencyCode : string | benchmarkPrice: { | فیلدهای مقدار میکرو و ارز در یک فیلد با نوع Price ادغام می شوند |
پرفروش ترین ها
در زیر چه چیزی برای بازدیدهای پرفروش در Merchant Reports API تغییر کرده است:
Content API | Merchant API | توضیحات |
bestSellers.countryCode : string | reportCountryCode : رشته | فیلد countryCode به reportCountryCode تغییر نام داده است |
bestSellers.categoryId : int | reportCategoryId : int | قسمت categoryId به reportCategoryId تغییر نام داده است |
دید رقابتی
در اینجا چه چیزی برای نماهای قابل مشاهده رقابتی در Merchant Reports API تغییر کرده است:
Content API | Merchant API | توضیحات |
competitiveVisibility.countryCode : string | reportCountryCode : رشته | فیلد countryCode به reportCountryCode تغییر نام داده است |
competitiveVisibility.categoryId : عدد صحیح | reportCategoryId : عدد صحیح | قسمت categoryId به reportCategoryId تغییر نام داده است |