Package google.shopping.merchant.reports.v1beta

الفهرس

ReportService

خدمة لعرض التقارير والإحصاءات حول منتجاتك وأدائها وبيئتها التنافسية على Google

بحث

rpc Search(SearchRequest) returns (SearchResponse)

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

نطاقات التفويض

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

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

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

BestSellersBrandView

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

تقرير الأكثر مبيعًا مع أبرز العلامات التجارية

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

الحقول
report_date

Date

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

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

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

ReportGranularityEnum

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

مطلوبة في البند SELECT. يجب تحديد الشرط في report_granularity في البند WHERE.
report_country_code

string

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

مطلوبة في البند SELECT. يجب تحديد الشرط في report_country_code في البند WHERE.
report_category_id

int64

معرّف فئة المنتجات من Google لاحتساب الترتيب، ويظهر في تصنيف المنتج من Google.

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

string

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

int64

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

int64

ترتيب الرواج في الأسبوع أو الشهر السابق
relative_demand

RelativeDemandEnum

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

RelativeDemandEnum

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

RelativeDemandChangeTypeEnum

يشير ذلك إلى التغيير في الطلب المقدَّر. ما إذا كان الارتفاع سقفًا أو غرقًا أو ظل مستويًا.

BestSellersProductClusterView

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

تقرير الأكثر مبيعًا الذي يتضمن أهم مجموعات المنتجات. مجموعة المنتجات هي مجموعة من العروض والخيارات المختلفة التي تمثّل المنتج نفسه، مثل Google Pixel 7.

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

الحقول
report_date

Date

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

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

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

string

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

ReportGranularityEnum

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

مطلوبة في البند SELECT. يجب تحديد الشرط في report_granularity في البند WHERE.
report_country_code

string

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

مطلوبة في البند SELECT. يجب تحديد الشرط في report_country_code في البند WHERE.
report_category_id

int64

معرّف فئة المنتجات من Google لاحتساب الترتيب، ويظهر في تصنيف المنتج من Google.

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

string

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

string

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

string

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

string

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

string

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

string

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

string

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

InventoryStatus

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

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

InventoryStatus

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

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

int64

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

int64

ترتيب الرواج في الأسبوع أو الشهر السابق
relative_demand

RelativeDemandEnum

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

RelativeDemandEnum

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

RelativeDemandChangeTypeEnum

يشير ذلك إلى التغيير في الطلب المقدَّر. ما إذا كان الارتفاع سقفًا أو غرقًا أو ظل مستويًا.

InventoryStatus

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

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

CompetitiveVisibilityBenchmarkView

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

تقرير مستوى الظهور التنافسي الذي يتضمّن مقياس أداء الفئة

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

الحقول
date

Date

تاريخ هذا الصف.

مطلوبة في البند SELECT. يجب إدراج شرط في date في البند WHERE.
report_country_code

string

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

مطلوبة في البند SELECT. يجب إدراج شرط في report_country_code في البند WHERE.
report_category_id

int64

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

مطلوبة في البند SELECT. يجب إدراج شرط في report_category_id في البند WHERE.
traffic_source

TrafficSourceEnum

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

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

double

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

لا يمكن التصفية في عبارة "WHERE".
category_benchmark_visibility_trend

double

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

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

CompetitiveVisibilityCompetitorView

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

تقرير مستوى الظهور التنافسي مع الأنشطة التجارية التي تحقّق منتجاتها مستوى ظهور مشابه

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

الحقول
date

Date

تاريخ هذا الصف.

يجب إدراج شرط في date في البند WHERE.
domain

string

نطاق المنافس أو نطاقك، إذا كانت "is_your_domain" صحيحة.

مطلوبة في البند SELECT. لا يمكن التصفية في عبارة "WHERE".
is_your_domain

bool

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

لا يمكن التصفية في عبارة "WHERE".
report_country_code

string

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

مطلوبة في البند SELECT. يجب إدراج شرط في report_country_code في البند WHERE.
report_category_id

int64

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

مطلوبة في البند SELECT. يجب إدراج شرط في report_category_id في البند WHERE.
traffic_source

TrafficSourceEnum

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

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

int64

