Method: publishers.items.fetchReviews

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

طلب HTTP

GET https://chromewebstore.googleapis.com/v2/{name=publishers/*/items/*}:fetchReviews

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

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

المعلمات
name

string

الحقل مطلوب. اسم مورد السلعة التي يتم جلب مراجعاتها التنسيق: publishers/{publisher_id}/items/{itemId}

مَعلمات طلب البحث

المعلمات
pageSize

integer

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

string

اختيارية: رمز مميّز للصفحة، يتم تلقّيه من طلب items.fetchReviews سابق. يجب تقديم هذه القيمة لاسترداد الصفحة التالية.

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

string

اختيارية: فلتر لتطبيقه على المراجعات يُسمح فقط بمقارنة التقييمات المتساوية، مثل rating = 5.
orderBy

string

اختيارية: قائمة اختيارية من الحقول المفصولة بفواصل لترتيب النتائج حسبها نظام الترتيب التلقائي هو تصاعدي (asc). الحقول المتوافقة هي: - rating: الترتيبات المتوافقة هي asc (تلقائي) وdesc. ‫- createTime: لا يتوفّر سوى desc (الأحدث أولاً)، ويجب تحديد desc بشكل صريح لأنّ القيمة التلقائية هي asc. مثال: rating desc أو createTime desc أو rating desc, createTime desc.

نص الطلب

يجب أن يكون نص الطلب فارغًا.

نص الاستجابة

رسالة الردّ على items.fetchReviews

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

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

object (Review)

قائمة المراجعات
nextPageToken

string

رمز مميّز يمكن إرساله كـ pageToken لاسترداد الصفحة التالية. إذا تم حذف هذا الحقل، لن تكون هناك صفحات لاحقة.

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

يتطلب أحد نطاقات OAuth التالية:

  • https://www.googleapis.com/auth/chromewebstore
  • https://www.googleapis.com/auth/chromewebstore.readonly

مراجعة

مراجعة كتبها مستخدم لتقييم منتج في "سوق Chrome الإلكتروني"

تمثيل JSON 
{
  "name": string,
  "item": string,
  "authorInfo": {
    object (AuthorInfo)
  },
  "rating": integer,
  "comment": string,
  "createTime": string
}
الحقول
name

string

المعرّف. راجِع اسم المورد. التنسيق: reviews/{reviewId}
item

string

النتائج فقط. تمثّل هذه السمة العنصر الذي تقيّمه هذه المراجعة. التنسيق: publishers/{publisher}/items/{item}
authorInfo

object (AuthorInfo)

معلومات عن مؤلف المراجعة
rating

integer

تقييم السلعة، بين 1 و5
comment

string

محتوى المراجعة
createTime

string (Timestamp format)

النتائج فقط. وقت نشر المراجعة

يستخدم المعيار RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه مُمثلاً بالتوقيت العالمي المنسَّق مع حرف Z في النهاية ويستخدم الأرقام الجزئية 0 أو 3 أو 6 أو 9. تُقبل أيضًا المعادلات الأخرى التي لا تستخدم حرف Z. أمثلة: "2014-10-02T15:01:23Z" أو "2014-10-02T15:01:23.045123456Z" أو "2014-10-02T15:01:23+05:30"

AuthorInfo

معلومات عن مؤلف المراجعة

تمثيل JSON 
{
  "displayName": string
}
الحقول
displayName

string

الاسم المعروض للمؤلف