این صفحه به‌وسیله ‏Cloud Translation API‏ ترجمه شده است.

Package google.shopping.merchant.reports.v1beta

شاخص

ReportService (رابط)
BestSellersBrandView (پیام)
BestSellersProductClusterView (پیام)
BestSellersProductClusterView.InventoryStatus (enum)
CompetitiveVisibilityBenchmarkView (پیام)
CompetitiveVisibilityCompetitorView (پیام)
CompetitiveVisibilityTopMerchantView (پیام)
MarketingMethod (پیام)
MarketingMethod.MarketingMethodEnum (enum)
NonProductPerformanceView (پیام)
PriceCompetitivenessProductView (پیام)
PriceInsightsProductView (پیام)
PriceInsightsProductView.Effectiveness (تعدادی)
ProductPerformanceView (پیام)
ProductView (پیام)
ProductView.AggregatedReportingContextStatus (در فهرست)
ProductView.ClickPotential (enum)
ProductView.ItemIssue (پیام)
ProductView.ItemIssue.ItemIssueResolution (enum)
ProductView.ItemIssue.ItemIssueSeverity (پیام)
ProductView.ItemIssue.ItemIssueSeverity.AggregatedIssueSeverity (enum)
ProductView.ItemIssue.ItemIssueSeverity.IssueSeverityPerReportingContext (پیام)
ProductView.ItemIssue.ItemIssueType (پیام)
RelativeDemand (پیام)
RelativeDemand.RelativeDemandEnum (enum)
RelativeDemandChangeType (پیام)
RelativeDemandChangeType.RelativeDemandChangeTypeEnum (enum)
ReportGranularity (پیام)
ReportGranularity.ReportGranularityEnum (enum)
ReportRow (پیام)
SearchRequest (پیام)
SearchResponse (پیام)
TrafficSource (پیام)
TrafficSource.TrafficSourceEnum (enum)

گزارش سرویس

خدماتی برای بازیابی گزارش ها و اطلاعات بینش در مورد محصولات شما، عملکرد آنها و محیط رقابتی آنها در Google.

جستجو کنید

جستجو کنید
`rpc Search( SearchRequest ) returns ( SearchResponse )` یک گزارش تعریف شده توسط یک عبارت جستجو را بازیابی می کند. پاسخ ممکن است دارای ردیف های کمتری نسبت به `page_size` باشد. برای تعیین اینکه آیا ردیف های بیشتری برای درخواست وجود دارد یا خیر، به `next_page_token` تکیه کنید. محدوده مجوز به محدوده OAuth زیر نیاز دارد: `https://www.googleapis.com/auth/content` برای اطلاعات بیشتر، بهOAuth 2.0 Overview .

rpc Search( SearchRequest ) returns ( SearchResponse )

یک گزارش تعریف شده توسط یک عبارت جستجو را بازیابی می کند. پاسخ ممکن است دارای ردیف های کمتری نسبت به page_size باشد. برای تعیین اینکه آیا ردیف های بیشتری برای درخواست وجود دارد یا خیر، به next_page_token تکیه کنید.

محدوده مجوز

به محدوده OAuth زیر نیاز دارد:

https://www.googleapis.com/auth/content

برای اطلاعات بیشتر، بهOAuth 2.0 Overview .

BestSellersBrandView

فیلدهای موجود برای پرس و جو در جدول best_sellers_brand_view .

گزارش پرفروش ها با برندهای برتر.

مقادیر فقط برای فیلدهایی که به صراحت در عبارت جستجوی درخواست درخواست شده اند تنظیم می شوند.

فیلدها
`report_ date`	`Date` تاریخ گزارش. مقدار این فیلد فقط می تواند یکی از موارد زیر باشد: اولین روز هفته (دوشنبه) برای گزارش های هفتگی، اولین روز ماه برای گزارش های ماهانه. در بند `SELECT` مورد نیاز است. اگر شرط `WHERE` در `report_date` در پرس و جو مشخص نشده باشد، آخرین گزارش هفتگی یا ماهانه موجود برگردانده می شود.
`report_ granularity`	`ReportGranularityEnum` جزئیات گزارش رتبه بندی را می توان در بازه زمانی یک هفته یا یک ماه انجام داد. در بند `SELECT` مورد نیاز است. شرط `report_granularity` در بند `WHERE` الزامی است.
`report_ country_ code`	`string` کشوری که رتبه در آن محاسبه می شود. در قالب ISO 3166 ارائه شده است. در بند `SELECT` مورد نیاز است. شرط `report_country_code` در بند `WHERE` الزامی است.
`report_ category_ id`	`int64` شناسه دسته‌بندی محصول Google برای محاسبه رتبه‌بندی، که در طبقه‌بندی محصولات Google نشان داده شده است. در بند `SELECT` مورد نیاز است. اگر شرط `WHERE` در `report_category_id` در پرس و جو مشخص نشده باشد، رتبه‌بندی برای همه دسته‌های سطح بالا بازگردانده می‌شود.
`brand`	`string` نام برند.
`rank`	`int64` محبوبیت برند در تبلیغات و سطوح ارگانیک، در دسته بندی و کشور انتخابی، بر اساس تعداد تخمینی تعداد واحدهای فروخته شده.
`previous_ rank`	`int64` رتبه محبوبیت در هفته یا ماه قبل.
`relative_ demand`	`RelativeDemandEnum` تقاضای تخمینی در رابطه با نام تجاری با بالاترین رتبه محبوبیت در همان دسته و کشور.
`previous_ relative_ demand`	`RelativeDemandEnum` تقاضای تخمینی در رابطه با نام تجاری با بالاترین رتبه محبوبیت در همان دسته و کشور در هفته یا ماه قبل.
`relative_ demand_ change`	`RelativeDemandChangeTypeEnum` تغییر در تقاضای تخمینی خواه بالا آمد، غرق شد یا صاف ماند.

پرفروش ترین محصولClusterView

فیلدهای موجود برای پرس و جو در جدول best_sellers_product_cluster_view .

گزارش پرفروش‌ها با خوشه‌های محصول برتر. خوشه محصول گروهی برای پیشنهادات و انواع مختلف است که نشان دهنده یک محصول است، به عنوان مثال، Google Pixel 7.

