Method: accounts.reports.search

يسترد تقريرًا محددًا بواسطة طلب بحث. قد يحتوي الردّ على عدد أقل من الصفوف التي حدّدتها السياسة pageSize. اعتمِد على nextPageToken لتحديد ما إذا كان هناك المزيد من الصفوف المطلوب طلبها.

طلب HTTP

POST https://merchantapi.googleapis.com/reports/v1beta/{parent=accounts/*}/reports:search

يستخدِم عنوان URL بنية تحويل ترميز gRPC.

مَعلمات المسار

المعلمات
parent

string

مطلوبة. رقم تعريف الحساب الذي يجري المكالمة يجب أن يكون حسابًا مستقلاً أو حسابًا فرعيًا متعدّد العملاء. التنسيق: accounts/{account}

نص الطلب

يحتوي نص الطلب على بيانات بالبنية التالية:

تمثيل JSON 
{
  "query": string,
  "pageSize": integer,
  "pageToken": string
}
الحقول
query

string

مطلوبة. طلب بحث يحدّد تقريرًا ليتم استرداده

للحصول على تفاصيل حول كيفية إنشاء الاستعلام، راجع دليل لغة الاستعلام. للحصول على القائمة الكاملة للجداول والحقول المتاحة، اطّلِع على الحقول المتاحة.
pageSize

integer

اختياريّ. عدد ReportRows المطلوب استردادها في صفحة واحدة. القيمة التلقائية هي 1,000. يتم فرض القيم التي تزيد عن 5000 على 5000.
pageToken

string

اختياريّ. الرمز المميّز للصفحة المطلوب استردادها وإذا لم يتم تحديدها، سيتم عرض الصفحة الأولى من النتائج. لطلب الانتقال إلى صفحة النتائج التالية، يجب استخدام القيمة التي تم الحصول عليها من nextPageToken في الردّ السابق.

نص الاستجابة

رسالة الردّ على طريقة ReportService.Search

إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:

تمثيل JSON 
{
  "results": [
    {
      object (ReportRow)
    }
  ],
  "nextPageToken": string
}
الحقول
results[]

object (ReportRow)

الصفوف التي تطابقت مع طلب البحث
nextPageToken

string

الرمز المميز الذي يمكن إرساله على شكل pageToken لاسترداد الصفحة التالية. في حال إسقاطها، لن تظهر الصفحات اللاحقة.

نطاقات الأذونات

يجب توفير نطاق OAuth التالي:

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

لمزيد من المعلومات، يُرجى الاطِّلاع على نظرة عامة على OAuth 2.0.

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)
  }
}
الحقول
productPerformanceView

object (ProductPerformanceView)

الحقول المتاحة لطلب البحث في جدول "productPerformanceView".
nonProductPerformanceView

object (NonProductPerformanceView)

الحقول المتاحة لطلب البحث في جدول "nonProductPerformanceView".
productView

object (ProductView)

الحقول المتاحة لطلب البحث في جدول "productView".
priceCompetitivenessProductView

object (PriceCompetitivenessProductView)

الحقول المتاحة لطلب البحث في جدول "priceCompetitivenessProductView".
priceInsightsProductView

object (PriceInsightsProductView)

الحقول المتاحة لطلب البحث في جدول "priceInsightsProductView".
bestSellersProductClusterView

object (BestSellersProductClusterView)

الحقول المتاحة لطلب البحث في جدول "bestSellersProductClusterView".
bestSellersBrandView

object (BestSellersBrandView)

الحقول المتاحة لطلب البحث في جدول "bestSellersBrandView".
competitiveVisibilityCompetitorView

object (CompetitiveVisibilityCompetitorView)

الحقول المتاحة لطلب البحث في جدول "competitiveVisibilityCompetitorView".
competitiveVisibilityTopMerchantView

object (CompetitiveVisibilityTopMerchantView)

الحقول المتاحة لطلب البحث في جدول "competitiveVisibilityTopMerchantView".
competitiveVisibilityBenchmarkView

object (CompetitiveVisibilityBenchmarkView)

الحقول المتاحة لطلب البحث في جدول "competitiveVisibilityBenchmarkView".

ProductPerformanceView

الحقول المتاحة لطلب البحث في جدول "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)

اليوم الأول من الأسبوع (الاثنين) من تاريخ المقاييس في المنطقة الزمنية للتاجر القسم
conversionValue

object (Price)

قيمة الإحالات الناجحة المنسوبة إلى المنتج، ويتم الإبلاغ عنها في تاريخ الإحالة الناجحة. المقياس.

متاحة فقط لمصدر الزيارات "FREE".
marketingMethod

enum (MarketingMethodEnum)

