Package google.shopping.merchant.reviews.v1beta

الفهرس

MerchantReviewsService

خدمة لإدارة مراجعات التجار

DeleteMerchantReview

rpc DeleteMerchantReview(DeleteMerchantReviewRequest) returns (Empty)

حذف مراجعة التاجر

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

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

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

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

rpc GetMerchantReview(GetMerchantReviewRequest) returns (MerchantReview)

تلقّي مراجعة من التاجر

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

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

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

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

rpc InsertMerchantReview(InsertMerchantReviewRequest) returns (MerchantReview)

إدراج مراجعة لحسابك على Merchant Center إذا كانت المراجعة متوفّرة، يتم استبدالها بالنسخة الجديدة.

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

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

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

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

rpc ListMerchantReviews(ListMerchantReviewsRequest) returns (ListMerchantReviewsResponse)

يعرض مراجعات التجار.

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

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

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

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

ProductReviewsService

خدمة لإدارة مراجعات المنتجات

DeleteProductReview

rpc DeleteProductReview(DeleteProductReviewRequest) returns (Empty)

لحذف مراجعة منتج.

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

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

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

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

rpc GetProductReview(GetProductReviewRequest) returns (ProductReview)

الحصول على مراجعة للمنتج

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

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

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

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

rpc InsertProductReview(InsertProductReviewRequest) returns (ProductReview)

لإدراج مراجعة منتج

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

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

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

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

rpc ListProductReviews(ListProductReviewsRequest) returns (ListProductReviewsResponse)

تعرض مراجعات المنتجات.

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

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

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

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

DeleteMerchantReviewRequest

رسالة طلب لطريقة DeleteMerchantReview

الحقول
name

string

مطلوب. معرّف مراجعة التاجر. التنسيق: accounts/{account}/merchantReviews/{merchantReview}

DeleteProductReviewRequest

رسالة طلب لطريقة DeleteProductReview

الحقول
name

string

مطلوب. معرّف مراجعة المنتج. التنسيق: accounts/{account}/productReviews/{productReview}

GetMerchantReviewRequest

رسالة طلب لطريقة GetMerchantReview

الحقول
name

string

مطلوب. معرّف مراجعة التاجر. التنسيق: accounts/{account}/merchantReviews/{merchantReview}

GetProductReviewRequest

رسالة طلب لطريقة GetProductReview

الحقول
name

string

مطلوب. معرّف مراجعة التاجر. التنسيق: accounts/{account}/productReviews/{productReview}

InsertMerchantReviewRequest

رسالة طلب لطريقة InsertMerchantReview

الحقول
parent

string

مطلوب. الحساب الذي سيتم إدراج مراجعة التاجر فيه التنسيق: accounts/{account}
merchant_review

MerchantReview

مطلوب. مراجعة التاجر المطلوب إدراجها
data_source

string

مطلوب. مصدر بيانات تنسيق merchantreview: accounts/{account}/dataSources/{datasource}.

InsertProductReviewRequest

رسالة طلب لطريقة InsertProductReview

الحقول
parent

string

مطلوب. الحساب الذي سيتم إدراج مراجعة المنتج فيه التنسيق: accounts/{account}
product_review

ProductReview

مطلوب. مراجعة المنتج المطلوب إدراجها
data_source

string

مطلوب. التنسيق: accounts/{account}/dataSources/{datasource}

ListMerchantReviewsRequest

رسالة طلب لطريقة ListMerchantsReview

الحقول
parent

string

مطلوب. الحساب الذي تريد عرض مراجعات التجار فيه التنسيق: accounts/{account}
page_size

int32

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

string

اختيارية: رمز مميّز للصفحة، تم تلقّيه من مكالمة ListMerchantReviews سابقة قدِّم هذا المرجع لاسترداد الصفحة اللاحقة.

عند تقسيم الصفحات، يجب أن تتطابق جميع المَعلمات الأخرى المقدَّمة إلى ListMerchantReviews مع الطلب الذي قدّم الرمز المميّز للصفحة.