مقادیر فقط برای فیلدهایی که به صراحت در عبارت جستجوی درخواست درخواست شده اند تنظیم می شوند.

فیلدها
`report_ date`	`Date` تاریخ گزارش. مقدار این فیلد فقط می تواند یکی از موارد زیر باشد: اولین روز هفته (دوشنبه) برای گزارش های هفتگی، اولین روز ماه برای گزارش های ماهانه. در بند `SELECT` مورد نیاز است. اگر شرط `WHERE` در `report_date` در پرس و جو مشخص نشده باشد، آخرین گزارش هفتگی یا ماهانه موجود برگردانده می شود.
`variant_ gtins[]`	`string` GTIN انواع نمونه از خوشه محصول.
`report_ granularity`	`ReportGranularityEnum` جزئیات گزارش رتبه بندی را می توان در بازه زمانی یک هفته یا یک ماه انجام داد. در بند `SELECT` مورد نیاز است. شرط `report_granularity` در بند `WHERE` الزامی است.
`report_ country_ code`	`string` کشوری که رتبه در آن محاسبه می شود. در قالب ISO 3166 ارائه شده است. در بند `SELECT` مورد نیاز است. شرط `report_country_code` در بند `WHERE` الزامی است.
`report_ category_ id`	`int64` شناسه دسته‌بندی محصول Google برای محاسبه رتبه‌بندی، که در طبقه‌بندی محصولات Google نشان داده شده است. در بند `SELECT` مورد نیاز است. اگر شرط `WHERE` در `report_category_id` در پرس و جو مشخص نشده باشد، رتبه‌بندی برای همه دسته‌های سطح بالا بازگردانده می‌شود.
`title`	`string` عنوان خوشه محصول.
`brand`	`string` نام تجاری خوشه محصول.
`category_ l1`	`string` دسته محصول (سطح 1) خوشه محصول، که در طبقه بندی محصولات Google نشان داده شده است.
`category_ l2`	`string` دسته محصول (سطح دوم) خوشه محصول، که در طبقه بندی محصولات Google نشان داده شده است.
`category_ l3`	`string` دسته محصول (سطح سوم) خوشه محصول، که در طبقه بندی محصولات Google نشان داده شده است.
`category_ l4`	`string` دسته محصول (سطح 4) خوشه محصول، که در طبقه بندی محصولات Google نشان داده شده است.
`category_ l5`	`string` دسته محصول (سطح 5) خوشه محصول، که در طبقه بندی محصولات Google نشان داده شده است.
`inventory_ status`	`InventoryStatus` چه خوشه محصول در منبع داده محصول شما حداقل در یکی از کشورها `IN_STOCK` باشد، چه در منبع داده محصول شما در همه کشورها `OUT_OF_STOCK` یا اصلاً `NOT_IN_INVENTORY` . این فیلد فیلتر کشور گزارش پرفروش‌ترین‌ها را در نظر نمی‌گیرد.
`brand_ inventory_ status`	`InventoryStatus` خواه حداقل یک محصول از نام تجاری در حال حاضر `IN_STOCK` در منبع داده محصول شما در حداقل یکی از کشورها وجود داشته باشد، همه محصولات در منبع داده محصول شما در همه کشورها `OUT_OF_STOCK` هستند یا `NOT_IN_INVENTORY` . این فیلد فیلتر کشور گزارش پرفروش‌ترین‌ها را در نظر نمی‌گیرد.
`rank`	`int64` محبوبیت خوشه محصول در تبلیغات و سطوح ارگانیک، در دسته و کشور انتخاب شده، بر اساس تعداد تخمینی واحدهای فروخته شده.
`previous_ rank`	`int64` رتبه محبوبیت در هفته یا ماه قبل.
`relative_ demand`	`RelativeDemandEnum` برآورد تقاضا در رابطه با خوشه محصول با بالاترین رتبه محبوبیت در همان دسته و کشور.
`previous_ relative_ demand`	`RelativeDemandEnum` تقاضای تخمینی در رابطه با خوشه محصول با بالاترین رتبه محبوبیت در همان دسته و کشور در هفته یا ماه قبل.
`relative_ demand_ change`	`RelativeDemandChangeTypeEnum` تغییر در تقاضای تخمینی خواه بالا آمد، غرق شد یا صاف ماند.

وضعیت موجودی

وضعیت خوشه محصول یا نام تجاری در موجودی شما.

Enums
`INVENTORY_STATUS_UNSPECIFIED`	مشخص نشده است.
`IN_STOCK`	شما محصولی برای این خوشه محصول یا برند در انبار دارید.
`OUT_OF_STOCK`	شما محصولی برای این خوشه محصول یا نام تجاری در موجودی دارید اما در حال حاضر موجود نیست.
`NOT_IN_INVENTORY`	شما محصولی برای این خوشه محصول یا نام تجاری در موجودی ندارید.

CompetitiveVisibilityBenchmarkView

فیلدهای موجود برای پرس و جو در جدول competitive_visibility_benchmark_view .

گزارش دید رقابتی با معیار دسته بندی.

مقادیر فقط برای فیلدهایی که به صراحت در عبارت جستجوی درخواست درخواست شده اند تنظیم می شوند.

فیلدها
`date`	`Date` تاریخ این ردیف. در بند `SELECT` مورد نیاز است. شرط `date` در بند `WHERE` الزامی است.
`report_ country_ code`	`string` کشوری که برداشت ها ظاهر شد. در بند `SELECT` مورد نیاز است. شرط `report_country_code` در بند `WHERE` الزامی است.
`report_ category_ id`	`int64` شناسه دسته محصول Google برای محاسبه گزارش، که در طبقه‌بندی محصولات Google نشان داده شده است. در بند `SELECT` مورد نیاز است. شرط `report_category_id` در عبارت `WHERE` لازم است.
`traffic_ source`	`TrafficSourceEnum` منبع ترافیک برداشت ها در بند `SELECT` مورد نیاز است.
`your_ domain_ visibility_ trend`	`double` تغییر در نمایان شدن بر اساس نمایش‌های دامنه شما با توجه به شروع محدوده زمانی انتخابی (یا روز اول با نمایش‌های غیر صفر). در بند "WHERE" نمی توان آن را فیلتر کرد.
`category_ benchmark_ visibility_ trend`	`double` تغییر در دید بر اساس برداشت‌ها با توجه به شروع محدوده زمانی انتخاب‌شده (یا روز اول با نمایش‌های غیرصفر) برای مجموعه ترکیبی از بازرگانان با بیشترین دید تقریبی بازار. در بند "WHERE" نمی توان آن را فیلتر کرد.