طريقة التسويق التي تنطبق عليها المقاييس. القسم
customerCountryCode

string

تمثّل هذه السمة رمز البلد الذي يقيم فيه العميل في وقت الفعالية. ويتم تمثيلها بتنسيق ISO 3166. القسم

إذا تعذّر تحديد بلد العميل، يتم عرض رمز 'ZZ' خاص.
offerId

string

معرّف المنتج الذي قدّمه التاجر القسم
title

string

عنوان المنتج. القسم
brand

string

تمثّل هذه السمة العلامة التجارية للمنتج. القسم
categoryL1

string

فئة المنتج (المستوى الأول) في تصنيف المنتجات من Google. القسم
categoryL2

string

فئة المنتج (المستوى الثاني) في تصنيف المنتجات من Google. القسم
categoryL3

string

فئة المنتج (المستوى الثالث) في تصنيف المنتجات من Google. القسم
categoryL4

string

فئة المنتج (المستوى الرابع) في تصنيف المنتجات من Google. القسم
categoryL5

string

فئة المنتج (المستوى الخامس) في تصنيف المنتجات من Google. القسم
productTypeL1

string

نوع المنتج (المستوى الأول) في تصنيف المنتج الخاص بالتاجر. القسم
productTypeL2

string

نوع المنتج (المستوى الثاني) في تصنيف المنتج الخاص بالتاجر. القسم
productTypeL3

string

نوع المنتج (المستوى الثالث) في تصنيف المنتج الخاص بالتاجر. القسم
productTypeL4

string

نوع المنتج (المستوى الرابع) في تصنيف المنتج الخاص بالتاجر. القسم
productTypeL5

string

نوع المنتج (المستوى الخامس) في تصنيف المنتج الخاص بالتاجر. القسم
customLabel0

string

التصنيف المخصّص 0 لتجميع المنتجات حسب الطلب. القسم
customLabel1

string

التصنيف المخصّص 1 لتجميع المنتجات حسب الطلب. القسم
customLabel2

string

التصنيف المخصّص 2 لتجميع المنتجات حسب الطلب. القسم
customLabel3

string

تصنيف مخصّص 3 لتجميع المنتجات المخصّص. القسم
customLabel4

string

تصنيف مخصّص 4 لتجميع المنتجات المخصّص. القسم
clicks

string (int64 format)

عدد النقرات المقياس.
impressions

string (int64 format)

عدد مرّات عرض منتجات التاجر المقياس.
clickThroughRate

number

نسبة النقر إلى الظهور: عدد النقرات التي تتلقّاها منتجات التاجر (النقرات) مقسومًا على عدد مرات عرض المنتجات (عدد مرات الظهور). المقياس.
conversions

number

عدد الإحالات الناجحة المنسوبة إلى المنتج، والتي يتم الإبلاغ عنها في تاريخ الإحالة الناجحة. استنادًا إلى نموذج تحديد المصدر، قد يتم توزيع الإحالة الناجحة على نقرات متعددة، حيث يتم تخصيص نسبة مساهمة لكل نقرة. وهذا المقياس هو مجموع كل هذه الأرصدة. المقياس.

متاحة فقط لمصدر الزيارات "FREE".
conversionRate

number

عدد الإحالات الناجحة مقسومًا على عدد النقرات، ويتم تسجيله في تاريخ الظهور. المقياس.

متاحة فقط لمصدر الزيارات "FREE".

MarketingMethodEnum

قيم طريقة التسويق.

عمليات التعداد
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)

عدد مرّات عرض الصور وروابط المتاجر على الإنترنت التي أدّت إلى صفحات غير مرتبطة بالمنتجات المقياس.
clickThroughRate

number

نسبة النقر إلى الظهور: عدد النقرات (clicks) مقسومًا على عدد مرات الظهور (impressions) للصور وروابط المتاجر على الإنترنت التي تؤدي إلى صفحاتك التي لا تتضمّن منتجات. المقياس.

ProductView

الحقول المتاحة لطلب البحث في جدول "productView".

المنتجات المتوفّرة في المستودع الحالي المنتجات الواردة في هذا الجدول مماثلة للمنتجات في واجهة برمجة التطبيقات الفرعية للمنتجات، ولكن لا تتوفر جميع سمات المنتجات من واجهة برمجة التطبيقات الفرعية للمنتجات لطلب البحث في هذا الجدول. وعلى عكس واجهة برمجة التطبيقات الفرعية للمنتجات، يسمح هذا الجدول بفلترة قائمة المنتجات التي تم إرجاعها حسب سمات المنتجات. لاسترداد منتج واحد بحلول id أو إدراج كل المنتجات، يجب استخدام واجهة برمجة تطبيقات المنتجات الفرعية.

