REST Resource: accounts.reports

• منبع: ReportRow
  • نمایندگی JSON
• Product PerformanceView
  • نمایندگی JSON
• MarketingMethodEnum
• NonProductPerformanceView
  • نمایندگی JSON
• ProductView
  • نمایندگی JSON
• AggregatedReportingContextStatus
• ItemIssue
  • نمایندگی JSON
• ItemIssueType
  • نمایندگی JSON
• ItemIssueSeverity
  • نمایندگی JSON
• IssueSeverityPerReportingContext
  • نمایندگی JSON
• AggregatedIssueSeverity
• ItemIssueResolution
• پتانسیل کلیک کنید
• قیمت رقابتی محصول View
  • نمایندگی JSON
• PriceInsightsProductView
  • نمایندگی JSON
• اثربخشی
• پرفروش ترین محصولClusterView
  • نمایندگی JSON
• ReportGranularityEnum
• وضعیت موجودی
• RelativeDemandEnum
• RelativeDemandChangeTypeEnum
• BestSellersBrandView
  • نمایندگی JSON
• CompetitiveVisibilityCompetitorView
  • نمایندگی JSON
• TrafficSourceEnum
• CompetitiveVisibilityTopMerchantView
  • نمایندگی JSON
• CompetitiveVisibilityBenchmarkView
  • نمایندگی JSON
• روش ها

منبع: ReportRow

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

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

نمایندگی JSON

{ "productPerformanceView": { object (ProductPerformanceView) }, "nonProductPerformanceView": { object (NonProductPerformanceView) }, "productView": { object (ProductView) }, "priceCompetitivenessProductView": { object (PriceCompetitivenessProductView) }, "priceInsightsProductView": { object (PriceInsightsProductView) }, "bestSellersProductClusterView": { object (BestSellersProductClusterView) }, "bestSellersBrandView": { object (BestSellersBrandView) }, "competitiveVisibilityCompetitorView": { object (CompetitiveVisibilityCompetitorView) }, "competitiveVisibilityTopMerchantView": { object (CompetitiveVisibilityTopMerchantView) }, "competitiveVisibilityBenchmarkView": { object (CompetitiveVisibilityBenchmarkView) } }

فیلدها
product Performance View	object ( ProductPerformanceView ) فیلدهای موجود برای پرس و جو در جدول productPerformanceView .
non Product Performance View	object ( NonProductPerformanceView ) فیلدهای موجود برای پرس و جو در جدول nonProductPerformanceView .
product View	object ( ProductView ) فیلدهای موجود برای پرس و جو در جدول productView .
price Competitiveness Product View	object ( PriceCompetitivenessProductView ) فیلدهای موجود برای پرس و جو در جدول priceCompetitivenessProductView .
price Insights Product View	object ( PriceInsightsProductView ) فیلدهای موجود برای درخواست در جدول priceInsightsProductView .
best Sellers Product Cluster View	object ( BestSellersProductClusterView ) فیلدهای موجود برای پرس و جو در جدول bestSellersProductClusterView .
best Sellers Brand View	object ( BestSellersBrandView ) فیلدهای موجود برای پرس و جو در جدول bestSellersBrandView .
competitive Visibility Competitor View	object ( CompetitiveVisibilityCompetitorView ) فیلدهای موجود برای پرس و جو در جدول competitiveVisibilityCompetitorView .
competitive Visibility Top Merchant View	object ( CompetitiveVisibilityTopMerchantView ) فیلدهای موجود برای پرس و جو در جدول competitiveVisibilityTopMerchantView .
competitive Visibility Benchmark View	object ( CompetitiveVisibilityBenchmarkView ) فیلدهای موجود برای پرس و جو در جدول competitiveVisibilityBenchmarkView .

Product PerformanceView

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

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

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

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

نمایندگی JSON

{ "date": { object (Date) }, "week": { object (Date) }, "conversionValue": { object (Price) }, "marketingMethod": enum (MarketingMethodEnum), "customerCountryCode": string, "offerId": string, "title": string, "brand": string, "categoryL1": string, "categoryL2": string, "categoryL3": string, "categoryL4": string, "categoryL5": string, "productTypeL1": string, "productTypeL2": string, "productTypeL3": string, "productTypeL4": string, "productTypeL5": string, "customLabel0": string, "customLabel1": string, "customLabel2": string, "customLabel3": string, "customLabel4": string, "clicks": string, "impressions": string, "clickThroughRate": number, "conversions": number, "conversionRate": number }