CompetitiveVisibilityCompetitorView

فیلدهای موجود برای پرس و جو در جدول competitive_visibility_competitor_view .

گزارش دید رقابتی با مشاغل با دید مشابه.

مقادیر فقط برای فیلدهایی که به صراحت در عبارت جستجوی درخواست درخواست شده اند تنظیم می شوند.

فیلدها
`date`	`Date` تاریخ این ردیف. شرط `date` در بند `WHERE` الزامی است.
`domain`	`string` اگر «is_your_domain» درست باشد، دامنه رقیب یا دامنه شما. در بند `SELECT` مورد نیاز است. در بند "WHERE" نمی توان آن را فیلتر کرد.
`is_ your_ domain`	`bool` درست است اگر این ردیف حاوی داده های دامنه شما باشد. در بند "WHERE" نمی توان آن را فیلتر کرد.
`report_ country_ code`	`string` کشوری که برداشت ها ظاهر شد. در بند `SELECT` مورد نیاز است. شرط `report_country_code` در بند `WHERE` الزامی است.
`report_ category_ id`	`int64` شناسه دسته محصول Google برای محاسبه گزارش، که در طبقه‌بندی محصولات Google نشان داده شده است. در بند `SELECT` مورد نیاز است. شرط `report_category_id` در عبارت `WHERE` لازم است.
`traffic_ source`	`TrafficSourceEnum` منبع ترافیک برداشت ها در بند `SELECT` مورد نیاز است.
`rank`	`int64` موقعیت دامنه در رتبه‌بندی کسب‌وکارهای مشابه برای کلیدهای انتخابی ( `date` ، `report_category_id` ، `report_country_code` ، `traffic_source` ) بر اساس برداشت‌ها. 1 بالاترین است. در بند "WHERE" نمی توان آن را فیلتر کرد.
`ads_ organic_ ratio`	`double` نسبت تبلیغات/ارگانیک نشان می‌دهد که دامنه در مقایسه با ترافیک ارگانیک چقدر از آگهی‌های خرید بازدید می‌کند. عدد گرد و سطلی است. در بند "WHERE" نمی توان آن را فیلتر کرد.
`page_ overlap_ rate`	`double` نرخ همپوشانی صفحه نشان می‌دهد که چقدر پیشنهادات خرده‌فروشان رقیب همراه با پیشنهادات شما در یک صفحه نشان داده می‌شوند. در بند "WHERE" نمی توان آن را فیلتر کرد.
`higher_ position_ rate`	`double` نرخ موقعیت بالاتر نشان می دهد که هر چند وقت یکبار پیشنهاد یک رقیب در موقعیت بالاتری نسبت به پیشنهاد شما در صفحه قرار می گیرد. در بند "WHERE" نمی توان آن را فیلتر کرد.
`relative_ visibility`	`double` دید نسبی نشان می دهد که پیشنهادات رقبای شما در مقایسه با پیشنهادات شما چند بار نشان داده می شود. به عبارت دیگر، این تعداد نمایش‌های نمایش‌داده‌شده از یک خرده‌فروش رقیب تقسیم بر تعداد نمایش‌های نمایش‌داده‌شده شما در یک بازه زمانی انتخاب‌شده برای یک دسته محصول و کشور انتخاب‌شده است. در بند "WHERE" نمی توان آن را فیلتر کرد.

CompetitiveVisibilityTopMerchantView

فیلدهای موجود برای پرس و جو در جدول competitive_visibility_top_merchant_view .

گزارش دید رقابتی با کسب و کار با بالاترین دید.

مقادیر فقط برای فیلدهایی که به صراحت در عبارت جستجوی درخواست درخواست شده اند تنظیم می شوند.

فیلدها
`date`	`Date` تاریخ این ردیف. نمی توان در بند `SELECT` انتخاب کرد. شرط `date` در بند `WHERE` الزامی است.
`domain`	`string` اگر «is_your_domain» درست باشد، دامنه رقیب یا دامنه شما. در بند `SELECT` مورد نیاز است. در بند "WHERE" نمی توان آن را فیلتر کرد.
`is_ your_ domain`	`bool` درست است اگر این ردیف حاوی داده های دامنه شما باشد. در بند "WHERE" نمی توان آن را فیلتر کرد.
`report_ country_ code`	`string` کشوری که برداشت ها ظاهر شد. در بند `SELECT` مورد نیاز است. شرط `report_country_code` در بند `WHERE` الزامی است.
`report_ category_ id`	`int64` شناسه دسته محصول Google برای محاسبه گزارش، که در طبقه‌بندی محصولات Google نشان داده شده است. در بند `SELECT` مورد نیاز است. شرط `report_category_id` در عبارت `WHERE` لازم است.
`traffic_ source`	`TrafficSourceEnum` منبع ترافیک برداشت ها در بند `SELECT` مورد نیاز است.
`rank`	`int64` موقعیت دامنه در رتبه‌بندی تاجران برتر برای کلیدهای انتخابی ( `date` ، `report_category_id` ، `report_country_code` ، `traffic_source` ) بر اساس برداشت‌ها. 1 بالاترین است. در بند "WHERE" نمی توان آن را فیلتر کرد.
`ads_ organic_ ratio`	`double` نسبت تبلیغات/ارگانیک نشان می‌دهد که دامنه در مقایسه با ترافیک ارگانیک چقدر از آگهی‌های خرید بازدید می‌کند. عدد گرد و سطلی است. در بند "WHERE" نمی توان آن را فیلتر کرد.
`page_ overlap_ rate`	`double` نرخ همپوشانی صفحه نشان می‌دهد که چقدر پیشنهادات خرده‌فروشان رقیب همراه با پیشنهادات شما در یک صفحه نشان داده می‌شوند. در بند "WHERE" نمی توان آن را فیلتر کرد.
`higher_ position_ rate`	`double` نرخ موقعیت بالاتر نشان می دهد که هر چند وقت یکبار پیشنهاد یک رقیب در موقعیت بالاتری نسبت به پیشنهاد شما در صفحه قرار می گیرد. در بند "WHERE" نمی توان آن را فیلتر کرد.