يتم ضبط القيم فقط للحقول المطلوبة صراحةً في طلب البحث الخاص بالطلب.

تمثيل 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) الخاصة بالمنتج
creationTime

string (Timestamp format)

الوقت الذي أنشأ فيه التاجر المنتج بالثواني
expirationDate

object (Date)

تاريخ انتهاء صلاحية المنتج المحدَّد عند إدراجه
itemIssues[]

object (ItemIssue)

قائمة مشاكل السلع الخاصة بالمنتج

لا يمكن استخدام هذا الحقل لترتيب النتائج.

يمكن استخدام السمات التي تم اختيارها لهذا الحقل (مثلاً itemIssues.severity.aggregated_severity) لفلترة النتائج.
clickPotential

enum (ClickPotential)

إمكانات الأداء المقدّرة مقارنةً بمنتجات التاجر الأفضل أداءً
id

string

تمثّل هذه السمة معرّف REST للمنتج في شكل channel~languageCode~feedLabel~offerId. تستخدم طرق Merchant API التي تعمل على المنتجات هذه السمة كمَعلمة name الخاصة بها.

مطلوبة في البند SELECT.
channel

enum (ChannelEnum)

قناة المنتج يمكن أن يكون ONLINE أو LOCAL.
languageCode

string

رمز لغة المنتج بتنسيق BCP 47
feedLabel

string

تصنيف خلاصة المنتج
offerId

string

معرّف المنتج الذي قدّمه التاجر
title

string

عنوان المنتج.
brand

string

تمثّل هذه السمة العلامة التجارية للمنتج.
categoryL1

string

فئة المنتج (المستوى الأول) في تصنيف المنتجات من Google.
categoryL2

string

فئة المنتج (المستوى الثاني) في تصنيف المنتجات من Google.
categoryL3

string

فئة المنتج (المستوى الثالث) في تصنيف المنتجات من Google.
categoryL4

string

فئة المنتج (المستوى الرابع) في تصنيف المنتج من Google.
categoryL5

string

فئة المنتج (المستوى الخامس) في تصنيف المنتجات من Google.
productTypeL1

string

نوع المنتج (المستوى الأول) في تصنيف المنتج الخاصة بالتاجر.
productTypeL2

string

نوع المنتج (المستوى الثاني) في تصنيف المنتجات الخاصة بالتاجر
productTypeL3

string

نوع المنتج (المستوى الثالث) في تصنيف المنتج الخاصة بالتاجر.
productTypeL4

string

نوع المنتج (المستوى الرابع) في تصنيف المنتج التي حدّدها التاجر.
productTypeL5

string

نوع المنتج (المستوى الخامس) في تصنيف المنتج الخاصة بالتاجر.
condition

string

حالة المنتج:
availability

string

مدى توفّر المنتج.
shippingLabel

string

تصنيف الحزمة المسواة المحدد في مصدر البيانات.
itemGroupId

string

معرّف مجموعة السلع الذي قدّمه التاجر لتجميع خيارات المنتج معًا
aggregatedReportingContextStatus

enum (AggregatedReportingContextStatus)

الحالة المجمّعة.
clickPotentialRank

string (int64 format)

ترتيب المنتج استنادًا إلى فرص النقر عليه. يحظى المنتج الذي يتضمّن القيمة clickPotentialRank 1 بأعلى فرص محتملة للنقر بين منتجات التاجر التي تستوفي شروط طلب البحث.

AggregatedReportingContextStatus

حالة المنتج المجمّعة لكل سياقات إعداد التقارير.

في ما يلي مثال على كيفية احتساب الحالة المجمّعة:

البيانات المجّانية إعلانات Shopping الحالة
Approved Approved مؤهّلة
Approved في انتظار الموافقة مؤهّلة
Approved مرفوض ELIGIBLE_LIMITED
في انتظار الموافقة في انتظار الموافقة في انتظار المراجعة
مرفوض مرفوض NOT_ELIGIBLE_OR_DISAPPROVED
عمليات التعداد
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 ضمن مشاكل المنتجات
canonicalAttribute

string

اسم السمة الأساسية للمشاكل الخاصة بالسمات

ItemIssueSeverity

كيفية تأثير المشكلة في عرض المنتج

تمثيل JSON 
{
  "severityPerReportingContext": [
    {
      object (IssueSeverityPerReportingContext)
    }
  ],
  "aggregatedSeverity": enum (AggregatedIssueSeverity)
}
الحقول
severityPerReportingContext[]

object (IssueSeverityPerReportingContext)

درجة خطورة المشاكل حسب سياق إعداد التقارير.
aggregatedSeverity

