انتقال گزارش از Content API برای خرید

شما می‌توانید از طریق نمای داده‌ای که Merchant Reports API ارائه می‌دهد، در مورد محصولات خود، عملکرد آنها و محیط رقابتی آنها در گوگل اطلاعات کسب کنید.

شما می‌توانید از رابط برنامه‌نویسی کاربردی گزارش‌های فروشنده (Merchant Reports API) برای انجام موارد زیر استفاده کنید:

در اینجا نحوه ادغام API گزارش‌های فروشنده با API محتوای موجود برای پیاده‌سازی خرید شما آورده شده است.

درخواست‌ها

از فرمت URL درخواست زیر برای Merchant Reports API استفاده کنید:

POST https://merchantapi.googleapis.com/reports/v1/{PARENT}/reports:search

در اینجا یک مقایسه نمونه از API محتوا برای خرید با API گزارش‌های فروشنده برای درخواست‌های search آورده شده است:

رابط برنامه‌نویسی کاربردی محتوا رابط برنامه‌نویسی کاربردی (API) فروشنده
آدرس اینترنتی https://shoppingcontent.googleapis.com/content/v2.1/ {MERCHANT_ID} /reports/search https://merchantapi.googleapis.com/reports/v1/ {PARENT} /reports:search
شناسه‌ها {MERCHANT_ID} {PARENT}

روش‌ها

شما می‌توانید با فراخوانی متد ReportService.Search از رابط برنامه‌نویسی کاربردی گزارش‌های فروشنده (Merchant Reports API) پرس‌وجو کنید.

بازدیدها

در رابط برنامه‌نویسی کاربردی فروشنده (Merchant API)، نام جدول‌ها از CamelCase به snake_case تغییر یافته است.

MerchantPerformanceView اکنون product_performance_view است.

در اینجا نگاشتی بین نام جداول در API محتوا برای خرید و API فروشنده (Merchant API) مشاهده می‌کنید:

رابط برنامه‌نویسی کاربردی محتوا رابط برنامه‌نویسی کاربردی (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 ، استفاده کنید.

در اینجا مقایسه‌ای از پرس‌وجوها در رابط برنامه‌نویسی کاربردی محتوا برای خرید و رابط برنامه‌نویسی کاربردی فروشنده (Merchant API) ارائه شده است:

رابط برنامه‌نویسی کاربردی محتوا رابط برنامه‌نویسی کاربردی (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

در اینجا یک نمونه پاسخ آمده است:

رابط برنامه‌نویسی کاربردی محتوا رابط برنامه‌نویسی کاربردی (API) فروشنده 
{
  "segments":{
    "offerId":"abc"
  },
  "metrics":{
    "clicks":"123"
  }
}
{
  "productPerformanceView" : {
    "offerId": "abc",
    "clicks": "123"
  }
}

نام جدول می‌تواند به عنوان پیشوند فیلد استفاده شود. برای مثال، هر دو offer_id و product_performance_view.offer_id در کوئری Merchant API پذیرفته می‌شوند.

عملکرد

در اینجا تغییراتی که در نمای عملکرد در رابط برنامه‌نویسی کاربردی گزارش‌های فروشندگان (Merchant Reports API) ایجاد شده است را مشاهده می‌کنید:

رابط برنامه‌نویسی کاربردی محتوا رابط برنامه‌نویسی کاربردی (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,
…		 پشتیبانی نمی‌شود معیارهای خرید از گوگل در رابط برنامه‌نویسی کاربردی گزارش‌های فروشندگان پشتیبانی نمی‌شوند.

ارزش‌های روش‌های جدید بازاریابی

در اینجا نگاشت بین مقادیر segments.program و marketing_method را مشاهده می‌کنید:

رابط برنامه‌نویسی کاربردی محتوا رابط برنامه‌نویسی کاربردی (API) فروشنده
SHOPPING_ADS ADS
FREE_PRODUCT_LISTING ORGANIC
FREE_LOCAL_PRODUCT_LISTING ORGANIC
BUY_ON_GOOGLE_LISTING پشتیبانی نمی‌شود

محصول

در اینجا تغییراتی که در نمای محصول در رابط برنامه‌نویسی کاربردی گزارش‌های فروشنده (Merchant Reports API) ایجاد شده است را مشاهده می‌کنید:

رابط برنامه‌نویسی کاربردی محتوا رابط برنامه‌نویسی کاربردی (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 معرفی شد

بینش قیمت

در اینجا تغییراتی که در نمای بینش قیمت در رابط برنامه‌نویسی کاربردی گزارش‌های فروشندگان (Merchant Reports API) ایجاد شده است را مشاهده می‌کنید:

رابط برنامه‌نویسی کاربردی محتوا رابط برنامه‌نویسی کاربردی (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) ایجاد شده است را مشاهده می‌کنید:

رابط برنامه‌نویسی کاربردی محتوا رابط برنامه‌نویسی کاربردی (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 ادغام می‌شوند.

پرفروش‌ترین‌ها

در اینجا تغییراتی که برای نمایش پرفروش‌ترین‌ها در رابط برنامه‌نویسی کاربردی گزارش‌های فروشندگان (Merchant Reports API) ایجاد شده است را مشاهده می‌کنید:

رابط برنامه‌نویسی کاربردی محتوا رابط برنامه‌نویسی کاربردی (API) فروشنده توضیحات
bestSellers.countryCode : رشته reportCountryCode : رشته فیلد countryCode به reportCountryCode تغییر نام داده است.
bestSellers.categoryId : عدد صحیح reportCategoryId : عدد صحیح فیلد categoryId به reportCategoryId تغییر نام داده است.

دیده شدن در رقابت

در اینجا تغییراتی که برای نماهای رقابتی در Merchant Reports API ایجاد شده است را مشاهده می‌کنید:

رابط برنامه‌نویسی کاربردی محتوا رابط برنامه‌نویسی کاربردی (API) فروشنده توضیحات
competitiveVisibility.countryCode : رشته reportCountryCode : رشته فیلد countryCode به reportCountryCode تغییر نام داده است.
competitiveVisibility.categoryId : عدد صحیح reportCategoryId : عدد صحیح فیلد categoryId به reportCategoryId تغییر نام داده است.

قبلی
Migrate conversion sources management
بعدی
Migrate local feeds partnership management