روش بازاریابی

این نوع هیچ فیلدی ندارد.

روش بازاریابی مورد استفاده برای تبلیغ محصولات شما در گوگل (ارگانیک در مقابل تبلیغات).

MarketingMethodEnum

ارزش های روش بازاریابی

Enums
`MARKETING_METHOD_ENUM_UNSPECIFIED`	مشخص نشده است.
`ORGANIC`	بازاریابی ارگانیک
`ADS`	بازاریابی مبتنی بر تبلیغات

NonProductPerformanceView

فیلدهای موجود برای درخواست در جدول non_product_performance_view .

داده های عملکرد در تصاویر و لینک های فروشگاه آنلاین منتهی به صفحات غیر محصول شما. این شامل معیارهای عملکرد (به عنوان مثال، clicks ) و ابعادی است که معیارهای عملکرد بر اساس آن‌ها تقسیم‌بندی می‌شوند (به عنوان مثال، date ).

فیلدهای بخش را نمی توان در جستارها بدون انتخاب حداقل یک فیلد متریک انتخاب کرد.

مقادیر فقط برای فیلدهایی که به صراحت در عبارت جستجوی درخواست درخواست شده اند تنظیم می شوند.

فیلدها
`date`	`Date` تاریخ در منطقه زمانی تاجر که معیارها برای آن اعمال می‌شود. بخش. شرط `date` در بند `WHERE` الزامی است.
`week`	`Date` اولین روز هفته (دوشنبه) تاریخ معیارها در منطقه زمانی تاجر. بخش.
`clicks`	`int64` تعداد کلیک روی تصاویر و لینک های فروشگاه آنلاین منتهی به صفحات غیر محصول شما. متریک.
`impressions`	`int64` تعداد دفعاتی که تصاویر و لینک‌های فروشگاه آنلاین منتهی به صفحات غیرمحصولی شما نشان داده شده‌اند. متریک.
`click_ through_ rate`	`double` نرخ کلیک - تعداد کلیک‌ها ( `clicks` ) تقسیم بر تعداد نمایش‌ها ( `impressions` ) تصاویر و لینک‌های فروشگاه آنلاین منتهی به صفحات غیر محصول شما. متریک.

قیمت رقابتی محصول View

فیلدهای موجود برای درخواست در جدول price_competitiveness_product_view .

گزارش رقابت قیمت

مقادیر فقط برای فیلدهایی که به صراحت در عبارت جستجوی درخواست درخواست شده اند تنظیم می شوند.

فیلدها
`price`	`Price` قیمت فعلی محصول
`benchmark_ price`	`Price` آخرین معیار قیمت موجود برای کاتالوگ محصول در کشور معیار.
`report_ country_ code`	`string` کشور معیار قیمت در قالب ISO 3166 ارائه شده است. در بند `SELECT` مورد نیاز است.
`id`	`string` REST ID محصول، به شکل `channel~languageCode~feedLabel~offerId` . می توان برای پیوستن داده ها به جدول `product_view` استفاده کرد. در بند `SELECT` مورد نیاز است.
`offer_ id`	`string` شناسه محصول ارائه شده توسط تاجر.
`title`	`string` عنوان محصول.
`brand`	`string` نام تجاری محصول.
`category_ l1`	`string` دسته بندی محصول (سطح 1) در طبقه بندی محصولات Google .
`category_ l2`	`string` دسته بندی محصول (سطح دوم) در طبقه بندی محصولات Google .
`category_ l3`	`string` دسته بندی محصول (سطح 3) در طبقه بندی محصولات گوگل .
`category_ l4`	`string` دسته بندی محصول (سطح 4) در طبقه بندی محصولات گوگل .
`category_ l5`	`string` دسته بندی محصول (سطح 5) در طبقه بندی محصولات گوگل .
`product_ type_ l1`	`string` نوع محصول (سطح 1) در طبقه بندی محصولات خود بازرگان.
`product_ type_ l2`	`string` نوع محصول (سطح دوم) در طبقه بندی محصولات خود بازرگان.
`product_ type_ l3`	`string` نوع محصول (سطح 3) در طبقه بندی محصولات خود بازرگان.
`product_ type_ l4`	`string` نوع محصول (سطح 4) در طبقه بندی محصولات خود بازرگان.
`product_ type_ l5`	`string` نوع محصول (سطح 5) در طبقه بندی محصولات خود بازرگان.

PriceInsightsProductView

فیلدهای موجود برای درخواست در جدول price_insights_product_view .

گزارش بینش قیمت

مقادیر فقط برای فیلدهایی که به صراحت در عبارت جستجوی درخواست درخواست شده اند تنظیم می شوند.

فیلدها
`price`	`Price` قیمت فعلی محصول
`suggested_ price`	`Price` آخرین قیمت پیشنهادی برای محصول
`effectiveness`	`Effectiveness` اثربخشی پیش‌بینی‌شده اعمال پیشنهاد قیمت، سطل شده است.
`id`	`string` REST ID محصول، به شکل `channel~languageCode~feedLabel~offerId` . می توان برای پیوستن داده ها به جدول `product_view` استفاده کرد. در بند `SELECT` مورد نیاز است.
`offer_ id`	`string` شناسه محصول ارائه شده توسط تاجر.
`title`	`string` عنوان محصول.
`brand`	`string` نام تجاری محصول.
`category_ l1`	`string` دسته بندی محصول (سطح 1) در طبقه بندی محصولات Google .
`category_ l2`	`string` دسته بندی محصول (سطح دوم) در طبقه بندی محصولات Google .
`category_ l3`	`string` دسته بندی محصول (سطح 3) در طبقه بندی محصولات گوگل .
`category_ l4`	`string` دسته بندی محصول (سطح 4) در طبقه بندی محصولات گوگل .
`category_ l5`	`string` دسته بندی محصول (سطح 5) در طبقه بندی محصولات گوگل .
`product_ type_ l1`	`string` نوع محصول (سطح 1) در طبقه بندی محصولات خود بازرگان.
`product_ type_ l2`	`string` نوع محصول (سطح دوم) در طبقه بندی محصولات خود بازرگان.
`product_ type_ l3`	`string` نوع محصول (سطح 3) در طبقه بندی محصولات خود بازرگان.
`product_ type_ l4`	`string` نوع محصول (سطح 4) در طبقه بندی محصولات خود بازرگان.
`product_ type_ l5`	`string` نوع محصول (سطح 5) در طبقه بندی محصولات خود بازرگان.
`predicted_ impressions_ change_ fraction`	`double` پیش بینی تغییر در نمایش ها به صورت کسری پس از معرفی قیمت پیشنهادی در مقایسه با قیمت فعال فعلی. به عنوان مثال، 0.05 یک افزایش 5 درصدی پیش بینی شده در نمایش ها است.
`predicted_ clicks_ change_ fraction`	`double` پیش بینی تغییر در کلیک ها به صورت کسری پس از معرفی قیمت پیشنهادی نسبت به قیمت فعال فعلی. به عنوان مثال، 0.05 یک افزایش 5٪ پیش بینی شده در کلیک است.
`predicted_ conversions_ change_ fraction`	`double` پیش بینی تغییر در تبدیل به صورت کسری پس از معرفی قیمت پیشنهادی در مقایسه با قیمت فعال فعلی. به عنوان مثال، 0.05 یک افزایش 5٪ پیش بینی شده در تبدیل است).