enum (AggregatedIssueSeverity)

درجة الخطورة المُجمَّعة للمشكلة في جميع سياقات إعداد التقارير التي تؤثر فيها

يمكن استخدام هذا الحقل لفلترة النتائج.

IssueSeverityPerReportingContext

درجة خطورة المشاكل حسب سياق إعداد التقارير.

تمثيل JSON 
{
  "disapprovedCountries": [
    string
  ],
  "demotedCountries": [
    string
  ],
  "reportingContext": enum (ReportingContextEnum)
}
الحقول
disapprovedCountries[]

string

قائمة بالبلدان المرفوضة في سياق إعداد التقارير، ممثلة بتنسيق ISO 3166
demotedCountries[]

string

قائمة بالبلدان التي تم خفض ترتيبها في سياق إعداد التقارير، ممثلة بتنسيق ISO 3166
reportingContext

enum (ReportingContextEnum)

سياق إعداد التقارير الذي تنطبق عليه المشكلة

AggregatedIssueSeverity

مدى خطورة المشاكل المجمَّعة لكل سياقات إعداد التقارير.

عمليات التعداد
AGGREGATED_ISSUE_SEVERITY_UNSPECIFIED لم يتم تحديده.
DISAPPROVED تؤدي المشكلة إلى رفض المنتج في سياق إعداد تقارير واحد على الأقل.
DEMOTED تؤدي المشكلة إلى خفض ترتيب المنتج في جميع سياقات إعداد التقارير التي تؤثّر فيها.
PENDING تم حلّ المشكلة في PENDING_PROCESSING.

ItemIssueResolution

كيفية حلّ المشكلة

عمليات التعداد
ITEM_ISSUE_RESOLUTION_UNSPECIFIED لم يتم تحديده.
MERCHANT_ACTION على التاجر حلّ المشكلة.
PENDING_PROCESSING سيتم حلّ المشكلة تلقائيًا (على سبيل المثال، الزحف إلى الصور) أو من خلال مراجعة على Google. ليس عليك اتّخاذ أي إجراء من التاجر الآن. وقد يؤدي الحل إلى مشكلة أخرى (على سبيل المثال، في حال تعذُّر الزحف).

ClickPotential

تقدّر فرص النقر على منتج معيّن الأداء المحتمَل له مقارنةً بمنتجات التاجر الأفضل أداءً. إنّ فرص النقر على أحد المنتجات تساعد التجّار على تحديد المنتجات التي يجب إصلاحها قبل غيرها وفهم الأداء الحالي للمنتجات مقارنةً بإمكانياتهم.

عمليات التعداد
CLICK_POTENTIAL_UNSPECIFIED تأثير النقرات المتوقّعة غير معروف.
LOW من المحتمَل جذب عدد منخفض من النقرات مقارنةً بالمنتجات الأعلى أداءً لدى التاجر.
MEDIUM من المحتمَل جذب عدد متوسط من النقرات مقارنةً بالمنتجات الأعلى أداءً لدى التاجر.
HIGH من المحتمَل جذب عدد مشابه من النقرات مقارنةً بالمنتجات الأعلى أداءً لدى التاجر.

PriceCompetitivenessProductView

الحقول المتاحة لطلب البحث في جدول "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)

السعر الحالي للمنتج
benchmarkPrice

object (Price)

أحدث مقياس سعر متوفّر لكتالوج المنتج في البلد الذي تم فيه قياس الأداء
reportCountryCode

string

بلد مقياس السعر ويتم تمثيلها بتنسيق ISO 3166.

مطلوبة في البند SELECT.
id

string

تمثّل هذه السمة معرّف REST للمنتج في شكل channel~languageCode~feedLabel~offerId. ويمكن استخدامها لدمج البيانات في جدول "productView".

مطلوبة في البند SELECT.
offerId

string

معرّف المنتج الذي قدّمه التاجر
title

string

عنوان المنتج.
brand

string

تمثّل هذه السمة العلامة التجارية للمنتج.
categoryL1

string

فئة المنتج (المستوى الأول) في تصنيف المنتجات من Google.
categoryL2

string

فئة المنتج (المستوى الثاني) في تصنيف المنتجات من Google.
categoryL3

string

فئة المنتج (المستوى الثالث) في تصنيف المنتجات من Google.
categoryL4

string

فئة المنتج (المستوى الرابع) في تصنيف المنتج من Google.
categoryL5

string

فئة المنتج (المستوى الخامس) في تصنيف المنتجات من Google.
productTypeL1

string

نوع المنتج (المستوى الأول) في تصنيف المنتج الخاصة بالتاجر.
productTypeL2

string

