REST Resource: accounts.productReviews

المرجع: ProductReview

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

تمثيل JSON 
{
  "name": string,
  "productReviewId": string,
  "attributes": {
    object (ProductReviewAttributes)
  },
  "customAttributes": [
    {
      object (CustomAttribute)
    }
  ],
  "dataSource": string,
  "productReviewStatus": {
    object (ProductReviewStatus)
  }
}
الحقول
name

string

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

string

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

object (ProductReviewAttributes)

اختياريّ. تمثّل هذه السمة قائمة بسمات مراجعات المنتجات.
customAttributes[]

object (CustomAttribute)

اختياريّ. قائمة بالسمات المخصّصة (المقدّمة من التاجر).
dataSource

string

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

object (ProductReviewStatus)

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

ProductReviewAttributes

السمات

تمثيل JSON 
{
  "reviewTime": string,
  "pros": [
    string
  ],
  "cons": [
    string
  ],
  "reviewLink": {
    object (ReviewLink)
  },
  "reviewerImageLinks": [
    string
  ],
  "productNames": [
    string
  ],
  "productLinks": [
    string
  ],
  "asins": [
    string
  ],
  "gtins": [
    string
  ],
  "mpns": [
    string
  ],
  "skus": [
    string
  ],
  "brands": [
    string
  ],
  "collectionMethod": enum (CollectionMethod),
  "transactionId": string,
  "aggregatorName": string,
  "subclientName": string,
  "publisherName": string,
  "publisherFavicon": string,
  "reviewerId": string,
  "reviewerIsAnonymous": boolean,
  "reviewerUsername": string,
  "reviewLanguage": string,
  "reviewCountry": string,
  "title": string,
  "content": string,
  "minRating": string,
  "maxRating": string,
  "rating": number,
  "isSpam": boolean
}
الحقول
reviewTime

string (Timestamp format)

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

string

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

string

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

string

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

string

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

string

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

string

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

string

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

string

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

enum (CollectionMethod)

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

string

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

string

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

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

string

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

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

string

اختياريّ. اسم ناشر مراجعات المنتجات.

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

string

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

string

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

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

boolean

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

string

اختياريّ. اسم مقدّم مراجعة المنتج
reviewLanguage

string

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

string

اختياريّ. تمثّل هذه السمة بلد المراجعة المحدّد من خلال رمز البلد بصيغة ISO 3166-1 Alpha-2.
title

string

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

string

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

string (int64 format)

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

string (int64 format)

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

number

اختياريّ. التقييم العام للمنتج من قِبل المراجع
isSpam

boolean

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

النوع

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

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

CollectionMethod

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

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

ProductReviewStatus

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

تمثيل JSON 
{
  "destinationStatuses": [
    {
      object (ProductReviewDestinationStatus)
    }
  ],
  "itemLevelIssues": [
    {
      object (ProductReviewItemLevelIssue)
    }
  ],
  "createTime": string,
  "lastUpdateTime": string
}
الحقول
destinationStatuses[]

object (ProductReviewDestinationStatus)

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

object (ProductReviewItemLevelIssue)

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

string (Timestamp format)

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

string (Timestamp format)

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

ProductReviewDestinationStatus

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

تمثيل JSON 
{
  "reportingContext": enum (ReportingContextEnum)
}
الحقول
reportingContext

enum (ReportingContextEnum)

النتائج فقط. اسم سياق الإبلاغ

ProductReviewItemLevelIssue

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

تمثيل JSON 
{
  "code": string,
  "severity": enum (Severity),
  "resolution": string,
  "attribute": string,
  "reportingContext": enum (ReportingContextEnum),
  "description": string,
  "detail": string,
  "documentation": string
}
الحقول
code

string

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

enum (Severity)

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

string

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

string

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

enum (ReportingContextEnum)

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

string

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

string

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

string

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

درجة الخطورة

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

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

الطُرق

delete

 يؤدي هذا الإجراء إلى حذف مراجعة منتج.

get

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

insert

 يؤدي هذا الخيار إلى إدراج مراجعة منتج.

list

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