اثربخشی

سطل اثربخشی پیش بینی شده

اثربخشی نشان می دهد که کدام محصولات بیشتر از تغییرات قیمت سود می برند. این رتبه بندی افزایش عملکرد پیش بینی شده با تعدیل قیمت فروش و تفاوت بین قیمت فعلی شما و قیمت پیشنهادی را در نظر می گیرد. پیش‌بینی می‌شود پیشنهادات قیمت با اثربخشی HIGH بیشترین افزایش عملکرد را به همراه داشته باشد.

Enums
`EFFECTIVENESS_UNSPECIFIED`	اثربخشی ناشناخته است.
`LOW`	اثربخشی پایین است.
`MEDIUM`	اثربخشی متوسط است.
`HIGH`	اثربخشی بالاست.

Product PerformanceView

فیلدهای موجود برای پرس و جو در جدول product_performance_view .

داده‌های عملکرد محصول برای حساب شما، از جمله معیارهای عملکرد (به عنوان مثال، clicks ) و ابعادی که بر اساس آن معیارهای عملکرد بخش‌بندی می‌شوند (به عنوان مثال، offer_id ). مقادیر ابعاد محصول، مانند offer_id ، وضعیت یک محصول را در زمان نمایش نشان می دهد.

فیلدهای بخش را نمی توان در جستارها بدون انتخاب حداقل یک فیلد متریک انتخاب کرد.

مقادیر فقط برای فیلدهایی که به صراحت در عبارت جستجوی درخواست درخواست شده اند تنظیم می شوند.

فیلدها
`date`	`Date` تاریخ در منطقه زمانی تاجر که معیارها برای آن اعمال می‌شود. بخش. شرط `date` در بند `WHERE` الزامی است.
`week`	`Date` اولین روز هفته (دوشنبه) تاریخ معیارها در منطقه زمانی تاجر. بخش.
`conversion_ value`	`Price` ارزش تبدیل های منتسب به محصول، در تاریخ تبدیل گزارش شده است. متریک. فقط برای منبع ترافیک `FREE` موجود است.
`marketing_ method`	`MarketingMethodEnum` روش بازاریابی که معیارها برای آن اعمال می شود. بخش.
`customer_ country_ code`	`string` کد کشوری که مشتری در زمان رویداد در آن واقع شده است. در قالب ISO 3166 ارائه شده است. بخش. اگر کشور مشتری را نتوان تعیین کرد، یک کد ویژه 'ZZ' برگردانده می شود.
`offer_ id`	`string` شناسه محصول ارائه شده توسط تاجر. بخش.
`title`	`string` عنوان محصول. بخش.
`brand`	`string` نام تجاری محصول. بخش.
`category_ l1`	`string` دسته بندی محصول (سطح 1) در طبقه بندی محصولات گوگل. بخش.
`category_ l2`	`string` دسته بندی محصول (سطح دوم) در طبقه بندی محصولات گوگل. بخش.
`category_ l3`	`string` دسته بندی محصول (سطح 3) در طبقه بندی محصولات گوگل. بخش.
`category_ l4`	`string` دسته بندی محصولات (سطح 4) در طبقه بندی محصولات گوگل. بخش.
`category_ l5`	`string` دسته بندی محصول (سطح 5) در طبقه بندی محصولات گوگل. بخش.
`product_ type_ l1`	`string` نوع محصول (سطح 1) در طبقه بندی محصولات خود بازرگان. بخش.
`product_ type_ l2`	`string` نوع محصول (سطح دوم) در طبقه بندی محصولات خود بازرگان. بخش.
`product_ type_ l3`	`string` نوع محصول (سطح 3) در طبقه بندی محصولات خود بازرگان. بخش.
`product_ type_ l4`	`string` نوع محصول (سطح 4) در طبقه بندی محصولات خود بازرگان. بخش.
`product_ type_ l5`	`string` نوع محصول (سطح 5) در طبقه بندی محصولات خود بازرگان. بخش.
`custom_ label0`	`string` برچسب سفارشی 0 برای گروه بندی سفارشی محصولات. بخش.
`custom_ label1`	`string` برچسب سفارشی 1 برای گروه بندی سفارشی محصولات. بخش.
`custom_ label2`	`string` برچسب سفارشی 2 برای گروه بندی سفارشی محصولات. بخش.
`custom_ label3`	`string` برچسب سفارشی 3 برای گروه بندی سفارشی محصولات. بخش.
`custom_ label4`	`string` برچسب سفارشی 4 برای گروه بندی سفارشی محصولات. بخش.
`clicks`	`int64` تعداد کلیک ها متریک.
`impressions`	`int64` تعداد دفعاتی که محصولات تاجر نشان داده می شود. متریک.
`click_ through_ rate`	`double` نرخ کلیک - تعداد کلیک‌هایی که محصولات تاجر دریافت می‌کنند (کلیک‌ها) تقسیم بر تعداد دفعاتی که محصولات نشان داده می‌شوند (نمایش‌ها). متریک.
`conversions`	`double` تعداد تبدیل‌های منتسب به محصول، گزارش‌شده در تاریخ تبدیل. بسته به مدل انتساب، یک تبدیل ممکن است بین چند کلیک توزیع شود، جایی که هر کلیک اعتبار خود را به خود اختصاص می دهد. این متریک مجموع تمام این اعتبارات است. متریک. فقط برای منبع ترافیک `FREE` موجود است.
`conversion_ rate`	`double` تعداد تبدیل‌ها تقسیم بر تعداد کلیک‌ها، گزارش‌شده در تاریخ نمایش. متریک. فقط برای منبع ترافیک `FREE` موجود است.