نوع المنتج (المستوى الثاني) في تصنيف المنتجات الخاصة بالتاجر
productTypeL3

string

نوع المنتج (المستوى الثالث) في تصنيف المنتج الخاصة بالتاجر.
productTypeL4

string

نوع المنتج (المستوى الرابع) في تصنيف المنتج التي حدّدها التاجر.
productTypeL5

string

نوع المنتج (المستوى الخامس) في تصنيف المنتج الخاصة بالتاجر.

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)

السعر الحالي للمنتج
suggestedPrice

object (Price)

تمثّل هذه السمة أحدث سعر مقترَح للمنتج.
effectiveness

enum (Effectiveness)

القيمة المتوقّعة لتطبيق اقتراح السعر، مجمّعة.
id

string

تمثّل هذه السمة معرّف REST للمنتج في شكل channel~languageCode~feedLabel~offerId. ويمكن استخدامها لدمج البيانات في جدول "productView".

مطلوبة في البند SELECT.
offerId

string

معرّف المنتج الذي قدّمه التاجر
title

string

عنوان المنتج.
brand

string

تمثّل هذه السمة العلامة التجارية للمنتج.
categoryL1

string

فئة المنتج (المستوى الأول) في تصنيف المنتجات من Google.
categoryL2

string

فئة المنتج (المستوى الثاني) في تصنيف المنتجات من Google.
categoryL3

string

فئة المنتج (المستوى الثالث) في تصنيف المنتجات من Google.
categoryL4

string

فئة المنتج (المستوى الرابع) في تصنيف المنتج من Google.
categoryL5

string

فئة المنتج (المستوى الخامس) في تصنيف المنتجات من Google.
productTypeL1

string

نوع المنتج (المستوى الأول) في تصنيف المنتج الخاصة بالتاجر.
productTypeL2

string

نوع المنتج (المستوى الثاني) في تصنيف المنتجات الخاصة بالتاجر
productTypeL3

string

نوع المنتج (المستوى الثالث) في تصنيف المنتج الخاصة بالتاجر.
productTypeL4

string

نوع المنتج (المستوى الرابع) في تصنيف المنتج التي حدّدها التاجر.
productTypeL5

string

نوع المنتج (المستوى الخامس) في تصنيف المنتج الخاصة بالتاجر.
predictedImpressionsChangeFraction

number

التغيير المتوقّع في مرات الظهور ككسر بعد تقديم السعر المقترَح مقارنةً بالسعر النشط الحالي على سبيل المثال، تمثّل القيمة 0.05 زيادة متوقعة في مرات الظهور بنسبة% 5.
predictedClicksChangeFraction

number

التغيير المتوقّع في النقرات ككسر بعد تقديم السعر المقترَح مقارنةً بالسعر النشط الحالي على سبيل المثال، يمثّل 0.05 زيادة متوقعة في عدد النقرات بنسبة% 5.
predictedConversionsChangeFraction

number

التغيير المتوقّع في الإحالات الناجحة بمقدار جزء بعد تقديم السعر المقترَح مقارنةً بالسعر النشط الحالي على سبيل المثال، تمثّل القيمة 0.05 زيادة متوقعة في الإحالات الناجحة بنسبة% 5.

الفاعلية

مجموعة بيانات الفعالية المتوقّعة

تشير الفعالية إلى المنتجات التي ستستفيد أكثر من تغيير الأسعار. يأخذ هذا التقييم في الاعتبار تحسّن الأداء المتوقّع من خلال تعديل السعر المخفَّض والفرق بين السعر الحالي والسعر المقترَح. يُتوقَّع أن تحقّق اقتراحات الأسعار ذات الفعالية HIGH الزيادة الأكبر في مستوى الأداء.

عمليات التعداد
EFFECTIVENESS_UNSPECIFIED الفعالية غير معروفة.
LOW الفعالية منخفضة.
MEDIUM الفعالية متوسطة.
HIGH الفعالية عالية.

BestSellersProductClusterView

الحقول المتاحة لطلب البحث في جدول "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)
}
الحقول
reportDate

object (Date)

تاريخ التقرير يمكن أن تكون قيمة هذا الحقل واحدة فقط مما يلي:

  • اليوم الأول من الأسبوع (الاثنين) للتقارير الأسبوعية،
  • اليوم الأول من الشهر للتقارير الشهرية.

مطلوبة في البند SELECT. إذا لم يتم تحديد شرط WHERE على reportDate في طلب البحث، سيتم عرض آخر تقرير أسبوعي أو شهري متاح.
variantGtins[]

string

أرقام GTIN لأمثلة على خيارات مجموعة المنتجات
reportGranularity

enum (ReportGranularityEnum)

