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

BestSellersBrandView

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

تقرير الأكثر مبيعًا الذي يعرض أهم العلامات التجارية

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

الحقول
report_date

Date

تاريخ التقرير لا يمكن أن تكون قيمة هذا الحقل سوى إحدى القيم التالية:

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

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

report_granularity

ReportGranularityEnum

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

مطلوب في عبارة SELECT. يجب إدخال شرط في report_granularity في العبارة WHERE.

report_country_code

string

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

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

report_category_id

int64

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

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

brand

string

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

rank

int64

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

previous_rank

int64

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

relative_demand

RelativeDemandEnum

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

previous_relative_demand

RelativeDemandEnum

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

relative_demand_change

RelativeDemandChangeTypeEnum

تغيير في الطلب المقدَّر ما إذا كان قد ارتفع أو انخفض أو ظل ثابتًا

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 مقارنةً بالزيارات الواردة من نتائج البحث المجانية. ويتم تقريب الرقم وتجميعه.

لا يمكن فلترة البيانات حسبها في عبارة 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 مقارنةً بالزيارات الواردة من نتائج البحث المجانية. ويتم تقريب الرقم وتجميعه.

لا يمكن فلترة البيانات استنادًا إليها في عبارة 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

المنتجات المتوفّرة في المستودع الحالي المنتجات الواردة في هذا الجدول هي نفسها الواردة في المنتجات الفرعية لواجهة برمجة التطبيقات، ولكن لا تتوفّر بعض سمات المنتجات من المنتجات الفرعية لواجهة برمجة التطبيقات للبحث عنها في هذا الجدول. على عكس واجهة برمجة التطبيقات الفرعية Products، يسمح هذا الجدول بفلترة قائمة المنتجات المعروضة حسب سمات المنتجات. لاسترداد منتج واحد حسب 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

مطلوب. رقم تعريف الحساب الذي يجري المكالمة يجب أن يكون حسابًا مستقلاً أو حسابًا فرعيًا لحساب متعدّد العملاء. التنسيق: accounts/{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 الزيارات الواردة من نتائج البحث المجانية والزيارات الواردة من الإعلانات