ProductView

فیلدهای موجود برای پرس و جو در جدول product_view .

محصولات موجود در موجودی فعلی محصولات موجود در این جدول مانند محصولات فرعی API هستند، اما همه ویژگی‌های محصول از API فرعی محصولات برای جستجو در این جدول موجود نیستند. برخلاف محصولات فرعی API، این جدول اجازه می دهد تا لیست برگشتی محصولات را بر اساس ویژگی های محصول فیلتر کنید. برای بازیابی یک محصول واحد با id یا فهرست کردن همه محصولات، API فرعی محصولات باید استفاده شود.

مقادیر فقط برای فیلدهایی که به صراحت در عبارت جستجوی درخواست درخواست شده اند تنظیم می شوند.

فیلدها
`price`	`Price` قیمت محصول. در صورتی که اطلاعاتی در مورد قیمت محصول در دسترس نباشد، وجود ندارد.
`gtin[]`	`string` فهرست شماره‌های اقلام تجاری جهانی (GTIN) محصول.
`creation_ time`	`Timestamp` زمانی که تاجر محصول را ایجاد کرد در ثانیه مُهر زمانی.
`expiration_ date`	`Date` تاریخ انقضا برای محصول، درج شده است.
`item_ issues[]`	`ItemIssue` لیست مشکلات اقلام برای محصول از این فیلد نمی توان برای مرتب سازی نتایج استفاده کرد. فقط ویژگی های انتخاب شده از این فیلد (به عنوان مثال، `item_issues.severity.aggregated_severity` ) می تواند برای فیلتر کردن نتایج استفاده شود.
`click_ potential`	`ClickPotential` پتانسیل عملکرد تخمینی در مقایسه با محصولات با بالاترین عملکرد تاجر.
`id`	`string` REST ID محصول، به شکل `channel~languageCode~feedLabel~offerId` . روش‌های Merchant API که روی محصولات کار می‌کنند، این پارامتر را به عنوان پارامتر `name` خود در نظر می‌گیرند. در بند `SELECT` مورد نیاز است.
`channel`	`ChannelEnum` کانال محصول می تواند `ONLINE` یا `LOCAL` باشد.
`language_ code`	`string` کد زبان محصول در قالب BCP 47.
`feed_ label`	`string` برچسب خوراک محصول
`offer_ id`	`string` شناسه محصول ارائه شده توسط تاجر.
`title`	`string` عنوان محصول.
`brand`	`string` نام تجاری محصول.
`category_ l1`	`string` دسته بندی محصول (سطح 1) در طبقه بندی محصولات Google .
`category_ l2`	`string` دسته بندی محصول (سطح دوم) در طبقه بندی محصولات Google .
`category_ l3`	`string` دسته بندی محصول (سطح 3) در طبقه بندی محصولات گوگل .
`category_ l4`	`string` دسته بندی محصول (سطح 4) در طبقه بندی محصولات گوگل .
`category_ l5`	`string` دسته بندی محصول (سطح 5) در طبقه بندی محصولات گوگل .
`product_ type_ l1`	`string` نوع محصول (سطح 1) در طبقه بندی محصولات خود بازرگان.
`product_ type_ l2`	`string` نوع محصول (سطح دوم) در طبقه بندی محصولات خود بازرگان.
`product_ type_ l3`	`string` نوع محصول (سطح 3) در طبقه بندی محصولات خود بازرگان.
`product_ type_ l4`	`string` نوع محصول (سطح 4) در طبقه بندی محصولات خود بازرگان.
`product_ type_ l5`	`string` نوع محصول (سطح 5) در طبقه بندی محصولات خود بازرگان.
`condition`	`string` وضعیت محصول.
`availability`	`string` در دسترس بودن محصول.
`shipping_ label`	`string` برچسب حمل و نقل عادی مشخص شده در منبع داده.
`item_ group_ id`	`string` شناسه گروه مورد توسط بازرگان برای گروه بندی انواع با هم ارائه شده است.
`thumbnail_ link`	`string` پیوند به تصویر پردازش شده محصول، میزبانی شده در زیرساخت Google.
`aggregated_ reporting_ context_ status`	`AggregatedReportingContextStatus` وضعیت تجمیع شده
`click_ potential_ rank`	`int64` رتبه بندی محصول بر اساس پتانسیل کلیک آن. محصولی با `click_potential_rank` 1 دارای بالاترین پتانسیل کلیک در میان محصولات تاجر است که شرایط درخواست جستجو را برآورده می کند.

AggregatedReportingContextStatus

وضعیت محصول برای همه زمینه های گزارش جمع آوری شده است.

در اینجا مثالی از نحوه محاسبه وضعیت انبوه آورده شده است:

لیست های رایگان	تبلیغات خرید	وضعیت
تصویب شد	تصویب شد	واجد شرایط
تصویب شد	در انتظار	واجد شرایط
تصویب شد	تایید نشد	ELIGIBLE_LIMITED
در انتظار	در انتظار	در انتظار
تایید نشد	تایید نشد	NOT_ELIGIBLE_OR_DISAPPROVED

Enums
`AGGREGATED_REPORTING_CONTEXT_STATUS_UNSPECIFIED`	مشخص نشده است.
`NOT_ELIGIBLE_OR_DISAPPROVED`	محصول برای همه زمینه‌های گزارش‌دهی واجد شرایط نیست یا تأیید نشده است.
`PENDING`	وضعیت محصول در همه زمینه‌های گزارش‌دهی در انتظار است.
`ELIGIBLE_LIMITED`	محصول برای برخی (اما نه همه) زمینه های گزارش واجد شرایط است.
`ELIGIBLE`	محصول برای همه زمینه های گزارش واجد شرایط است.

پتانسیل کلیک کنید