دقة التقرير ويمكن إجراء الترتيب على مدار إطار زمني أسبوعي أو شهر.

مطلوبة في البند SELECT. يجب توفير شرط على reportGranularity في البند WHERE.
reportCountryCode

string

البلد الذي يتم احتساب الترتيب فيه. ويتم تمثيلها بتنسيق ISO 3166.

مطلوبة في البند SELECT. يجب توفير شرط على reportCountryCode في البند WHERE.
reportCategoryId

string (int64 format)

تشير هذه السمة إلى معرّف فئة المنتجات من Google لاحتساب ترتيب المنتجات، ويكون هذا المعرّف هو معرّف تصنيف المنتجات من Google.

مطلوبة في البند SELECT. إذا لم يتم تحديد شرط WHERE في reportCategoryId في طلب البحث، سيتم عرض الترتيب لجميع فئات المستوى الأعلى.
title

string

تمثّل هذه السمة عنوان مجموعة المنتجات.
brand

string

العلامة التجارية لمجموعة المنتجات.
categoryL1

string

فئة المنتج (المستوى الأول) من مجموعة المنتجات، ويتم تمثيلها في تصنيف المنتجات من Google.
categoryL2

string

فئة المنتج (المستوى الثاني) من مجموعة المنتجات، ويتم تمثيلها في تصنيف المنتجات من Google.
categoryL3

string

فئة المنتج (المستوى الثالث) من مجموعة المنتجات، ويتم تمثيلها في تصنيف المنتجات من Google.
categoryL4

string

فئة المنتج (المستوى الرابع) من مجموعة المنتجات، ويتم تمثيلها في تصنيف المنتجات من Google.
categoryL5

string

فئة المنتج (المستوى الخامس) من مجموعة المنتجات، ويتم تمثيلها في تصنيف المنتجات من Google.
inventoryStatus

enum (InventoryStatus)

سواء كانت مجموعة المنتجات IN_STOCK في مصدر بيانات المنتجات في بلد واحد على الأقل، أو OUT_OF_STOCK في مصدر بيانات المنتجات في كل البلدان، أو NOT_IN_INVENTORY في مصدر بيانات المنتجات.

ولا يأخذ الحقل في الاعتبار فلتر البلدان في تقرير "الأكثر مبيعًا".
brandInventoryStatus

enum (InventoryStatus)

سواء كان هناك منتج واحد على الأقل من العلامة التجارية IN_STOCK في الوقت الحالي في مصدر بيانات منتجاتك في بلد واحد على الأقل، تكون كل المنتجات OUT_OF_STOCK في مصدر بيانات المنتجات في كل البلدان، أو NOT_IN_INVENTORY.

ولا يأخذ الحقل في الاعتبار فلتر البلدان في تقرير "الأكثر مبيعًا".
rank

string (int64 format)

مدى رواج مجموعة المنتجات على "إعلانات Google" ومساحات العرض المجانية في الفئة والبلد المحدّدَين، وذلك بالاستناد إلى العدد المقدّر للوحدات المباعة
previousRank

string (int64 format)

ترتيب مدى الرواج في الأسبوع أو الشهر السابق
relativeDemand

enum (RelativeDemandEnum)

الطلب المقدَّر مقارنةً بمجموعة المنتجات الأكثر رواجًا في الفئة والبلد نفسيهما
previousRelativeDemand

enum (RelativeDemandEnum)

الطلب المقدَّر مقارنةً بمجموعة المنتجات الأكثر رواجًا في الفئة والبلد نفسيهما في الأسبوع أو الشهر الماضيَين
relativeDemandChange

enum (RelativeDemandChangeTypeEnum)

التغيير في الطلب المقدَّر. سواء كانت ترتفع أو غرقت أو بقيت مسطّحة

ReportGranularityEnum

قيم دقة التقارير

عمليات التعداد
REPORT_GRANULARITY_ENUM_UNSPECIFIED لم يتم تحديده.
WEEKLY يتم احتساب التقرير على مدار إطار زمني أسبوعي.
MONTHLY يتم احتساب التقرير على مدار إطار زمني للشهر.

InventoryStatus

حالة مجموعة المنتجات أو العلامة التجارية في مستودعك.

عمليات التعداد
INVENTORY_STATUS_UNSPECIFIED لم يتم تحديده.
IN_STOCK لديك منتج متوفّر لمجموعة المنتجات أو العلامة التجارية هذه.
OUT_OF_STOCK لديك منتج لمجموعة المنتجات هذه أو العلامة التجارية هذه في المستودع، ولكنه غير متوفّر حاليًا.
NOT_IN_INVENTORY لا يتوفّر لديك منتج لمجموعة المنتجات هذه أو العلامة التجارية هذه.