ListMerchantReviewsResponse

رسالة الردّ على طريقة ListMerchantsReview

الحقول
merchant_reviews[]

MerchantReview

مراجعة التاجر.
next_page_token

string

الرمز المميّز لاسترداد الصفحة التالية من النتائج

ListProductReviewsRequest

رسالة طلب لطريقة ListProductReviews

الحقول
parent

string

مطلوب. الحساب الذي تريد عرض مراجعات المنتجات فيه التنسيق: accounts/{account}
page_size

int32

اختيارية: الحد الأقصى لعدد المنتجات المطلوب عرضها قد تعرض الخدمة عددًا أقل من هذه القيمة.
page_token

string

اختيارية: رمز مميّز للصفحة، تم تلقّيه من مكالمة ListProductReviews سابقة قدِّم هذا المرجع لاسترداد الصفحة اللاحقة.

عند تقسيم الصفحات، يجب أن تتطابق جميع المَعلمات الأخرى المقدَّمة إلى ListProductReviews مع الطلب الذي قدّم الرمز المميّز للصفحة.

ListProductReviewsResponse

رسالة الاستجابة لطريقة ListProductReviews

الحقول
product_reviews[]

ProductReview

مراجعة المنتج
next_page_token

string

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

MerchantReview

مراجعة للتاجر لمزيد من المعلومات، يُرجى الاطّلاع على مقدّمة عن خلاصات مراجعات التجار.

الحقول
name

string

المعرّف اسم مراجعة التاجر. التنسيق: "{merchantreview.name=accounts/{account}/merchantReviews/{merchantReview}}"
merchant_review_id

string

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

MerchantReviewAttributes

اختيارية: قائمة بسمات مراجعات التجار
custom_attributes[]

CustomAttribute

مطلوب. قائمة بالسمات المخصّصة (التي يقدّمها التاجر) ويمكن أيضًا استخدامه لإرسال أي سمة من مواصفات البيانات بصورتها العامة (على سبيل المثال، { "name": "size type", "value": "regular" }). ويُعدّ ذلك مفيدًا لإرسال السمات التي لا تعرضها واجهة برمجة التطبيقات صراحةً، مثل السمات التجريبية. الحدّ الأقصى المسموح به لعدد الأحرف لكلّ سمة مخصّصة هو 10240 (يمثّل مجموع أحرف الاسم والقيمة). يمكن ضبط 2500 سمة مخصّصة كحدّ أقصى لكل منتج، بإجمالي حجم 102.4 كيلوبايت. عند إدراج أسماء السمات المخصّصة، يتم استبدال الشرطة السفلية بمسافة.
data_source

string

النتائج فقط. مصدر البيانات الأساسي لمراجعة التاجر.
merchant_review_status

MerchantReviewStatus

النتائج فقط. حالة مراجعة التاجر، ومشاكل التحقّق من البيانات، أي معلومات عن مراجعة التاجر التي يتم احتسابها بشكل غير متزامن

MerchantReviewAttributes

السمات

الحقول
merchant_id

string

مطلوب. يجب أن يكون فريدًا وثابتًا في جميع الطلبات. بعبارة أخرى، إذا كان طلب اليوم وآخر قبل 90 يومًا يشير إلى التاجر نفسه، يجب أن يكون له المعرّف نفسه.
merchant_display_name

string

اختيارية: الاسم المعروض للتاجر والذي يمكن لشخص عادي قراءته
min_rating

int64

اختيارية: الحد الأدنى لعدد التقييمات الممكنة يجب أن يكون هذا أسوأ تقييم ممكن، ويجب ألا يكون قيمة لعدم التقييم.
max_rating

int64

اختيارية: الحد الأقصى لعدد التقييمات يجب أن تكون قيمة الحد الأقصى للتقييم أكبر من قيمة الحد الأدنى للتقييم.
rating

double

اختيارية: التقييم العام الذي يمنحه المراجع للتاجر
title

string

اختيارية: عنوان المراجعة
content

string

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

string