ترتيب النطاق في الأنشطة التجارية المشابهة للمفاتيح المحدَّدة (date وreport_category_id وreport_country_code وtraffic_source) استنادًا إلى مرّات الظهور الرقم 1 هو الأعلى.

لا يمكن التصفية في عبارة "WHERE".
ads_organic_ratio

double

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

لا يمكن التصفية في عبارة "WHERE".
page_overlap_rate

double

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

لا يمكن التصفية في عبارة "WHERE".
higher_position_rate

double

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

لا يمكن التصفية في عبارة "WHERE".
relative_visibility

double

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

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

CompetitiveVisibilityTopMerchantView

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

تقرير مستوى الظهور التنافسي الذي يضم النشاط التجاري الذي يحقّق أعلى مستوى ظهور.

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

الحقول
date

Date

تاريخ هذا الصف.

لا يمكن اختياره في البند SELECT. يجب إدراج شرط في date في البند WHERE.
domain

string

نطاق المنافس أو نطاقك، إذا كانت "is_your_domain" صحيحة.

مطلوبة في البند SELECT. لا يمكن التصفية في عبارة "WHERE".
is_your_domain

bool

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

لا يمكن التصفية في عبارة "WHERE".
report_country_code

string

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

مطلوبة في البند SELECT. يجب إدراج شرط في report_country_code في البند WHERE.
report_category_id

int64

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

مطلوبة في البند SELECT. يجب إدراج شرط في report_category_id في البند WHERE.
traffic_source

TrafficSourceEnum

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

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

int64

ترتيب النطاق بين أبرز التجّار للمفاتيح المحدّدة (date وreport_category_id وreport_country_code وtraffic_source) استنادًا إلى مرّات الظهور الرقم 1 هو الأعلى.

لا يمكن التصفية في عبارة "WHERE".
ads_organic_ratio

double

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

لا يمكن التصفية في عبارة "WHERE".
page_overlap_rate

double

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

لا يمكن التصفية في عبارة "WHERE".
higher_position_rate

double

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

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

MarketingMethod

لا يشتمل هذا النوع على أي حقول.

طريقة التسويق المستخدَمة للترويج لمنتجاتك على Google (النتائج المجانية في مقابل الإعلانات)

MarketingMethodEnum

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

عمليات التعداد
MARKETING_METHOD_ENUM_UNSPECIFIED عدم تحديد صيغة مخاطبة
ORGANIC التسويق المجاني:
ADS التسويق المستند إلى الإعلانات:

NonProductPerformanceView

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

بيانات الأداء حول الصور وروابط المتاجر على الإنترنت التي تؤدي إلى صفحات غير متعلقة بالمنتجات ويشمل ذلك مقاييس الأداء (مثل clicks) والسمات التي يتم تقسيم مقاييس الأداء وفقًا لها (مثل date).

لا يمكن اختيار حقول الشرائح في طلبات البحث بدون اختيار حقل مقياس واحد على الأقل أيضًا.

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

الحقول
date

Date

التاريخ حسب المنطقة الزمنية للتاجر الذي تنطبق عليه المقاييس القسم

يجب تحديد الشرط في date في البند WHERE.
week

Date

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

int64

عدد النقرات على الصور وروابط المتاجر على الإنترنت التي تؤدي إلى صفحات غير متعلقة بالمنتجات المقياس.
impressions

int64

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

double

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

PriceCompetitivenessProductView

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

مكانة السعر في المنافسة.

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

الحقول
price

Price

السعر الحالي للمنتج.
benchmark_price

Price

أحدث هامش سعر لكتالوج المنتج في البلد المعياري
report_country_code

string

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

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

string

معرّف REST للمنتج بتنسيق channel~languageCode~feedLabel~offerId. يمكن استخدامها لدمج البيانات مع الجدول "product_view".

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

string

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

string

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

string

العلامة التجارية للمنتج
category_l1

string

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

string

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

string

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

string

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

string

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

string

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

string

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

string

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

string

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

string

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

PriceInsightsProductView

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

تقرير معلومات مفصّلة عن الأسعار

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

الحقول
price

Price

السعر الحالي للمنتج.
suggested_price

Price