RelativeDemandEnum

قيم الطلب النسبية.

عمليات التعداد
RELATIVE_DEMAND_ENUM_UNSPECIFIED لم يتم تحديده.
VERY_LOW ويتراوح الطلب بين 0% و 5% من الطلب على مجموعة المنتجات أو العلامة التجارية الأعلى ترتيبًا.
LOW ويتراوح الطلب بين 6% و 10% من الطلب على مجموعة المنتجات أو العلامة التجارية الأعلى ترتيبًا.
MEDIUM ويتراوح الطلب بين 11% و 20% من الطلب على مجموعة المنتجات أو العلامة التجارية الأعلى ترتيبًا.
HIGH يتراوح الطلب بين 21% و 50% من الطلب على مجموعة المنتجات أو العلامة التجارية الأعلى ترتيبًا.
VERY_HIGH يتراوح الطلب بين 51% و 100% من الطلب على مجموعة المنتجات أو العلامة التجارية الأعلى ترتيبًا.

RelativeDemandChangeTypeEnum

قيم أنواع التغييرات في الطلب النسبي

عمليات التعداد
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)
}
الحقول
reportDate

object (Date)

تاريخ التقرير يمكن أن تكون قيمة هذا الحقل واحدة فقط مما يلي:

  • اليوم الأول من الأسبوع (الاثنين) للتقارير الأسبوعية،
  • اليوم الأول من الشهر للتقارير الشهرية.

مطلوبة في البند SELECT. إذا لم يتم تحديد شرط WHERE على reportDate في طلب البحث، سيتم عرض آخر تقرير أسبوعي أو شهري متاح.
reportGranularity

enum (ReportGranularityEnum)

دقة التقرير ويمكن إجراء الترتيب على مدار إطار زمني أسبوعي أو شهر.

مطلوبة في البند SELECT. يجب توفير شرط على reportGranularity في البند WHERE.
reportCountryCode

string

البلد الذي يتم احتساب الترتيب فيه. ويتم تمثيلها بتنسيق ISO 3166.

مطلوبة في البند SELECT. يجب توفير شرط على reportCountryCode في البند WHERE.
reportCategoryId

string (int64 format)

تشير هذه السمة إلى معرّف فئة المنتجات من Google لاحتساب ترتيب المنتجات، ويكون هذا المعرّف هو معرّف تصنيف المنتجات من Google.

مطلوبة في البند SELECT. إذا لم يتم تحديد شرط WHERE في reportCategoryId في طلب البحث، سيتم عرض الترتيب لجميع فئات المستوى الأعلى.
brand

string

اسم العلامة التجارية.
rank

string (int64 format)

مدى رواج العلامة التجارية على "إعلانات Google" ومساحات العرض المجانية في الفئة والبلد المحدّدَين، وذلك بالاستناد إلى العدد المقدّر للوحدات المباعة
previousRank

string (int64 format)

ترتيب مدى الرواج في الأسبوع أو الشهر السابق
relativeDemand

enum (RelativeDemandEnum)

الطلب المقدَّر مقارنةً بالعلامة التجارية الأكثر رواجًا في الفئة والبلد نفسيهما
previousRelativeDemand

enum (RelativeDemandEnum)

الطلب المقدَّر مقارنةً بالعلامة التجارية الأكثر رواجًا في الفئة والبلد نفسيهما في الأسبوع أو الشهر الماضيَين
relativeDemandChange

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

boolean

صحيح إذا كان هذا الصف يحتوي على بيانات لنطاقك.

لا يمكن الفلترة حسب في عبارة "WHERE".
reportCountryCode

string

البلد الذي ظهرت فيه مرّات الظهور

مطلوبة في البند SELECT. يجب توفير شرط على reportCountryCode في البند WHERE.
reportCategoryId

string (int64 format)

معرّف فئة المنتجات من Google لاحتساب التقرير، ويكون هذا المعرّف مطلوبًا في تصنيف المنتجات من Google.

مطلوبة في البند SELECT. يجب توفير شرط على reportCategoryId في البند WHERE.
trafficSource

enum (TrafficSourceEnum)

مصدر الزيارات لمرّات الظهور

مطلوبة في البند SELECT.
rank

string (int64 format)

موضع النطاق في ترتيب الأنشطة التجارية المشابهة للمفاتيح التي تم اختيارها (date، reportCategoryId، reportCountryCode، trafficSource) استنادًا إلى مرات الظهور 1 هو الأعلى.

لا يمكن الفلترة حسب في عبارة "WHERE".
adsOrganicRatio

number