پتانسیل کلیک یک محصول پتانسیل عملکرد آن را در مقایسه با محصولات تاجر با بالاترین عملکرد تخمین می زند. پتانسیل کلیک یک محصول به بازرگانان کمک می کند تا اولویت بندی کنند که کدام محصولات را تعمیر کنند و به آنها کمک می کند تا درک کنند که محصولات در برابر پتانسیل آنها چگونه عمل می کنند.

Enums
`CLICK_POTENTIAL_UNSPECIFIED`	تأثیر کلیک‌های پیش‌بینی‌شده ناشناخته.
`LOW`	امکان دریافت تعداد کلیک کم در مقایسه با محصولات تاجر با بالاترین عملکرد.
`MEDIUM`	بالقوه برای دریافت تعداد کلیک متوسط در مقایسه با محصولات با بالاترین عملکرد تاجر.
`HIGH`	پتانسیل دریافت تعداد کلیک مشابه به عنوان محصولات با بالاترین عملکرد تاجر.

ItemIssue

مشکل مورد مرتبط با محصول

فیلدها

فیلدها
`type`	`ItemIssueType` نوع موضوع
`severity`	`ItemIssueSeverity` شدت موضوع مورد
`resolution`	`ItemIssueResolution` حل مشکل مورد

type

ItemIssueType

نوع موضوع

severity

ItemIssueSeverity

شدت موضوع مورد

resolution

ItemIssueResolution

حل مشکل مورد

ItemIssueResolution

چگونه مسئله را حل کنیم.

Enums
`ITEM_ISSUE_RESOLUTION_UNSPECIFIED`	مشخص نشده است.
`MERCHANT_ACTION`	تاجر باید مشکل را برطرف کند.
`PENDING_PROCESSING`	مشکل به طور خودکار (مثلاً خزیدن تصویر) یا از طریق بررسی Google حل خواهد شد. در حال حاضر هیچ اقدام تجاری لازم نیست. وضوح ممکن است به مشکل دیگری منجر شود (به عنوان مثال، اگر خزیدن با شکست مواجه شود).

ItemIssueSeverity

این موضوع چگونه بر ارائه محصول تأثیر می گذارد.

فیلدها

فیلدها
`severity_ per_ reporting_ context[]`	`IssueSeverityPerReportingContext` شدت موضوع در زمینه گزارش.
`aggregated_ severity`	`AggregatedIssueSeverity` شدت تجمیع موضوع برای همه زمینه های گزارشگری که بر آن تأثیر می گذارد. از این فیلد می توان برای فیلتر کردن نتایج استفاده کرد.

severity_ per_ reporting_ context[]

IssueSeverityPerReportingContext

شدت موضوع در زمینه گزارش.

aggregated_ severity

AggregatedIssueSeverity

شدت تجمیع موضوع برای همه زمینه های گزارشگری که بر آن تأثیر می گذارد.

از این فیلد می توان برای فیلتر کردن نتایج استفاده کرد.

AggregatedIssueSeverity

شدت موضوع برای همه زمینه های گزارش جمع آوری شده است.

Enums
`AGGREGATED_ISSUE_SEVERITY_UNSPECIFIED`	مشخص نشده است.
`DISAPPROVED`	مشکل حداقل در یک زمینه گزارش، محصول را تأیید نمی کند.
`DEMOTED`	Issue محصول را در تمام زمینه های گزارشی که تحت تأثیر قرار می دهد، تنزل می دهد.
`PENDING`	حل مشکل `PENDING_PROCESSING` است.

IssueSeverityPerReportingContext

شدت موضوع در زمینه گزارش.

فیلدها

فیلدها
`disapproved_ countries[]`	`string` فهرست کشورهای تایید نشده در زمینه گزارش، در قالب ISO 3166 ارائه شده است.
`demoted_ countries[]`	`string` فهرست کشورهای تنزل یافته در زمینه گزارش، که در قالب ISO 3166 ارائه شده است.
`reporting_ context`	`ReportingContextEnum` زمینه گزارش مشکل در مورد آن اعمال می شود.

disapproved_ countries[]

string

فهرست کشورهای تایید نشده در زمینه گزارش، در قالب ISO 3166 ارائه شده است.

demoted_ countries[]

string

فهرست کشورهای تنزل یافته در زمینه گزارش، که در قالب ISO 3166 ارائه شده است.

reporting_ context

ReportingContextEnum

زمینه گزارش مشکل در مورد آن اعمال می شود.

ItemIssueType

نوع مسئله

فیلدها

فیلدها
`code`	`string` کد خطای مشکل، معادل `code` مربوط به محصولات است .
`canonical_ attribute`	`string` نام مشخصه متعارف برای مسائل خاص ویژگی.

code

string

کد خطای مشکل، معادل code مربوط به محصولات است .

canonical_ attribute

string

نام مشخصه متعارف برای مسائل خاص ویژگی.

تقاضای نسبی

این نوع هیچ فیلدی ندارد.

تقاضای نسبی یک خوشه محصول یا نام تجاری در گزارش بهترین فروشندگان.

RelativeDemandEnum

مقادیر تقاضای نسبی

Enums
`RELATIVE_DEMAND_ENUM_UNSPECIFIED`	مشخص نشده است.
`VERY_LOW`	تقاضا 0-5% تقاضای خوشه یا برند محصول دارای بالاترین رتبه است.
`LOW`	تقاضا 6 تا 10 درصد تقاضای خوشه محصول یا برندی است که بالاترین رتبه را دارد.
`MEDIUM`	تقاضا 11 تا 20 درصد تقاضای خوشه یا برند محصول با بالاترین رتبه است.
`HIGH`	تقاضا 21 تا 50 درصد تقاضای خوشه یا برند محصول با بالاترین رتبه است.
`VERY_HIGH`	تقاضا 51 تا 100 درصد تقاضای خوشه یا برند محصول با بالاترین رتبه است.

RelativeDemandChangeType

این نوع هیچ فیلدی ندارد.

تقاضای نسبی یک خوشه محصول یا برند در گزارش پرفروش‌ترین‌ها در مقایسه با دوره زمانی قبلی.

RelativeDemandChangeTypeEnum

مقادیر نوع تغییر تقاضای نسبی.