اختيارية: معرّف دائم وفريد لكاتب المراجعة في نظام الناشر
reviewer_username

string

اختيارية: الاسم المعروض لمؤلف المراجعة.
is_anonymous

bool

اختيارية: اضبط القيمة على true إذا كان يجب إخفاء هوية المُراجع.
collection_method

CollectionMethod

اختيارية: الطريقة المستخدَمة لجمع المراجعة
review_time

Timestamp

مطلوب. الطابع الزمني الذي يشير إلى وقت كتابة المراجعة
review_language

string

مطلوب. لغة المراجعة المحدّدة حسب رمز اللغة BCP-47
review_country

string

اختيارية: البلد الذي قدّم فيه المراجع الطلب، وفقًا لرمز البلد وفقًا لمعيار ISO 3166-1 Alpha-2

CollectionMethod

الطريقة المستخدَمة لجمع المراجعة

عمليات التعداد
COLLECTION_METHOD_UNSPECIFIED طريقة جمع البيانات غير محدّدة.
MERCHANT_UNSOLICITED لم يكن المستخدم يردّ على طلب معيّن عند إرسال المراجعة.
POINT_OF_SALE أرسل المستخدم المراجعة استجابةً لطلب عندما قدّم طلبًا.
AFTER_FULFILLMENT أرسل المستخدم المراجعة استجابةً لطلب بعد تنفيذ طلبه.

MerchantReviewStatus

حالة مراجعة التاجر، ومشاكل التحقّق من البيانات، أي معلومات عن مراجعة التاجر التي يتم احتسابها بشكل غير متزامن

الحقول
destination_statuses[]

MerchantReviewDestinationStatus

النتائج فقط. الوجهات المقصودة لمراجعة التاجر
item_level_issues[]

MerchantReviewItemLevelIssue

النتائج فقط. قائمة بجميع المشاكل المرتبطة بمراجعة التاجر
create_time

Timestamp

النتائج فقط. تاريخ إنشاء العنصر، بتنسيق ISO 8601
last_update_time

Timestamp

النتائج فقط. تاريخ آخر تعديل على العنصر، بتنسيق ISO 8601

MerchantReviewDestinationStatus

حالة الوجهة لحالة مراجعة التاجر.

الحقول
reporting_context

ReportingContextEnum

النتائج فقط. اسم سياق إعداد التقارير

MerchantReviewItemLevelIssue

سمة ItemLevelIssue لحالة مراجعة التاجر.

الحقول
code

string

النتائج فقط. رمز الخطأ للمشكلة.
severity

Severity

النتائج فقط. كيفية تأثير هذه المشكلة في عرض مراجعة التاجر
resolution

string

النتائج فقط. ما إذا كان بإمكان التاجر حلّ المشكلة
attribute

string

النتائج فقط. اسم السمة، إذا كانت المشكلة ناتجة عن سمة واحدة
reporting_context

ReportingContextEnum

النتائج فقط. سياق إعداد التقارير الذي تنطبق عليه المشكلة.
description

string

النتائج فقط. وصف موجز للمشكلة باللغة الإنجليزية
detail

string

النتائج فقط. وصف تفصيلي للمشكلة باللغة الإنجليزية
documentation

string

النتائج فقط. عنوان URL لصفحة ويب للمساعدة في حلّ هذه المشكلة

درجة الخطورة

مدى تأثُّر عرض مراجعة التاجر بالمشكلة

عمليات التعداد
SEVERITY_UNSPECIFIED غير محدّد
NOT_IMPACTED هذه المشكلة هي تحذير ولا تؤثّر بشكل مباشر في مراجعة التاجر.
DISAPPROVED تؤدي المشكلة إلى رفض مراجعة التاجر.

ProductReview

مراجعة لمنتج لمزيد من المعلومات، يمكنك الاطّلاع على لمحة عن خلاصات مراجعات المنتجات.

الحقول
name

string

المعرّف اسم مراجعة المنتج التنسيق: "{productreview.name=accounts/{account}/productReviews/{productReview}}"
product_review_id