توضّح نسبة ظهور إعلانات Shopping إلى الإعلانات المجانية عدد المرات التي تلقّى فيها النطاق مرات ظهور من إعلانات Shopping مقارنةً بالزيارات الواردة من نتائج البحث المجانية. يتم تقريب الرقم ووضعه ضمن مجموعة.

لا يمكن الفلترة حسب في عبارة "WHERE".
pageOverlapRate

number

معدّل التداخل في الصفحة: يعرض عدد المرات التي تظهر فيها عروض بائعي التجزئة المنافسين مع عروضك على الصفحة نفسها.

لا يمكن الفلترة حسب في عبارة "WHERE".
higherPositionRate

number

معدّل الظهور في موضع أعلى: يعرض عدد المرات التي ظهر فيها عرض أحد المنافسين في موضع أعلى من عرضك في الصفحة.

لا يمكن الفلترة حسب في عبارة "WHERE".
relativeVisibility

number

يعرض مقياس مستوى الظهور النسبي عدد مرّات ظهور عروض منافسيك مقارنةً بعروضك. بمعنى آخر، يشير هذا المقياس إلى عدد مرّات الظهور المعروضة لبائع تجزئة منافس مقسومًا على عدد مرّات الظهور المعروضة خلال نطاق زمني محدّد لفئة منتج وبلد محدّدَين.

لا يمكن الفلترة حسب في عبارة "WHERE".

TrafficSourceEnum

قيم مصادر الزيارات

عمليات التعداد
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".
isYourDomain

boolean

صحيح إذا كان هذا الصف يحتوي على بيانات لنطاقك.

لا يمكن الفلترة حسب في عبارة "WHERE".
reportCountryCode

string

البلد الذي ظهرت فيه مرّات الظهور

مطلوبة في البند SELECT. يجب توفير شرط على reportCountryCode في البند WHERE.
reportCategoryId

string (int64 format)

معرّف فئة المنتجات من Google لاحتساب التقرير، ويكون هذا المعرّف مطلوبًا في تصنيف المنتجات من Google.

مطلوبة في البند SELECT. يجب توفير شرط على reportCategoryId في البند WHERE.
trafficSource

enum (TrafficSourceEnum)

مصدر الزيارات لمرّات الظهور

مطلوبة في البند SELECT.
rank

string (int64 format)

موضع النطاق في أعلى ترتيب للتجّار للمفاتيح المحدّدة (date، وreportCategoryId، وreportCountryCode، وtrafficSource) استنادًا إلى مرّات الظهور 1 هو الأعلى.

لا يمكن الفلترة حسب في عبارة "WHERE".
adsOrganicRatio

number

توضّح نسبة ظهور إعلانات Shopping إلى الإعلانات المجانية عدد المرات التي تلقّى فيها النطاق مرات ظهور من إعلانات Shopping مقارنةً بالزيارات الواردة من نتائج البحث المجانية. يتم تقريب الرقم ووضعه ضمن مجموعة.

لا يمكن الفلترة حسب في عبارة "WHERE".
pageOverlapRate

number

معدّل التداخل في الصفحة: يعرض عدد المرات التي تظهر فيها عروض بائعي التجزئة المنافسين مع عروضك على الصفحة نفسها.

لا يمكن الفلترة حسب في عبارة "WHERE".
higherPositionRate

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

string

البلد الذي ظهرت فيه مرّات الظهور

مطلوبة في البند SELECT. يجب توفير شرط على reportCountryCode في البند WHERE.
reportCategoryId

string (int64 format)

معرّف فئة المنتجات من Google لاحتساب التقرير، ويكون هذا المعرّف مطلوبًا في تصنيف المنتجات من Google.

مطلوبة في البند SELECT. يجب توفير شرط على reportCategoryId في البند WHERE.
trafficSource

enum (TrafficSourceEnum)

مصدر الزيارات لمرّات الظهور

مطلوبة في البند SELECT.
yourDomainVisibilityTrend

number

تغيير في مستوى الرؤية استنادًا إلى مرات الظهور لنطاقك في ما يتعلق ببدء النطاق الزمني المحدّد (أو اليوم الأول بمرات ظهور بخلاف الصفر).

لا يمكن الفلترة حسب في عبارة "WHERE".
categoryBenchmarkVisibilityTrend

number

يشير ذلك إلى التغيير في مستوى الظهور استنادًا إلى مرات الظهور في ما يتعلق ببداية النطاق الزمني المحدّد (أو في اليوم الأول بمرّات ظهور غير صفرية) لمجموعة مجمّعة من التجّار الذين يسجّلون أعلى مستوى ظهور بالقرب من السوق.

لا يمكن الفلترة حسب في عبارة "WHERE".