أحدث سعر مقترَح للمنتج
effectiveness

Effectiveness

الفعالية المتوقّعة لتطبيق السعر المقترَح على شكل حزمة.
id

string

معرّف REST للمنتج بتنسيق channel~languageCode~feedLabel~offerId. يمكن استخدامها لدمج البيانات مع الجدول "product_view".

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

string

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

string

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

string

العلامة التجارية للمنتج
category_l1

string

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

string

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

string

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

string

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

string

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

string

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

string

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

string

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

string

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

string

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

double

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

double

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

double

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

الفاعلية

حزمة الفعالية المتوقّعة

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

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

ProductPerformanceView

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

بيانات أداء المنتج لحسابك، بما في ذلك مقاييس الأداء (مثل clicks) والأبعاد التي يتم تقسيم مقاييس الأداء وفقًا لها (مثل offer_id). تعكس قيم أبعاد المنتج، مثل offer_id، حالة المنتج في وقت الظهور.

لا يمكن اختيار حقول الشرائح في طلبات البحث بدون اختيار حقل مقياس واحد على الأقل أيضًا.

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

الحقول
date

Date

التاريخ حسب المنطقة الزمنية للتاجر الذي تنطبق عليه المقاييس القسم

يجب تحديد الشرط في date في البند WHERE.
week

Date

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

Price

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

لا يتوفّر هذا الخيار إلا لمصدر الزيارات "FREE".
marketing_method

MarketingMethodEnum

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

string

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

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

string

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

string

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

string

العلامة التجارية للمنتج القسم
category_l1

string

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

string

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

string

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

string

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

string

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

string

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

string

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

string

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

string

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

string

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

string

تصنيف مخصّص 0 لتجميع المنتجات مخصّص. القسم
custom_label1

string

تصنيف مخصّص 1 لتجميع مخصّص من المنتجات. القسم
custom_label2

string

تصنيف مخصّص 2 لتجميع مخصّص من المنتجات. القسم
custom_label3

string

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

string

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

int64

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

int64

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

double

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

double

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

لا يتوفّر هذا الخيار إلا لمصدر الزيارات "FREE".
conversion_rate

double

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

لا يتوفّر هذا الخيار إلا لمصدر الزيارات "FREE".

ProductView

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

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

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

الحقول
price

Price

سعر المنتج. يجب الالغاء إذا كانت المعلومات المتعلقة بسعر المنتج غير متوفرة.
gtin[]

string

قائمة بالأرقام التجارية العالمية للسلعة (أرقام GTIN) للمنتج
creation_time

Timestamp

الوقت الذي أنشأ فيه التاجر المنتج بالثواني في الطابع الزمني
expiration_date

Date

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

ItemIssue

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

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

لا يمكن استخدام سوى السمات المحدّدة في هذا الحقل (مثل item_issues.severity.aggregated_severity) لفلترة النتائج.
click_potential

ClickPotential

إمكانات الأداء المقدَّرة مقارنةً بمنتجات التاجر الأعلى أداءً
id

string

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

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

ChannelEnum

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

string

تمثّل هذه السمة رمز لغة المنتج بتنسيق BCP 47.
feed_label

string

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

string

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

string

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

string

العلامة التجارية للمنتج
category_l1

string

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

string

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

string

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

string

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

string

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

string

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

string

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

string

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

string

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

string

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

string

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

string

مدى توفّر المنتج:
shipping_label

string

تصنيف الحزمة الذي تمت تسويته والمُحدّد في مصدر البيانات
item_group_id

string

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

AggregatedReportingContextStatus

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

int64

ترتيب المنتج استنادًا إلى فرص النقر عليه. يحقّق المنتج الذي يتضمّن click_potential_rank 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 المنتج مؤهّل لكل سياقات إعداد التقارير.

ClickPotential

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

عمليات التعداد
CLICK_POTENTIAL_UNSPECIFIED تأثير النقرات المتوقعة غير معروف.
LOW إمكانية حصول المنتج على عدد منخفض من النقرات مقارنةً بالمنتجات الأعلى أداءً لدى التاجر
MEDIUM إمكانية حصول المنتج على عدد معتدل من النقرات مقارنةً بالمنتجات الأعلى أداءً للتاجر
HIGH إمكانية حصول المنتج على عدد مشابه من النقرات مقارنةً بمنتجات التاجر الأعلى أداءً