Enums
`RELATIVE_DEMAND_CHANGE_TYPE_ENUM_UNSPECIFIED`	مشخص نشده است.
`SINKER`	تقاضای نسبی کمتر از دوره زمانی قبلی است.
`FLAT`	تقاضای نسبی برابر با دوره زمانی قبلی است.
`RISER`	تقاضای نسبی بیشتر از دوره زمانی قبلی است.

ReportGranularity

این نوع هیچ فیلدی ندارد.

جزئیات گزارش پرفروش‌ها. گزارش های پرفروش ترین ها در بازه زمانی یک هفته و یک ماه محاسبه می شود.

ReportGranularityEnum

مقادیر جزئیات را گزارش کنید.

Enums
`REPORT_GRANULARITY_ENUM_UNSPECIFIED`	مشخص نشده است.
`WEEKLY`	گزارش در بازه زمانی یک هفته محاسبه می شود.
`MONTHLY`	گزارش در بازه زمانی یک ماهه محاسبه می شود.

ReportRow

ردیف نتیجه از عبارت جستجو بازگردانده شد.

فقط پیام مربوط به جدول پرس و جو در پاسخ پر می شود. در پیام پر شده، فقط فیلدهایی که به صراحت در پرس و جو درخواست شده اند پر می شوند.

فیلدها
`product_ performance_ view`	`ProductPerformanceView` فیلدهای موجود برای پرس و جو در جدول `product_performance_view` .
`non_ product_ performance_ view`	`NonProductPerformanceView` فیلدهای موجود برای درخواست در جدول `non_product_performance_view` .
`product_ view`	`ProductView` فیلدهای موجود برای پرس و جو در جدول `product_view` .
`price_ competitiveness_ product_ view`	`PriceCompetitivenessProductView` فیلدهای موجود برای درخواست در جدول `price_competitiveness_product_view` .
`price_ insights_ product_ view`	`PriceInsightsProductView` فیلدهای موجود برای درخواست در جدول `price_insights_product_view` .
`best_ sellers_ product_ cluster_ view`	`BestSellersProductClusterView` فیلدهای موجود برای پرس و جو در جدول `best_sellers_product_cluster_view` .
`best_ sellers_ brand_ view`	`BestSellersBrandView` فیلدهای موجود برای پرس و جو در جدول `best_sellers_brand_view` .
`competitive_ visibility_ competitor_ view`	`CompetitiveVisibilityCompetitorView` فیلدهای موجود برای پرس و جو در جدول `competitive_visibility_competitor_view` .
`competitive_ visibility_ top_ merchant_ view`	`CompetitiveVisibilityTopMerchantView` فیلدهای موجود برای پرس و جو در جدول `competitive_visibility_top_merchant_view` .
`competitive_ visibility_ benchmark_ view`	`CompetitiveVisibilityBenchmarkView` فیلدهای موجود برای پرس و جو در جدول `competitive_visibility_benchmark_view` .

درخواست جستجو

درخواست پیام برای روش ReportService.Search .

فیلدها
`parent`	`string` مورد نیاز. شناسه حسابی که تماس برقرار می کند. باید یک حساب مستقل یا یک حساب فرعی MCA باشد. قالب: حساب‌ها/{حساب}
`query`	`string` مورد نیاز. کوئری که گزارشی را برای بازیابی تعریف می کند. برای جزئیات در مورد نحوه ساخت پرس و جو، به راهنمای زبان پرس و جو مراجعه کنید. برای لیست کامل جداول و فیلدهای موجود، به فیلدهای موجود مراجعه کنید.
`page_ size`	`int32` اختیاری. تعداد `ReportRows` برای بازیابی در یک صفحه. پیش‌فرض 1000. مقادیر بالای 5000 به 5000 اجباری می‌شوند.
`page_ token`	`string` اختیاری. نشانه صفحه برای بازیابی. اگر مشخص نشده باشد، صفحه اول نتایج برگردانده می شود. برای درخواست صفحه بعدی نتایج، باید از مقدار به دست آمده از `next_page_token` در پاسخ قبلی استفاده شود.

Search Response

پیام پاسخ برای روش ReportService.Search .

فیلدها

فیلدها
`results[]`	`ReportRow` ردیف هایی که با عبارت جستجو مطابقت دارند.
`next_ page_ token`	`string` نشانه ای که می تواند به عنوان `page_token` برای بازیابی صفحه بعدی ارسال شود. اگر حذف شود، هیچ صفحه بعدی وجود ندارد.

results[]

ReportRow

ردیف هایی که با عبارت جستجو مطابقت دارند.

next_ page_ token

string

نشانه ای که می تواند به عنوان page_token برای بازیابی صفحه بعدی ارسال شود. اگر حذف شود، هیچ صفحه بعدی وجود ندارد.

منبع ترافیک

این نوع هیچ فیلدی ندارد.

منبع ترافیک برداشت‌ها در گزارش دید رقابتی.

TrafficSourceEnum

مقادیر منبع ترافیک

Enums
`TRAFFIC_SOURCE_ENUM_UNSPECIFIED`	مشخص نشده است.
`ORGANIC`	ترافیک ارگانیک
`ADS`	ترافیک از تبلیغات
`ALL`	ترافیک ارگانیک و تبلیغات

Package google.shopping.merchant.reports.v1beta با مجموعه‌ها، منظم بمانید ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.

شاخص

گزارش سرویس

BestSellersBrandView

پرفروش ترین محصولClusterView

وضعیت موجودی

CompetitiveVisibilityBenchmarkView

CompetitiveVisibilityCompetitorView

CompetitiveVisibilityTopMerchantView

روش بازاریابی

MarketingMethodEnum

NonProductPerformanceView

قیمت رقابتی محصول View

PriceInsightsProductView

اثربخشی

Product PerformanceView

ProductView

AggregatedReportingContextStatus

پتانسیل کلیک کنید

ItemIssue

ItemIssueResolution

ItemIssueSeverity

AggregatedIssueSeverity

IssueSeverityPerReportingContext

ItemIssueType

تقاضای نسبی

RelativeDemandEnum

RelativeDemandChangeType

RelativeDemandChangeTypeEnum

ReportGranularity

ReportGranularityEnum

ReportRow

درخواست جستجو

Search Response

منبع ترافیک

TrafficSourceEnum

Package google.shopping.merchant.reports.v1beta