string

مطلوب. المعرّف الدائم والفريد لمراجعة المنتج في نظام الناشر
attributes

ProductReviewAttributes

اختيارية: قائمة بسمات مراجعات المنتجات
custom_attributes[]

CustomAttribute

اختيارية: قائمة بالسمات المخصّصة (التي يقدّمها التاجر)
data_source

string

النتائج فقط. مصدر البيانات الأساسي لمراجعة المنتج.
product_review_status

ProductReviewStatus

النتائج فقط. حالة مراجعة المنتج، ومشاكل التحقّق من البيانات، أي معلومات عن مراجعة منتج يتم احتسابها بشكل غير متزامن

ProductReviewAttributes

السمات

الحقول
review_time

Timestamp

مطلوب. الطابع الزمني الذي يشير إلى وقت كتابة المراجعة
pros[]

string

اختيارية: يحتوي على المزايا استنادًا إلى رأي المراجع. تجنَّب استخدام النصوص النموذجية، مثل "pro:"، ما لم يكن قد كتبها المراجع.
cons[]

string

اختيارية: تحتوي على السلبيات استنادًا إلى رأي المراجع. تجنَّب استخدام النصوص النموذجية، مثل "سلبيات:" ما لم يكتبها المُراجع.
product_names[]

string

اختيارية: اسم وصفي لمنتج
asins[]

string

اختيارية: يحتوي على أرقام ASIN (أرقام التعريف العادية في Amazon) المرتبطة بمنتج معيّن.
gtins[]

string

اختيارية: تحتوي على أرقام GTIN (الأرقام التجارية العالمية للسلع) المرتبطة بمنتج. يمكن استخدام الأنواع الفرعية من أرقام GTIN (مثل UPC وEAN وISBN وJAN).
mpns[]

string

اختيارية: يحتوي على أرقام القطع المحدّدة من الشركة المصنّعة المرتبطة بمنتج.
skus[]

string

اختيارية: يحتوي على رموز التخزين التعريفية المرتبطة بمنتج. وغالبًا ما يتطابق مع معرّف عرض المنتج في خلاصة المنتجات.
brands[]

string

اختيارية: يحتوي على أسماء علامات تجارية مرتبطة بمنتج.
collection_method

CollectionMethod

اختيارية: الطريقة المستخدَمة لجمع المراجعة
transaction_id

string

اختيارية: معرّف دائم وفريد للمعاملة المرتبطة بالمراجعة في نظام الناشر يمكن استخدام هذا المعرّف للإشارة إلى أنّ هناك مراجعات متعددة مرتبطة بالمعاملة نفسها.
aggregator_name

string

اختيارية: اسم مجمّع مراجعات المنتجات

يمكن للناشر استخدام خدمة تجميع المراجعات لإدارة المراجعات وتقديم الخلاصات. يشير هذا العنصر إلى استخدام مجمّع ويحتوي على معلومات عنه.
subclient_name

string

اختيارية: اسم العميل الفرعي لمراجعات المنتجات.

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

string

اختيارية: اسم ناشر مراجعات المنتجات

معلومات عن الناشر، الذي قد يكون بائع تجزئة أو شركة تصنيع أو شركة خدمات مراجعات أو أي جهة تنشر مراجعات المنتجات
publisher_favicon

string

اختيارية: رابط يؤدي إلى رمز الشركة المميّز للناشر يجب أن تكون أبعاد الصورة بحجم رمز الشارة: 16 × 16 بكسل. يجب أن يكون تنسيق الصورة GIF أو JPG أو PNG.
reviewer_id

string

اختيارية: تمثّل هذه السمة مؤلف مراجعة المنتج.

معرّف دائم وفريد لكاتب المراجعة في نظام الناشر
reviewer_is_anonymous

bool

اختيارية: اضبط القيمة على true إذا كان يجب إخفاء هوية المُراجع.
reviewer_username

string

اختيارية: اسم مقدّم مراجعة المنتج
review_language

string