ItemIssue

مشكلة في السلعة مرتبطة بالمنتج

الحقول
type

ItemIssueType

نوع المشكلة في العنصر
severity

ItemIssueSeverity

درجة خطورة المشكلة في السلعة
resolution

ItemIssueResolution

حلّ مشكلة العنصر.

ItemIssueResolution

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

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

ItemIssueSeverity

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

الحقول
severity_per_reporting_context[]

IssueSeverityPerReportingContext

درجة خطورة المشكلة وفقًا لسياق الإبلاغ
aggregated_severity

AggregatedIssueSeverity

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

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

AggregatedIssueSeverity

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

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

IssueSeverityPerReportingContext

درجة خطورة المشكلة وفقًا لسياق الإبلاغ

الحقول
disapproved_countries[]

string

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

string

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

ReportingContextEnum

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

ItemIssueType

نوع المشكلة

الحقول
code

string

رمز خطأ للمشكلة، يعادل code في مشاكل المنتجات.
canonical_attribute

string

اسم السمة الأساسي للمشاكل المتعلّقة بسمة معيّنة.

RelativeDemand

لا يشتمل هذا النوع على أي حقول.

الطلب النسبي على مجموعة منتجات أو علامة تجارية في تقرير "الأكثر مبيعًا".

RelativeDemandEnum

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

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

RelativeDemandChangeType

لا يشتمل هذا النوع على أي حقول.

الطلب النسبي على مجموعة منتجات أو علامة تجارية في تقرير "الأكثر مبيعًا" مقارنةً بالفترة الزمنية السابقة.

RelativeDemandChangeTypeEnum

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

عمليات التعداد
RELATIVE_DEMAND_CHANGE_TYPE_ENUM_UNSPECIFIED عدم تحديد صيغة مخاطبة
SINKER الطلب النسبي أقل من الفترة الزمنية السابقة.
FLAT الطلب النسبي يساوي الفترة الزمنية السابقة.
RISER الطلب النسبي أعلى من الفترة الزمنية السابقة.

ReportGranularity

لا يشتمل هذا النوع على أي حقول.

مدى دقة تقرير "الأكثر مبيعًا". يتم احتساب تقارير "الأكثر مبيعًا" على مدار أسبوع وإطار زمني شهري.

ReportGranularityEnum

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

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

ReportRow

تم عرض صف النتيجة من طلب البحث.

لا يتم ملء سوى الرسالة المقابلة للجدول الذي تم الاستعلام عنه، في الاستجابة. ضمن الرسالة التي تمت تعبئتها، لا تتم تعبئة سوى الحقول المطلوبة صراحةً في طلب البحث.

الحقول
product_performance_view

ProductPerformanceView

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

NonProductPerformanceView

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

ProductView

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

PriceCompetitivenessProductView

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

PriceInsightsProductView

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

BestSellersProductClusterView

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

BestSellersBrandView

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

CompetitiveVisibilityCompetitorView

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

CompetitiveVisibilityTopMerchantView

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

CompetitiveVisibilityBenchmarkView

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

SearchRequest

طلب رسالة لطريقة ReportService.Search

الحقول
parent

string

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

string

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

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

int32

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

string

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

SearchResponse

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

الحقول
results[]

ReportRow

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

string

الرمز المميّز الذي يمكن إرساله على أنّه page_token لاسترداد الصفحة التالية وفي حال إسقاطها، لن تكون هناك صفحات لاحقة.

TrafficSource

لا يشتمل هذا النوع على أي حقول.

مصدر الزيارات لمرّات الظهور في تقرير "مستوى الظهور التنافسي".

TrafficSourceEnum

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

عمليات التعداد
TRAFFIC_SOURCE_ENUM_UNSPECIFIED عدم تحديد صيغة مخاطبة
ORGANIC الزيارات الواردة من نتائج البحث المجانية
ADS الزيارات الواردة من الإعلانات
ALL الزيارات الواردة من نتائج البحث المجانية ومن الإعلانات