فیلدها
date	object ( Date ) تاریخ در منطقه زمانی تاجر که معیارها برای آن اعمال می‌شود. بخش. شرط date در بند WHERE الزامی است.
week	object ( Date ) اولین روز هفته (دوشنبه) تاریخ معیارها در منطقه زمانی تاجر. بخش.
conversion Value	object ( Price ) ارزش تبدیل های منتسب به محصول، در تاریخ تبدیل گزارش شده است. متریک. فقط برای منبع ترافیک FREE موجود است.
marketing Method	enum ( 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	string ( int64 format) تعداد کلیک ها متریک.
impressions	string ( int64 format) تعداد دفعاتی که محصولات تاجر نشان داده می شود. متریک.
click Through Rate	number نرخ کلیک - تعداد کلیک‌هایی که محصولات تاجر دریافت می‌کنند (کلیک‌ها) تقسیم بر تعداد دفعاتی که محصولات نشان داده می‌شوند (نمایش‌ها). متریک.
conversions	number تعداد تبدیل‌های منتسب به محصول، گزارش‌شده در تاریخ تبدیل. بسته به مدل انتساب، یک تبدیل ممکن است بین چند کلیک توزیع شود، جایی که هر کلیک اعتبار خود را به خود اختصاص می دهد. این متریک مجموع تمام این اعتبارات است. متریک. فقط برای منبع ترافیک FREE موجود است.
conversion Rate	number تعداد تبدیل‌ها تقسیم بر تعداد کلیک‌ها، گزارش‌شده در تاریخ نمایش. متریک. فقط برای منبع ترافیک FREE موجود است.

MarketingMethodEnum

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

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

NonProductPerformanceView

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

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

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

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

نمایندگی JSON
{ "date": { object (Date) }, "week": { object (Date) }, "clicks": string, "impressions": string, "clickThroughRate": number }

فیلدها
date	object ( Date ) تاریخ در منطقه زمانی تاجر که معیارها برای آن اعمال می‌شود. بخش. شرط date در بند WHERE الزامی است.
week	object ( Date ) اولین روز هفته (دوشنبه) تاریخ معیارها در منطقه زمانی تاجر. بخش.
clicks	string ( int64 format) تعداد کلیک روی تصاویر و لینک های فروشگاه آنلاین منتهی به صفحات غیر محصول شما. متریک.
impressions	string ( int64 format) تعداد دفعاتی که تصاویر و لینک‌های فروشگاه آنلاین منتهی به صفحات غیرمحصولی شما نشان داده شده‌اند. متریک.
click Through Rate	number نرخ کلیک - تعداد کلیک‌ها ( clicks ) تقسیم بر تعداد نمایش‌ها ( impressions ) تصاویر و لینک‌های فروشگاه آنلاین منتهی به صفحات غیر محصول شما. متریک.

ProductView

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

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

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

نمایندگی JSON

{ "price": { object (Price) }, "gtin": [ string ], "creationTime": string, "expirationDate": { object (Date) }, "itemIssues": [ { object (ItemIssue) } ], "clickPotential": enum (ClickPotential), "id": string, "channel": enum (ChannelEnum), "languageCode": string, "feedLabel": string, "offerId": string, "title": string, "brand": string, "categoryL1": string, "categoryL2": string, "categoryL3": string, "categoryL4": string, "categoryL5": string, "productTypeL1": string, "productTypeL2": string, "productTypeL3": string, "productTypeL4": string, "productTypeL5": string, "condition": string, "availability": string, "shippingLabel": string, "itemGroupId": string, "thumbnailLink": string, "aggregatedReportingContextStatus": enum (AggregatedReportingContextStatus), "clickPotentialRank": string }

فیلدها
price	object ( Price ) قیمت محصول. در صورتی که اطلاعاتی در مورد قیمت محصول در دسترس نباشد، وجود ندارد.
gtin[]	string فهرست شماره‌های اقلام تجاری جهانی (GTIN) محصول.
creation Time	string ( Timestamp format) زمانی که تاجر محصول را ایجاد کرد در ثانیه مُهر زمانی.
expiration Date	object ( Date ) تاریخ انقضا برای محصول، درج شده است.
item Issues[]	object ( ItemIssue ) لیست مشکلات اقلام برای محصول از این فیلد نمی توان برای مرتب سازی نتایج استفاده کرد. فقط ویژگی های انتخاب شده این فیلد (به عنوان مثال، itemIssues.severity.aggregated_severity ) می تواند برای فیلتر کردن نتایج استفاده شود.
click Potential	enum ( ClickPotential ) پتانسیل عملکرد تخمینی در مقایسه با محصولات با بالاترین عملکرد تاجر.
id	string REST ID محصول، به شکل channel~languageCode~feedLabel~offerId . روش‌های Merchant API که روی محصولات کار می‌کنند، این پارامتر را به عنوان پارامتر name خود در نظر می‌گیرند. در بند SELECT مورد نیاز است.
channel	enum ( 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	enum ( AggregatedReportingContextStatus ) وضعیت تجمیع شده
click Potential Rank	string ( int64 format) رتبه بندی محصول بر اساس پتانسیل کلیک آن. محصولی با clickPotentialRank 1 دارای بالاترین پتانسیل کلیک در میان محصولات تاجر است که شرایط درخواست جستجو را برآورده می کند.

AggregatedReportingContextStatus

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

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

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

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

ItemIssue

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

نمایندگی JSON
{ "type": { object (ItemIssueType) }, "severity": { object (ItemIssueSeverity) }, "resolution": enum (ItemIssueResolution) }

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

ItemIssueType

نوع مسئله

نمایندگی JSON
{ "code": string, "canonicalAttribute": string }

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

ItemIssueSeverity

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

نمایندگی JSON
{ "severityPerReportingContext": [ { object (IssueSeverityPerReportingContext) } ], "aggregatedSeverity": enum (AggregatedIssueSeverity) }

فیلدها
severity Per Reporting Context[]	object ( IssueSeverityPerReportingContext ) شدت موضوع در زمینه گزارش.
aggregated Severity	enum ( AggregatedIssueSeverity ) شدت تجمیع موضوع برای همه زمینه های گزارشگری که بر آن تأثیر می گذارد. از این فیلد می توان برای فیلتر کردن نتایج استفاده کرد.

IssueSeverityPerReportingContext

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

نمایندگی JSON
{ "disapprovedCountries": [ string ], "demotedCountries": [ string ], "reportingContext": enum (ReportingContextEnum) }

فیلدها
disapproved Countries[]	string فهرست کشورهای تایید نشده در زمینه گزارش، در قالب ISO 3166 ارائه شده است.
demoted Countries[]	string فهرست کشورهای تنزل یافته در زمینه گزارش، که در قالب ISO 3166 ارائه شده است.
reporting Context	enum ( ReportingContextEnum ) زمینه گزارش مشکل در مورد آن اعمال می شود.

AggregatedIssueSeverity

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

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

ItemIssueResolution

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

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

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

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

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

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

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

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

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

نمایندگی JSON

{ "price": { object (Price) }, "benchmarkPrice": { object (Price) }, "reportCountryCode": string, "id": string, "offerId": string, "title": string, "brand": string, "categoryL1": string, "categoryL2": string, "categoryL3": string, "categoryL4": string, "categoryL5": string, "productTypeL1": string, "productTypeL2": string, "productTypeL3": string, "productTypeL4": string, "productTypeL5": string }

فیلدها
price	object ( Price ) قیمت فعلی محصول
benchmark Price	object ( Price ) آخرین معیار قیمت موجود برای کاتالوگ محصول در کشور معیار.
report Country Code	string کشور معیار قیمت در قالب ISO 3166 ارائه شده است. در بند SELECT مورد نیاز است.
id	string REST ID محصول، به شکل channel~languageCode~feedLabel~offerId . می توان برای پیوستن به داده ها با جدول productView استفاده کرد. در بند 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

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

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

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

نمایندگی JSON

{ "price": { object (Price) }, "suggestedPrice": { object (Price) }, "effectiveness": enum (Effectiveness), "id": string, "offerId": string, "title": string, "brand": string, "categoryL1": string, "categoryL2": string, "categoryL3": string, "categoryL4": string, "categoryL5": string, "productTypeL1": string, "productTypeL2": string, "productTypeL3": string, "productTypeL4": string, "productTypeL5": string, "predictedImpressionsChangeFraction": number, "predictedClicksChangeFraction": number, "predictedConversionsChangeFraction": number }

فیلدها
price	object ( Price ) قیمت فعلی محصول
suggested Price	object ( Price ) آخرین قیمت پیشنهادی برای محصول
effectiveness	enum ( Effectiveness ) اثربخشی پیش‌بینی‌شده اعمال پیشنهاد قیمت، سطل شده است.
id	string REST ID محصول، به شکل channel~languageCode~feedLabel~offerId . می توان برای پیوستن به داده ها با جدول productView استفاده کرد. در بند SELECT مورد نیاز است.
offer Id	string شناسه محصول ارائه شده توسط تاجر.
title	string عنوان محصول.
brand	string نام تجاری محصول.
category L1	string دسته بندی محصول (سطح 1) در طبقه بندی محصولات Google .
category L2	string دسته بندی محصول (سطح دوم) در طبقه بندی محصولات گوگل .
category L3	string دسته بندی محصول (سطح 3) در طبقه بندی محصولات Google .
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	number پیش بینی تغییر در نمایش ها به صورت کسری پس از معرفی قیمت پیشنهادی در مقایسه با قیمت فعال فعلی. به عنوان مثال، 0.05 یک افزایش 5 درصدی پیش بینی شده در نمایش ها است.
predicted Clicks Change Fraction	number پیش بینی تغییر در کلیک ها به صورت کسری پس از معرفی قیمت پیشنهادی نسبت به قیمت فعال فعلی. به عنوان مثال، 0.05 یک افزایش 5٪ ​​پیش بینی شده در کلیک است.
predicted Conversions Change Fraction	number پیش بینی تغییر در تبدیل به صورت کسری پس از معرفی قیمت پیشنهادی در مقایسه با قیمت فعال فعلی. به عنوان مثال، 0.05 یک افزایش 5٪ ​​پیش بینی شده در تبدیل است).

اثربخشی

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

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

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

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

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

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

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

نمایندگی JSON

{ "reportDate": { object (Date) }, "variantGtins": [ string ], "reportGranularity": enum (ReportGranularityEnum), "reportCountryCode": string, "reportCategoryId": string, "title": string, "brand": string, "categoryL1": string, "categoryL2": string, "categoryL3": string, "categoryL4": string, "categoryL5": string, "inventoryStatus": enum (InventoryStatus), "brandInventoryStatus": enum (InventoryStatus), "rank": string, "previousRank": string, "relativeDemand": enum (RelativeDemandEnum), "previousRelativeDemand": enum (RelativeDemandEnum), "relativeDemandChange": enum (RelativeDemandChangeTypeEnum) }

فیلدها
report Date	object ( Date ) تاریخ گزارش. مقدار این فیلد فقط می تواند یکی از موارد زیر باشد: اولین روز هفته (دوشنبه) برای گزارش های هفتگی، اولین روز ماه برای گزارش های ماهانه. در بند SELECT مورد نیاز است. اگر شرط WHERE در reportDate در جستار مشخص نشده باشد، آخرین گزارش هفتگی یا ماهانه موجود برگردانده می شود.
variant Gtins[]	string GTIN انواع نمونه از خوشه محصول.
report Granularity	enum ( ReportGranularityEnum ) جزئیات گزارش رتبه بندی را می توان در بازه زمانی یک هفته یا یک ماه انجام داد. در بند SELECT مورد نیاز است. شرط مربوط به reportGranularity در بند WHERE الزامی است.
report Country Code	string کشوری که رتبه در آن محاسبه می شود. در قالب ISO 3166 ارائه شده است. در بند SELECT مورد نیاز است. شرط reportCountryCode در بند WHERE الزامی است.
report Category Id	string ( int64 format) شناسه دسته‌بندی محصول Google برای محاسبه رتبه‌بندی، که در طبقه‌بندی محصولات Google نشان داده شده است. در بند SELECT مورد نیاز است. اگر شرط WHERE در reportCategoryId در پرس و جو مشخص نشده باشد، رتبه بندی برای همه دسته های سطح بالا بازگردانده می شود.
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	enum ( InventoryStatus ) چه خوشه محصول در منبع داده محصول شما حداقل در یکی از کشورها IN_STOCK باشد، چه در منبع داده محصول شما در همه کشورها OUT_OF_STOCK یا اصلاً NOT_IN_INVENTORY . این فیلد فیلتر کشور گزارش پرفروش‌ترین‌ها را در نظر نمی‌گیرد.
brand Inventory Status	enum ( InventoryStatus ) خواه حداقل یک محصول از نام تجاری در حال حاضر IN_STOCK در منبع داده محصول شما در حداقل یکی از کشورها وجود داشته باشد، همه محصولات در منبع داده محصول شما در همه کشورها OUT_OF_STOCK هستند یا NOT_IN_INVENTORY . این فیلد فیلتر کشور گزارش پرفروش‌ترین‌ها را در نظر نمی‌گیرد.
rank	string ( int64 format) محبوبیت خوشه محصول در تبلیغات و سطوح ارگانیک، در دسته و کشور انتخاب شده، بر اساس تعداد تخمینی واحدهای فروخته شده.
previous Rank	string ( int64 format) رتبه محبوبیت در هفته یا ماه قبل.
relative Demand	enum ( RelativeDemandEnum ) برآورد تقاضا در رابطه با خوشه محصول با بالاترین رتبه محبوبیت در همان دسته و کشور.
previous Relative Demand	enum ( RelativeDemandEnum ) تقاضای تخمینی در رابطه با خوشه محصول با بالاترین رتبه محبوبیت در همان دسته و کشور در هفته یا ماه قبل.
relative Demand Change	enum ( RelativeDemandChangeTypeEnum ) تغییر در تقاضای تخمینی خواه بالا آمد، غرق شد یا صاف ماند.

ReportGranularityEnum

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

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

وضعیت موجودی

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

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

RelativeDemandEnum

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

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

RelativeDemandChangeTypeEnum

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

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

BestSellersBrandView

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

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

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

نمایندگی JSON
{ "reportDate": { object (Date) }, "reportGranularity": enum (ReportGranularityEnum), "reportCountryCode": string, "reportCategoryId": string, "brand": string, "rank": string, "previousRank": string, "relativeDemand": enum (RelativeDemandEnum), "previousRelativeDemand": enum (RelativeDemandEnum), "relativeDemandChange": enum (RelativeDemandChangeTypeEnum) }

فیلدها
report Date	object ( Date ) تاریخ گزارش. مقدار این فیلد فقط می تواند یکی از موارد زیر باشد: اولین روز هفته (دوشنبه) برای گزارش های هفتگی، اولین روز ماه برای گزارش های ماهانه. در بند SELECT مورد نیاز است. اگر شرط WHERE در reportDate در جستار مشخص نشده باشد، آخرین گزارش هفتگی یا ماهانه موجود برگردانده می شود.
report Granularity	enum ( ReportGranularityEnum ) جزئیات گزارش رتبه بندی را می توان در بازه زمانی یک هفته یا یک ماه انجام داد. در بند SELECT مورد نیاز است. شرط مربوط به reportGranularity در بند WHERE الزامی است.
report Country Code	string کشوری که رتبه در آن محاسبه می شود. در قالب ISO 3166 ارائه شده است. در بند SELECT مورد نیاز است. شرط reportCountryCode در بند WHERE الزامی است.
report Category Id	string ( int64 format) شناسه دسته‌بندی محصول Google برای محاسبه رتبه‌بندی، که در طبقه‌بندی محصولات Google نشان داده شده است. در بند SELECT مورد نیاز است. اگر شرط WHERE در reportCategoryId در پرس و جو مشخص نشده باشد، رتبه بندی برای همه دسته های سطح بالا بازگردانده می شود.
brand	string نام برند.
rank	string ( int64 format) محبوبیت برند در تبلیغات و سطوح ارگانیک، در دسته بندی و کشور انتخابی، بر اساس تعداد تخمینی تعداد واحدهای فروخته شده.
previous Rank	string ( int64 format) رتبه محبوبیت در هفته یا ماه قبل.
relative Demand	enum ( RelativeDemandEnum ) تقاضای تخمینی در رابطه با نام تجاری با بالاترین رتبه محبوبیت در همان دسته و کشور.
previous Relative Demand	enum ( RelativeDemandEnum ) تقاضای تخمینی در رابطه با نام تجاری با بالاترین رتبه محبوبیت در همان دسته و کشور در هفته یا ماه قبل.
relative Demand Change	enum ( RelativeDemandChangeTypeEnum ) تغییر در تقاضای تخمینی خواه بالا آمد، غرق شد یا صاف ماند.

CompetitiveVisibilityCompetitorView

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

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

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

نمایندگی JSON
{ "date": { object (Date) }, "domain": string, "isYourDomain": boolean, "reportCountryCode": string, "reportCategoryId": string, "trafficSource": enum (TrafficSourceEnum), "rank": string, "adsOrganicRatio": number, "pageOverlapRate": number, "higherPositionRate": number, "relativeVisibility": number }

فیلدها
date	object ( Date ) تاریخ این ردیف. شرط date در بند WHERE الزامی است.
domain	string اگر «isYourDomain» درست باشد، دامنه رقیب یا دامنه شما. در بند SELECT مورد نیاز است. در بند "WHERE" نمی توان آن را فیلتر کرد.
is Your Domain	boolean درست است اگر این ردیف حاوی داده های دامنه شما باشد. در بند "WHERE" نمی توان آن را فیلتر کرد.
report Country Code	string کشوری که برداشت ها ظاهر شد. در بند SELECT مورد نیاز است. یک شرط در reportCountryCode در عبارت WHERE لازم است.
report Category Id	string ( int64 format) شناسه دسته محصول Google برای محاسبه گزارش، که در طبقه‌بندی محصولات Google نشان داده شده است. در بند SELECT مورد نیاز است. یک شرط در reportCategoryId در عبارت WHERE مورد نیاز است.
traffic Source	enum ( TrafficSourceEnum ) منبع ترافیک برداشت ها در بند SELECT مورد نیاز است.
rank	string ( int64 format) موقعیت دامنه در رتبه‌بندی مشاغل مشابه برای کلیدهای انتخابی ( date ، reportCategoryId ، reportCountryCode ، trafficSource ) بر اساس نمایش‌ها. 1 بالاترین است. در بند "WHERE" نمی توان آن را فیلتر کرد.
ads Organic Ratio	number نسبت تبلیغات/ارگانیک نشان می‌دهد که دامنه در مقایسه با ترافیک ارگانیک چقدر از آگهی‌های خرید بازدید می‌کند. عدد گرد و سطل شده است. در بند "WHERE" نمی توان آن را فیلتر کرد.
page Overlap Rate	number نرخ همپوشانی صفحه نشان می‌دهد که چقدر پیشنهادات خرده‌فروشان رقیب همراه با پیشنهادات شما در یک صفحه نشان داده می‌شوند. در بند "WHERE" نمی توان آن را فیلتر کرد.
higher Position Rate	number نرخ موقعیت بالاتر نشان می دهد که هر چند وقت یکبار پیشنهاد یک رقیب در موقعیت بالاتری نسبت به پیشنهاد شما در صفحه قرار می گیرد. در بند "WHERE" نمی توان آن را فیلتر کرد.
relative Visibility	number دید نسبی نشان می دهد که پیشنهادات رقبای شما در مقایسه با پیشنهادات شما چند بار نشان داده می شود. به عبارت دیگر، این تعداد نمایش‌های نمایش‌داده‌شده از یک خرده‌فروش رقیب تقسیم بر تعداد نمایش‌های نمایش‌داده‌شده شما در یک بازه زمانی انتخاب‌شده برای یک دسته محصول و کشور انتخاب‌شده است. در بند "WHERE" نمی توان آن را فیلتر کرد.

TrafficSourceEnum

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

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

CompetitiveVisibilityTopMerchantView

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

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

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

نمایندگی JSON
{ "date": { object (Date) }, "domain": string, "isYourDomain": boolean, "reportCountryCode": string, "reportCategoryId": string, "trafficSource": enum (TrafficSourceEnum), "rank": string, "adsOrganicRatio": number, "pageOverlapRate": number, "higherPositionRate": number }

فیلدها
date	object ( Date ) تاریخ این ردیف. نمی توان در بند SELECT انتخاب کرد. شرط date در بند WHERE الزامی است.
domain	string اگر «isYourDomain» درست باشد، دامنه رقیب یا دامنه شما. در بند SELECT مورد نیاز است. در بند "WHERE" نمی توان آن را فیلتر کرد.
is Your Domain	boolean درست است اگر این ردیف حاوی داده های دامنه شما باشد. در بند "WHERE" نمی توان آن را فیلتر کرد.
report Country Code	string کشوری که برداشت ها ظاهر شد. در بند SELECT مورد نیاز است. یک شرط در reportCountryCode در عبارت WHERE لازم است.
report Category Id	string ( int64 format) شناسه دسته محصول Google برای محاسبه گزارش، که در طبقه‌بندی محصولات Google نشان داده شده است. در بند SELECT مورد نیاز است. یک شرط در reportCategoryId در عبارت WHERE مورد نیاز است.
traffic Source	enum ( TrafficSourceEnum ) منبع ترافیک برداشت ها در بند SELECT مورد نیاز است.
rank	string ( int64 format) موقعیت دامنه در رتبه‌بندی تاجران برتر برای کلیدهای انتخابی ( date ، reportCategoryId ، reportCountryCode ، trafficSource ) بر اساس برداشت‌ها. 1 بالاترین است. در بند "WHERE" نمی توان آن را فیلتر کرد.
ads Organic Ratio	number نسبت تبلیغات/ارگانیک نشان می‌دهد که دامنه در مقایسه با ترافیک ارگانیک چقدر از آگهی‌های خرید بازدید می‌کند. عدد گرد و سطل شده است. در بند "WHERE" نمی توان آن را فیلتر کرد.
page Overlap Rate	number نرخ همپوشانی صفحه نشان می‌دهد که چقدر پیشنهادات خرده‌فروشان رقیب همراه با پیشنهادات شما در یک صفحه نشان داده می‌شوند. در بند "WHERE" نمی توان آن را فیلتر کرد.
higher Position Rate	number نرخ موقعیت بالاتر نشان می دهد که هر چند وقت یکبار پیشنهاد یک رقیب در موقعیت بالاتری نسبت به پیشنهاد شما در صفحه قرار می گیرد. در بند "WHERE" نمی توان آن را فیلتر کرد.

CompetitiveVisibilityBenchmarkView

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

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

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

نمایندگی JSON
{ "date": { object (Date) }, "reportCountryCode": string, "reportCategoryId": string, "trafficSource": enum (TrafficSourceEnum), "yourDomainVisibilityTrend": number, "categoryBenchmarkVisibilityTrend": number }

فیلدها
date	object ( Date ) تاریخ این ردیف. در بند SELECT مورد نیاز است. شرط date در بند WHERE الزامی است.
report Country Code	string کشوری که برداشت ها ظاهر شد. در بند SELECT مورد نیاز است. یک شرط در reportCountryCode در عبارت WHERE لازم است.
report Category Id	string ( int64 format) شناسه دسته محصول Google برای محاسبه گزارش، که در طبقه‌بندی محصولات Google نشان داده شده است. در بند SELECT مورد نیاز است. یک شرط در reportCategoryId در عبارت WHERE مورد نیاز است.
traffic Source	enum ( TrafficSourceEnum ) منبع ترافیک برداشت ها در بند SELECT مورد نیاز است.
your Domain Visibility Trend	number تغییر در نمایان شدن بر اساس نمایش‌های دامنه شما با توجه به شروع محدوده زمانی انتخابی (یا روز اول با نمایش‌های غیر صفر). در بند "WHERE" نمی توان آن را فیلتر کرد.
category Benchmark Visibility Trend	number تغییر در دید بر اساس برداشت‌ها با توجه به شروع محدوده زمانی انتخاب‌شده (یا روز اول با نمایش‌های غیرصفر) برای مجموعه ترکیبی از بازرگانان با بیشترین دید تقریبی بازار. در بند "WHERE" نمی توان آن را فیلتر کرد.

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

،

• منبع: ReportRow
  • نمایندگی JSON
• Product PerformanceView
  • نمایندگی JSON
• MarketingMethodEnum
• NonProductPerformanceView
  • نمایندگی JSON
• ProductView
  • نمایندگی JSON
• AggregatedReportingContextStatus
• ItemIssue
  • نمایندگی JSON
• ItemIssueType
  • نمایندگی JSON
• ItemIssueSeverity
  • نمایندگی JSON
• IssueSeverityPerReportingContext
  • نمایندگی JSON
• AggregatedIssueSeverity
• ItemIssueResolution
• پتانسیل کلیک کنید
• قیمت رقابتی محصول View
  • نمایندگی JSON
• PriceInsightsProductView
  • نمایندگی JSON
• اثربخشی
• پرفروش ترین محصولClusterView
  • نمایندگی JSON
• ReportGranularityEnum
• وضعیت موجودی
• RelativeDemandEnum
• RelativeDemandChangeTypeEnum
• BestSellersBrandView
  • نمایندگی JSON
• CompetitiveVisibilityCompetitorView
  • نمایندگی JSON
• TrafficSourceEnum
• CompetitiveVisibilityTopMerchantView
  • نمایندگی JSON
• CompetitiveVisibilityBenchmarkView
  • نمایندگی JSON
• روش ها

منبع: ReportRow

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

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

نمایندگی JSON

{ "productPerformanceView": { object (ProductPerformanceView) }, "nonProductPerformanceView": { object (NonProductPerformanceView) }, "productView": { object (ProductView) }, "priceCompetitivenessProductView": { object (PriceCompetitivenessProductView) }, "priceInsightsProductView": { object (PriceInsightsProductView) }, "bestSellersProductClusterView": { object (BestSellersProductClusterView) }, "bestSellersBrandView": { object (BestSellersBrandView) }, "competitiveVisibilityCompetitorView": { object (CompetitiveVisibilityCompetitorView) }, "competitiveVisibilityTopMerchantView": { object (CompetitiveVisibilityTopMerchantView) }, "competitiveVisibilityBenchmarkView": { object (CompetitiveVisibilityBenchmarkView) } }

فیلدها
product Performance View	object ( ProductPerformanceView ) فیلدهای موجود برای پرس و جو در جدول productPerformanceView .
non Product Performance View	object ( NonProductPerformanceView ) فیلدهای موجود برای پرس و جو در جدول nonProductPerformanceView .
product View	object ( ProductView ) فیلدهای موجود برای پرس و جو در جدول productView .
price Competitiveness Product View	object ( PriceCompetitivenessProductView ) فیلدهای موجود برای پرس و جو در جدول priceCompetitivenessProductView .
price Insights Product View	object ( PriceInsightsProductView ) فیلدهای موجود برای درخواست در جدول priceInsightsProductView .
best Sellers Product Cluster View	object ( BestSellersProductClusterView ) فیلدهای موجود برای پرس و جو در جدول bestSellersProductClusterView .
best Sellers Brand View	object ( BestSellersBrandView ) فیلدهای موجود برای پرس و جو در جدول bestSellersBrandView .
competitive Visibility Competitor View	object ( CompetitiveVisibilityCompetitorView ) فیلدهای موجود برای پرس و جو در جدول competitiveVisibilityCompetitorView .
competitive Visibility Top Merchant View	object ( CompetitiveVisibilityTopMerchantView ) فیلدهای موجود برای پرس و جو در جدول competitiveVisibilityTopMerchantView .
competitive Visibility Benchmark View	object ( CompetitiveVisibilityBenchmarkView ) فیلدهای موجود برای پرس و جو در جدول competitiveVisibilityBenchmarkView .

Product PerformanceView

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

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

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

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

نمایندگی JSON

{ "date": { object (Date) }, "week": { object (Date) }, "conversionValue": { object (Price) }, "marketingMethod": enum (MarketingMethodEnum), "customerCountryCode": string, "offerId": string, "title": string, "brand": string, "categoryL1": string, "categoryL2": string, "categoryL3": string, "categoryL4": string, "categoryL5": string, "productTypeL1": string, "productTypeL2": string, "productTypeL3": string, "productTypeL4": string, "productTypeL5": string, "customLabel0": string, "customLabel1": string, "customLabel2": string, "customLabel3": string, "customLabel4": string, "clicks": string, "impressions": string, "clickThroughRate": number, "conversions": number, "conversionRate": number }

فیلدها
date	object ( Date ) تاریخ در منطقه زمانی تاجر که معیارها برای آن اعمال می‌شود. بخش. شرط date در بند WHERE الزامی است.
week	object ( Date ) اولین روز هفته (دوشنبه) تاریخ معیارها در منطقه زمانی تاجر. بخش.
conversion Value	object ( Price ) ارزش تبدیل های منتسب به محصول، در تاریخ تبدیل گزارش شده است. متریک. فقط برای منبع ترافیک FREE موجود است.
marketing Method	enum ( 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	string ( int64 format) تعداد کلیک ها متریک.
impressions	string ( int64 format) تعداد دفعاتی که محصولات تاجر نشان داده می شود. متریک.
click Through Rate	number نرخ کلیک - تعداد کلیک‌هایی که محصولات تاجر دریافت می‌کنند (کلیک‌ها) تقسیم بر تعداد دفعاتی که محصولات نشان داده می‌شوند (نمایش‌ها). متریک.
conversions	number تعداد تبدیل‌های منتسب به محصول، گزارش‌شده در تاریخ تبدیل. بسته به مدل انتساب، یک تبدیل ممکن است بین چند کلیک توزیع شود، جایی که هر کلیک اعتبار خود را به خود اختصاص می دهد. این متریک مجموع تمام این اعتبارات است. متریک. فقط برای منبع ترافیک FREE موجود است.
conversion Rate	number تعداد تبدیل‌ها تقسیم بر تعداد کلیک‌ها، گزارش‌شده در تاریخ نمایش. متریک. فقط برای منبع ترافیک FREE موجود است.

MarketingMethodEnum

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

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

NonProductPerformanceView

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

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

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

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

نمایندگی JSON
{ "date": { object (Date) }, "week": { object (Date) }, "clicks": string, "impressions": string, "clickThroughRate": number }

فیلدها
date	object ( Date ) تاریخ در منطقه زمانی تاجر که معیارها برای آن اعمال می‌شود. بخش. شرط date در بند WHERE الزامی است.
week	object ( Date ) اولین روز هفته (دوشنبه) تاریخ معیارها در منطقه زمانی تاجر. بخش.
clicks	string ( int64 format) تعداد کلیک روی تصاویر و لینک های فروشگاه آنلاین منتهی به صفحات غیر محصول شما. متریک.
impressions	string ( int64 format) تعداد دفعاتی که تصاویر و لینک‌های فروشگاه آنلاین منتهی به صفحات غیرمحصولی شما نشان داده شده‌اند. متریک.
click Through Rate	number نرخ کلیک - تعداد کلیک‌ها ( clicks ) تقسیم بر تعداد نمایش‌ها ( impressions ) تصاویر و لینک‌های فروشگاه آنلاین منتهی به صفحات غیر محصول شما. متریک.

ProductView

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

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

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

نمایندگی JSON

{ "price": { object (Price) }, "gtin": [ string ], "creationTime": string, "expirationDate": { object (Date) }, "itemIssues": [ { object (ItemIssue) } ], "clickPotential": enum (ClickPotential), "id": string, "channel": enum (ChannelEnum), "languageCode": string, "feedLabel": string, "offerId": string, "title": string, "brand": string, "categoryL1": string, "categoryL2": string, "categoryL3": string, "categoryL4": string, "categoryL5": string, "productTypeL1": string, "productTypeL2": string, "productTypeL3": string, "productTypeL4": string, "productTypeL5": string, "condition": string, "availability": string, "shippingLabel": string, "itemGroupId": string, "thumbnailLink": string, "aggregatedReportingContextStatus": enum (AggregatedReportingContextStatus), "clickPotentialRank": string }

فیلدها
price	object ( Price ) قیمت محصول. در صورتی که اطلاعاتی در مورد قیمت محصول در دسترس نباشد، وجود ندارد.
gtin[]	string فهرست شماره‌های اقلام تجاری جهانی (GTIN) محصول.
creation Time	string ( Timestamp format) زمانی که تاجر محصول را ایجاد کرد در ثانیه مُهر زمانی.
expiration Date	object ( Date ) تاریخ انقضا برای محصول، درج شده است.
item Issues[]	object ( ItemIssue ) لیست مشکلات اقلام برای محصول از این فیلد نمی توان برای مرتب سازی نتایج استفاده کرد. فقط ویژگی های انتخاب شده این فیلد (به عنوان مثال، itemIssues.severity.aggregated_severity ) می تواند برای فیلتر کردن نتایج استفاده شود.
click Potential	enum ( ClickPotential ) پتانسیل عملکرد تخمینی در مقایسه با محصولات با بالاترین عملکرد تاجر.
id	string REST ID محصول، به شکل channel~languageCode~feedLabel~offerId . روش‌های Merchant API که روی محصولات کار می‌کنند، این پارامتر را به عنوان پارامتر name خود در نظر می‌گیرند. در بند SELECT مورد نیاز است.
channel	enum ( ChannelEnum ) کانال محصول می تواند ONLINE یا LOCAL باشد.
language Code	string کد زبان محصول با فرمت BCP 47.
feed Label	string برچسب خوراک محصول.
offer Id	string شناسه ارائه شده توسط بازرگان محصول.
title	string عنوان محصول.
brand	string مارک محصول.
category L1	string دسته بندی محصولات (سطح اول) در طبقه بندی محصول Google .
category L2	string دسته بندی محصولات (سطح 2) در طبقه بندی محصول Google .
category L3	string دسته بندی محصولات (سطح 3) در طبقه بندی محصول Google .
category L4	string دسته بندی محصولات (سطح 4) در طبقه بندی محصول Google .
category L5	string دسته بندی محصولات (سطح 5) در طبقه بندی محصول Google .
product Type L1	string نوع محصول (سطح 1) در طبقه بندی محصول خود بازرگان.
product Type L2	string نوع محصول (سطح 2) در طبقه بندی محصول خود بازرگان.
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	enum ( AggregatedReportingContextStatus ) وضعیت جمع شده
click Potential Rank	string ( int64 format) رتبه محصول بر اساس پتانسیل کلیک آن. محصولی با clickPotentialRank 1 دارای بالاترین پتانسیل کلیک در بین محصولات بازرگان است که شرایط جستجوی جستجو را برآورده می کند.

جمع شده

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

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

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

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

مورد

مسئله مورد مرتبط با محصول.

نمایندگی JSON
{ "type": { object (ItemIssueType) }, "severity": { object (ItemIssueSeverity) }, "resolution": enum (ItemIssueResolution) }

فیلدها
type	object ( ItemIssueType ) نوع شماره مورد
severity	object ( ItemIssueSeverity ) شدت مورد.
resolution	enum ( ItemIssueResolution ) وضوح مسئله مورد

نوع

نوع شماره

نمایندگی JSON
{ "code": string, "canonicalAttribute": string }

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

موردی

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

نمایندگی JSON
{ "severityPerReportingContext": [ { object (IssueSeverityPerReportingContext) } ], "aggregatedSeverity": enum (AggregatedIssueSeverity) }

فیلدها
severity Per Reporting Context[]	object ( IssueSeverityPerReportingContext ) در هر زمینه گزارش ، شدت را صادر کنید.
aggregated Severity	enum ( AggregatedIssueSeverity ) شدت جمع شده برای همه زمینه های گزارشگری که بر آن تأثیر می گذارد. این قسمت می تواند برای فیلتر کردن نتایج استفاده شود.

ImsueseverityperreportingContext

در هر زمینه گزارش ، شدت را صادر کنید.

نمایندگی JSON
{ "disapprovedCountries": [ string ], "demotedCountries": [ string ], "reportingContext": enum (ReportingContextEnum) }

فیلدها
disapproved Countries[]	string لیست کشورهای تأیید نشده در زمینه گزارش ، که در قالب ISO 3166 ارائه شده است.
demoted Countries[]	string لیست کشورهای تخریب شده در زمینه گزارش ، که در قالب ISO 3166 ارائه شده است.
reporting Context	enum ( ReportingContextEnum ) زمینه گزارش موضوع مربوط به موضوع است.

همگرایی

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

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

حل و فصل

نحوه حل مسئله

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

clickpotential

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

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

PriceCompetitivicivityProductView

زمینه های موجود برای پرس و جو در جدول priceCompetitivenessProductView .

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

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

نمایندگی JSON

{ "price": { object (Price) }, "benchmarkPrice": { object (Price) }, "reportCountryCode": string, "id": string, "offerId": string, "title": string, "brand": string, "categoryL1": string, "categoryL2": string, "categoryL3": string, "categoryL4": string, "categoryL5": string, "productTypeL1": string, "productTypeL2": string, "productTypeL3": string, "productTypeL4": string, "productTypeL5": string }

فیلدها
price	object ( Price ) قیمت فعلی محصول.
benchmark Price	object ( Price ) آخرین معیار قیمت موجود برای کاتالوگ محصول در کشور معیار.
report Country Code	string کشور معیار قیمت. در قالب ISO 3166 نشان داده شده است. مورد نیاز در بند SELECT .
id	string شناسه استراحت محصول ، به شکل channel~languageCode~feedLabel~offerId . می توان برای پیوستن به داده ها با جدول productView استفاده کرد. مورد نیاز در بند SELECT .
offer Id	string شناسه ارائه شده توسط بازرگان محصول.
title	string عنوان محصول.
brand	string مارک محصول.
category L1	string دسته بندی محصولات (سطح اول) در طبقه بندی محصول Google .
category L2	string دسته بندی محصولات (سطح 2) در طبقه بندی محصول Google .
category L3	string دسته بندی محصولات (سطح 3) در طبقه بندی محصول Google .
category L4	string دسته بندی محصولات (سطح 4) در طبقه بندی محصول Google .
category L5	string دسته بندی محصولات (سطح 5) در طبقه بندی محصول Google .
product Type L1	string نوع محصول (سطح 1) در طبقه بندی محصول خود بازرگان.
product Type L2	string نوع محصول (سطح 2) در طبقه بندی محصول خود بازرگان.
product Type L3	string نوع محصول (سطح 3) در طبقه بندی محصول خود بازرگان.
product Type L4	string نوع محصول (سطح 4) در طبقه بندی محصول خود بازرگان.
product Type L5	string نوع محصول (سطح 5) در طبقه بندی محصول خود بازرگان.

PriceInsightsProductView

زمینه های موجود برای پرس و جو در جدول priceInsightsProductView .

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

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

نمایندگی JSON

{ "price": { object (Price) }, "suggestedPrice": { object (Price) }, "effectiveness": enum (Effectiveness), "id": string, "offerId": string, "title": string, "brand": string, "categoryL1": string, "categoryL2": string, "categoryL3": string, "categoryL4": string, "categoryL5": string, "productTypeL1": string, "productTypeL2": string, "productTypeL3": string, "productTypeL4": string, "productTypeL5": string, "predictedImpressionsChangeFraction": number, "predictedClicksChangeFraction": number, "predictedConversionsChangeFraction": number }

فیلدها
price	object ( Price ) قیمت فعلی محصول.
suggested Price	object ( Price ) آخرین قیمت پیشنهادی برای محصول.
effectiveness	enum ( Effectiveness ) اثربخشی پیش بینی شده در استفاده از پیشنهاد قیمت ، سطل.
id	string شناسه استراحت محصول ، به شکل channel~languageCode~feedLabel~offerId . می توان برای پیوستن به داده ها با جدول productView استفاده کرد. مورد نیاز در بند SELECT .
offer Id	string شناسه ارائه شده توسط بازرگان محصول.
title	string عنوان محصول.
brand	string مارک محصول.
category L1	string دسته بندی محصولات (سطح اول) در طبقه بندی محصول Google .
category L2	string دسته بندی محصولات (سطح 2) در طبقه بندی محصول Google .
category L3	string دسته بندی محصولات (سطح 3) در طبقه بندی محصول Google .
category L4	string دسته بندی محصولات (سطح 4) در طبقه بندی محصول Google .
category L5	string دسته بندی محصولات (سطح 5) در طبقه بندی محصول Google .
product Type L1	string نوع محصول (سطح 1) در طبقه بندی محصول خود بازرگان.
product Type L2	string نوع محصول (سطح 2) در طبقه بندی محصول خود بازرگان.
product Type L3	string نوع محصول (سطح 3) در طبقه بندی محصول خود بازرگان.
product Type L4	string نوع محصول (سطح 4) در طبقه بندی محصول خود بازرگان.
product Type L5	string نوع محصول (سطح 5) در طبقه بندی محصول خود بازرگان.
predicted Impressions Change Fraction	number تغییر در برداشت ها به عنوان کسری پس از معرفی قیمت پیشنهادی در مقایسه با قیمت فعال فعلی پیش بینی شده است. به عنوان مثال ، 0.05 افزایش 5 ٪ پیش بینی شده در برداشت ها است.
predicted Clicks Change Fraction	number پیش بینی تغییر در کلیک به عنوان کسری پس از معرفی قیمت پیشنهادی در مقایسه با قیمت فعال فعلی. به عنوان مثال ، 0.05 افزایش 5 ٪ پیش بینی شده در کلیک است.
predicted Conversions Change Fraction	number تغییر در تبدیل به عنوان کسری پس از معرفی قیمت پیشنهادی در مقایسه با قیمت فعال فعلی پیش بینی شده است. به عنوان مثال ، 0.05 افزایش 5 ٪ پیش بینی شده در تبدیل ها).

اثربخشی

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

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

Enums
EFFECTIVENESS_UNSPECIFIED	اثربخشی ناشناخته است.
LOW	اثربخشی کم است.
MEDIUM	اثربخشی متوسط ​​است.
HIGH	اثربخشی زیاد است.

پرفروش ProductClusterView

زمینه های موجود برای پرس و جو در جدول bestSellersProductClusterView .

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

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

نمایندگی JSON

{ "reportDate": { object (Date) }, "variantGtins": [ string ], "reportGranularity": enum (ReportGranularityEnum), "reportCountryCode": string, "reportCategoryId": string, "title": string, "brand": string, "categoryL1": string, "categoryL2": string, "categoryL3": string, "categoryL4": string, "categoryL5": string, "inventoryStatus": enum (InventoryStatus), "brandInventoryStatus": enum (InventoryStatus), "rank": string, "previousRank": string, "relativeDemand": enum (RelativeDemandEnum), "previousRelativeDemand": enum (RelativeDemandEnum), "relativeDemandChange": enum (RelativeDemandChangeTypeEnum) }

فیلدها
report Date	object ( Date ) تاریخ گزارش مقدار این قسمت فقط می تواند یکی از موارد زیر باشد: روز اول هفته (دوشنبه) برای گزارش های هفتگی ، روز اول ماه برای گزارش های ماهانه. مورد نیاز در بند SELECT . اگر شرایط WHERE reportDate در پرس و جو مشخص نشده باشد ، آخرین گزارش هفتگی یا ماهانه موجود است.
variant Gtins[]	string gtins از انواع نمونه های خوشه محصول.
report Granularity	enum ( ReportGranularityEnum ) دانه بندی گزارش. این رتبه بندی می تواند بیش از یک هفته یا یک ماه زمانی انجام شود. مورد نیاز در بند SELECT . شرط reportGranularity در بند WHERE لازم است.
report Country Code	string کشوری که رتبه بندی آن محاسبه می شود. در قالب ISO 3166 نشان داده شده است. مورد نیاز در بند SELECT . شرط reportCountryCode در بند WHERE لازم است.
report Category Id	string ( int64 format) شناسه دسته محصولات Google برای محاسبه رتبه بندی برای ، ارائه شده در طبقه بندی محصول Google . مورد نیاز در بند SELECT . اگر شرط WHERE در reportCategoryId در پرس و جو مشخص نشده باشد ، رتبه بندی برای همه دسته های سطح بالا بازگردانده می شود.
title	string عنوان خوشه محصول.
brand	string مارک خوشه محصول.
category L1	string دسته محصول (سطح 1) خوشه محصول ، که در طبقه بندی محصول Google نشان داده شده است.
category L2	string دسته بندی محصولات (سطح 2) خوشه محصول ، که در طبقه بندی محصول Google نشان داده شده است.
category L3	string دسته بندی محصولات (سطح 3) خوشه محصول ، که در طبقه بندی محصول Google نشان داده شده است.
category L4	string دسته محصول (سطح 4) خوشه محصول ، که در طبقه بندی محصول Google نشان داده شده است.
category L5	string دسته محصول (سطح 5) خوشه محصول ، که در طبقه بندی محصول Google نشان داده شده است.
inventory Status	enum ( InventoryStatus ) این که آیا خوشه محصول حداقل در یکی از کشورها در منبع داده محصول شما در منبع داده شما IN_STOCK دارد ، از منبع داده محصول شما در همه کشورها OUT_OF_STOCK ، یا اصلاً NOT_IN_INVENTORY . این زمینه فیلتر کشور پرفروش را در نظر نمی گیرد.
brand Inventory Status	enum ( InventoryStatus ) این که آیا حداقل یک محصول از برند در حال حاضر در منبع داده محصول شما در حداقل یکی از کشورها IN_STOCK دارد ، همه محصولات در منبع داده محصول شما در همه کشورها OUT_OF_STOCK هستند یا NOT_IN_INVENTORY . این زمینه فیلتر کشور پرفروش را در نظر نمی گیرد.
rank	string ( int64 format) محبوبیت خوشه محصول در تبلیغات و سطوح ارگانیک ، در گروه و کشور منتخب ، بر اساس تعداد تخمینی واحدهای فروخته شده.
previous Rank	string ( int64 format) رتبه محبوبیت در هفته یا ماه گذشته.
relative Demand	enum ( RelativeDemandEnum ) تقاضای تخمین زده شده در رابطه با خوشه محصول با بالاترین رتبه محبوبیت در همان گروه و کشور.
previous Relative Demand	enum ( RelativeDemandEnum ) تقاضای تخمین زده شده در رابطه با خوشه محصول با بالاترین رتبه محبوبیت در همان گروه و کشور در هفته یا ماه گذشته.
relative Demand Change	enum ( RelativeDemandChangeTypeEnum ) تغییر در تقاضای تخمینی. چه برخاست ، غرق شد و چه صاف بماند.

گزارشگری

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

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

موجودی

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

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

intivediveMandenum

ارزشهای تقاضای نسبی.

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

رابطه

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

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

پرفروش BrandView

زمینه های موجود برای پرس و جو در جدول bestSellersBrandView .

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

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

نمایندگی JSON
{ "reportDate": { object (Date) }, "reportGranularity": enum (ReportGranularityEnum), "reportCountryCode": string, "reportCategoryId": string, "brand": string, "rank": string, "previousRank": string, "relativeDemand": enum (RelativeDemandEnum), "previousRelativeDemand": enum (RelativeDemandEnum), "relativeDemandChange": enum (RelativeDemandChangeTypeEnum) }

فیلدها
report Date	object ( Date ) تاریخ گزارش مقدار این قسمت فقط می تواند یکی از موارد زیر باشد: روز اول هفته (دوشنبه) برای گزارش های هفتگی ، روز اول ماه برای گزارش های ماهانه. مورد نیاز در بند SELECT . اگر شرایط WHERE reportDate در پرس و جو مشخص نشده باشد ، آخرین گزارش هفتگی یا ماهانه موجود است.
report Granularity	enum ( ReportGranularityEnum ) دانه بندی گزارش. این رتبه بندی می تواند بیش از یک هفته یا یک ماه زمانی انجام شود. مورد نیاز در بند SELECT . شرط reportGranularity در بند WHERE لازم است.
report Country Code	string کشوری که رتبه بندی آن محاسبه می شود. در قالب ISO 3166 نشان داده شده است. مورد نیاز در بند SELECT . شرط reportCountryCode در بند WHERE لازم است.
report Category Id	string ( int64 format) شناسه دسته محصولات Google برای محاسبه رتبه بندی برای ، ارائه شده در طبقه بندی محصول Google . مورد نیاز در بند SELECT . اگر شرط WHERE در reportCategoryId در پرس و جو مشخص نشده باشد ، رتبه بندی برای همه دسته های سطح بالا بازگردانده می شود.
brand	string نام برند.
rank	string ( int64 format) محبوبیت برند در تبلیغات و سطوح ارگانیک ، در گروه و کشور منتخب ، بر اساس تعداد تخمینی واحدهای فروخته شده.
previous Rank	string ( int64 format) رتبه محبوبیت در هفته یا ماه گذشته.
relative Demand	enum ( RelativeDemandEnum ) تقاضای تخمین زده شده در رابطه با برند با بالاترین رتبه محبوبیت در همان گروه و کشور.
previous Relative Demand	enum ( RelativeDemandEnum ) تقاضای تخمین زده شده در رابطه با برند با بالاترین رتبه محبوبیت در همان گروه و کشور در هفته یا ماه گذشته.
relative Demand Change	enum ( RelativeDemandChangeTypeEnum ) تغییر در تقاضای تخمینی. چه برخاست ، غرق شد و چه صاف بماند.

Competitive VisibilityCompetitorView

زمینه های موجود برای پرس و جو در جدول competitiveVisibilityCompetitorView .

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

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

نمایندگی JSON
{ "date": { object (Date) }, "domain": string, "isYourDomain": boolean, "reportCountryCode": string, "reportCategoryId": string, "trafficSource": enum (TrafficSourceEnum), "rank": string, "adsOrganicRatio": number, "pageOverlapRate": number, "higherPositionRate": number, "relativeVisibility": number }

فیلدها
date	object ( Date ) تاریخ این ردیف. شرط date در بند WHERE لازم است.
domain	string دامنه رقیب یا دامنه شما ، اگر "isyourdomain" درست است. مورد نیاز در بند SELECT . نمی توان در بند "کجا" فیلتر کرد.
is Your Domain	boolean درست است اگر این ردیف حاوی داده هایی برای دامنه شما باشد. نمی توان در بند "کجا" فیلتر کرد.
report Country Code	string کشوری که برداشت ها در آن ظاهر شد. مورد نیاز در بند SELECT . شرط موجود در reportCountryCode در بند WHERE لازم است.
report Category Id	string ( int64 format) شناسه دسته محصولات Google برای محاسبه گزارش ، که در طبقه بندی محصول Google ارائه شده است. مورد نیاز در بند SELECT . شرط مربوط به reportCategoryId در بند WHERE لازم است.
traffic Source	enum ( TrafficSourceEnum ) منبع ترافیک برداشت. مورد نیاز در بند SELECT .
rank	string ( int64 format) موقعیت دامنه در رتبه بندی مشاغل مشابه برای کلیدهای منتخب ( date ، reportCategoryId ، reportCountryCode ، trafficSource ) بر اساس برداشت ها. 1 بالاترین است. نمی توان در بند "کجا" فیلتر کرد.
ads Organic Ratio	number ADS / نسبت ارگانیک نشان می دهد که چند بار دامنه در مقایسه با ترافیک ارگانیک برداشت از تبلیغات خرید را دریافت می کند. تعداد گرد و سطحی است. نمی توان در بند "کجا" فیلتر کرد.
page Overlap Rate	number نرخ همپوشانی صفحه نشان می دهد که چقدر پیشنهادات خرده فروشان رقیب همراه با پیشنهادات شما در همان صفحه نشان داده می شود. نمی توان در بند "کجا" فیلتر کرد.
higher Position Rate	number نرخ موقعیت بالاتر نشان می دهد که چند بار پیشنهاد رقیب در موقعیت بالاتری در صفحه قرار می گیرد تا پیشنهاد شما. نمی توان در بند "کجا" فیلتر کرد.
relative Visibility	number دید نسبی نشان می دهد که چند بار پیشنهادات رقبای شما در مقایسه با پیشنهادات شما نشان داده می شود. به عبارت دیگر ، این تعداد برداشت های نمایش داده شده از یک خرده فروش رقیب است که بر اساس تعداد برداشت های نمایش داده شده شما در طی یک محدوده زمانی انتخاب شده برای یک دسته محصول و کشور انتخاب شده تقسیم می شود. نمی توان در بند "کجا" فیلتر کرد.

پیش بینی

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

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

Competitive VisibilityTopmerChantView

زمینه های موجود برای پرس و جو در جدول competitiveVisibilityTopMerchantView .

گزارش دید رقابتی با تجارت با بالاترین دید.

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

نمایندگی JSON
{ "date": { object (Date) }, "domain": string, "isYourDomain": boolean, "reportCountryCode": string, "reportCategoryId": string, "trafficSource": enum (TrafficSourceEnum), "rank": string, "adsOrganicRatio": number, "pageOverlapRate": number, "higherPositionRate": number }

فیلدها
date	object ( Date ) تاریخ این ردیف. نمی توان در بند SELECT انتخاب کرد. شرط date در بند WHERE لازم است.
domain	string دامنه رقیب یا دامنه شما ، اگر "isyourdomain" درست است. مورد نیاز در بند SELECT . نمی توان در بند "کجا" فیلتر کرد.
is Your Domain	boolean درست است اگر این ردیف حاوی داده هایی برای دامنه شما باشد. نمی توان در بند "کجا" فیلتر کرد.
report Country Code	string کشوری که برداشت ها در آن ظاهر شد. مورد نیاز در بند SELECT . شرط موجود در reportCountryCode در بند WHERE لازم است.
report Category Id	string ( int64 format) شناسه دسته محصولات Google برای محاسبه گزارش ، که در طبقه بندی محصول Google ارائه شده است. مورد نیاز در بند SELECT . شرط مربوط به reportCategoryId در بند WHERE لازم است.
traffic Source	enum ( TrafficSourceEnum ) منبع ترافیک برداشت. مورد نیاز در بند SELECT .
rank	string ( int64 format) موقعیت دامنه در رتبه برتر بازرگانان برای کلیدهای منتخب ( date ، reportCategoryId ، reportCountryCode ، trafficSource ) بر اساس برداشت ها. 1 بالاترین است. نمی توان در بند "کجا" فیلتر کرد.
ads Organic Ratio	number ADS / نسبت ارگانیک نشان می دهد که چند بار دامنه در مقایسه با ترافیک ارگانیک برداشت از تبلیغات خرید را دریافت می کند. تعداد گرد و سطحی است. نمی توان در بند "کجا" فیلتر کرد.
page Overlap Rate	number نرخ همپوشانی صفحه نشان می دهد که چقدر پیشنهادات خرده فروشان رقیب همراه با پیشنهادات شما در همان صفحه نشان داده می شود. نمی توان در بند "کجا" فیلتر کرد.
higher Position Rate	number نرخ موقعیت بالاتر نشان می دهد که چند بار پیشنهاد رقیب در موقعیت بالاتری در صفحه قرار می گیرد تا پیشنهاد شما. نمی توان در بند "کجا" فیلتر کرد.

Competitive VisibilityBenchmarkView

زمینه های موجود برای پرس و جو در جدول competitiveVisibilityBenchmarkView .

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

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

نمایندگی JSON
{ "date": { object (Date) }, "reportCountryCode": string, "reportCategoryId": string, "trafficSource": enum (TrafficSourceEnum), "yourDomainVisibilityTrend": number, "categoryBenchmarkVisibilityTrend": number }

فیلدها
date	object ( Date ) تاریخ این ردیف. مورد نیاز در بند SELECT . شرط date در بند WHERE لازم است.
report Country Code	string کشوری که برداشت ها در آن ظاهر شد. مورد نیاز در بند SELECT . شرط موجود در reportCountryCode در بند WHERE لازم است.
report Category Id	string ( int64 format) شناسه دسته محصولات Google برای محاسبه گزارش ، که در طبقه بندی محصول Google ارائه شده است. مورد نیاز در بند SELECT . شرط مربوط به reportCategoryId در بند WHERE لازم است.
traffic Source	enum ( TrafficSourceEnum ) منبع ترافیک برداشت. مورد نیاز در بند SELECT .
your Domain Visibility Trend	number تغییر در دید بر اساس برداشت های مربوط به دامنه خود با توجه به شروع محدوده زمانی انتخاب شده (یا روز اول با برداشت های غیر صفر). نمی توان در بند "کجا" فیلتر کرد.
category Benchmark Visibility Trend	number تغییر در دید بر اساس برداشت ها با توجه به شروع محدوده زمانی انتخاب شده (یا روز اول با برداشت های غیر صفر) برای یک مجموعه ترکیبی از بازرگانان با بالاترین دید در بازار. نمی توان در بند "کجا" فیلتر کرد.

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