اختيارية: لغة المراجعة المحدّدة حسب رمز اللغة BCP-47
review_country

string

اختيارية: بلد المراجعة المحدّد حسب رمز البلد وفقًا لمعيار ISO 3166-1 Alpha-2
title

string

اختيارية: عنوان المراجعة
content

string

مطلوب. محتوى المراجعة
min_rating

int64

اختيارية: يحتوي على التقييمات المرتبطة بالمراجعة. الحد الأدنى لعدد التقييمات الممكنة يجب أن يكون هذا أسوأ تقييم ممكن، ويجب ألا يكون قيمة لعدم التقييم.
max_rating

int64

اختيارية: الحد الأقصى لعدد التقييمات يجب أن تكون قيمة الحد الأقصى للتقييم أكبر من قيمة السمة min.
rating

double

اختيارية: التقييم العام للمنتج من قِبل المراجع
is_spam

bool

اختيارية: يشير إلى ما إذا تم وضع علامة على المراجعة بأنّها غير مرغوب فيها في نظام الناشر.

CollectionMethod

الطريقة المستخدَمة لجمع المراجعة

عمليات التعداد
COLLECTION_METHOD_UNSPECIFIED طريقة جمع البيانات غير محدّدة.
UNSOLICITED لم يكن المستخدم يردّ على طلب معيّن عند إرسال المراجعة.
POST_FULFILLMENT أرسل المستخدم المراجعة استجابةً لطلب بعد تنفيذ طلبه.

النوع

نوع معرّف الموارد المنتظم (URI) للمراجعة

عمليات التعداد
TYPE_UNSPECIFIED النوع غير محدّد.
SINGLETON لا تحتوي صفحة المراجعة إلا على هذه المراجعة الواحدة.
GROUP تحتوي صفحة المراجعات على مجموعة من المراجعات، بما في ذلك هذه المراجعة.

ProductReviewStatus

حالة مراجعة المنتج

الحقول
destination_statuses[]

ProductReviewDestinationStatus

النتائج فقط. الوجهات المقصودة لمراجعة المنتج.
item_level_issues[]

ProductReviewItemLevelIssue

النتائج فقط. قائمة بكل المشاكل المرتبطة بمراجعة المنتج
create_time

Timestamp

النتائج فقط. تاريخ إنشاء العنصر، بتنسيق ISO 8601
last_update_time

Timestamp

النتائج فقط. تاريخ آخر تعديل على العنصر، بتنسيق ISO 8601

ProductReviewDestinationStatus

حالة الوجهة لحالة مراجعة المنتج.

الحقول
reporting_context

ReportingContextEnum

النتائج فقط. اسم سياق إعداد التقارير

ProductReviewItemLevelIssue

ItemLevelIssue لحالة مراجعة المنتج

الحقول
code

string

النتائج فقط. رمز الخطأ للمشكلة.
severity

Severity

النتائج فقط. كيفية تأثير هذه المشكلة في عرض مراجعة المنتج
resolution

string

النتائج فقط. ما إذا كان بإمكان التاجر حلّ المشكلة
attribute

string

النتائج فقط. اسم السمة، إذا كانت المشكلة ناتجة عن سمة واحدة
reporting_context

ReportingContextEnum

النتائج فقط. سياق إعداد التقارير الذي تنطبق عليه المشكلة.
description

string

النتائج فقط. وصف موجز للمشكلة باللغة الإنجليزية
detail

string

النتائج فقط. وصف تفصيلي للمشكلة باللغة الإنجليزية
documentation

string

النتائج فقط. عنوان URL لصفحة ويب للمساعدة في حلّ هذه المشكلة

درجة الخطورة

مدى تأثُّر عرض مراجعة المنتج بالمشكلة

عمليات التعداد
SEVERITY_UNSPECIFIED غير محدّد
NOT_IMPACTED هذه المشكلة هي تحذير ولا تؤثّر مباشرةً في مراجعة المنتج.
DISAPPROVED تؤدي المشكلة إلى رفض مراجعة المنتج.