REST Resource: reviews

المصدر: مراجعة

مراجعة لتطبيق Android

تمثيل JSON 
{
  "reviewId": string,
  "authorName": string,
  "comments": [
    {
      object (Comment)
    }
  ]
}
الحقول
reviewId

string

معرّف فريد لهذه المراجعة.
authorName

string

تمثّل هذه السمة اسم المستخدم الذي كتب المراجعة.
comments[]

object (Comment)

حقل متكرّر يحتوي على تعليقات حول المراجعة

تعليق

إدخال في محادثة بين المستخدم والمطوّر

تمثيل JSON 
{

  // Union field comment can be only one of the following:
  "userComment": {
    object (UserComment)
  },
  "developerComment": {
    object (DeveloperComment)
  }
  // End of list of possible types for union field comment.
}
الحقول

حقل الربط comment

يمكن أن يكون التعليق comment إحدى القيم التالية فقط:
userComment

object (UserComment)

تعليق من مستخدم
developerComment

object (DeveloperComment)

تعليق من أحد المطوّرين

UserComment

إدخال من أحد المستخدمين في محادثة بينه وبين والمطوّر

تمثيل JSON 
{
  "text": string,
  "lastModified": {
    object (Timestamp)
  },
  "starRating": integer,
  "reviewerLanguage": string,
  "device": string,
  "androidOsVersion": integer,
  "appVersionCode": integer,
  "appVersionName": string,
  "thumbsUpCount": integer,
  "thumbsDownCount": integer,
  "deviceMetadata": {
    object (DeviceMetadata)
  },
  "originalText": string
}
الحقول
text

string

محتوى التعليق، أي نص المراجعة في بعض الحالات، أتاح النظام للمستخدمين كتابة مراجعة تتضمن عنوانًا ونصًا منفصلين؛ حيث يتم دمج العنوان مع النص والفصل بينهما باستخدام علامة الجدولة (Tab).
lastModified

object (Timestamp)

يشير هذا الحقل إلى تاريخ آخر مرة تم فيها تعديل هذا التعليق.
starRating

integer

التقييم بالنجوم المرتبط بالمراجعة، من 1 إلى 5
reviewerLanguage

string

تمثّل هذه السمة رمز اللغة الخاص بالمُراجع. يتم الحصول على هذه البيانات من إعدادات الجهاز؛ لذا قد لا تتطابق بالضرورة مع اللغة التي كُتبت بها المراجعة. قد لا تكون متوفّرة.
device

string

تمثل هذه السمة الاسم الرمزي لجهاز المُراجع، مثل klte أو flounder قد لا تكون متوفّرة.
androidOsVersion

integer

تشير هذه السمة إلى رقم إصدار حزمة تطوير البرامج (SDK) لنظام التشغيل Android على جهاز المستخدم وقت كتابة المراجعة، فمثلاً، يشير الرقم 23 إلى إصدار Marshmallow. قد لا تكون متوفّرة.
appVersionCode

integer

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

string

تشير هذه السمة إلى اسم إصدار التطبيق كسلسلة نصية كما تم تثبيته في وقت كتابة المراجعة. قد لا تكون متوفّرة.
thumbsUpCount

integer

تشير هذه السمة إلى عدد المستخدمين الذين أعجبهم هذا التعليق.
thumbsDownCount

integer

تشير هذه السمة إلى عدد المستخدمين الذين لم يعجبهم هذا التعليق
deviceMetadata

object (DeviceMetadata)

تشير هذه السمة إلى المعلومات المرتبطة بخصائص جهاز المستخدم
originalText

string

تشير هذه السمة إلى النص الأصلي للمراجعة قبل الترجمة،وذلك في الحالات التي تتُرجم فيها المراجعات آليًا وفي حال لم تُترجَم للمراجعة، ستُترك هذه السمة فارغة

الطابع الزمني

يمثل الطابع الزمني نقطة زمنية مستقلة عن المناطق الزمنية أو التقاويم المحلية، ويُعبّر عنه بعدد الثواني وأجزاء الثواني بدقة تصل إلى النانو ثانية. ويُحسب هذا العدد استنادًا إلى نقطة الأصل الزمنية (Epoch)، وهي منتصف ليل الأول من يناير 1970 حسب التوقيت العالمي المنسق (UTC).

تمثيل JSON 
{
  "seconds": string,
  "nanos": integer
}
الحقول
seconds

string (int64 format)

تشير هذه السمة إلى عدد ثواني التوقيت العالمي المنسق (UTC) المنقضية منذ بداية حقبة يونكس
nanos

integer

تشير هذه السمة إلى أجزاء الثانية غير السالبة بدقة النانو ثانية يجب أن تتراوح القيمة بين 0 و999,999,999، بما في ذلك طرفي النطاق

DeviceMetadata

سمات جهاز المستخدم

تمثيل JSON 
{
  "productName": string,
  "manufacturer": string,
  "deviceClass": string,
  "screenWidthPx": integer,
  "screenHeightPx": integer,
  "nativePlatform": string,
  "screenDensityDpi": integer,
  "glEsVersion": integer,
  "cpuModel": string,
  "cpuMake": string,
  "ramMb": integer
}
الحقول
productName

string

اسم طراز الجهاز (مثل Droid)
manufacturer

string

الشركة المصنّعة للجهاز (مثل Motorola)
deviceClass

string

فئة الجهاز (مثل جهاز لوحي)
screenWidthPx

integer

عرض الشاشة بالبكسل
screenHeightPx

integer

ارتفاع الشاشة بالبكسل
nativePlatform

string

قائمة قيم مفصولة بفاصلة للمنصات الأصلية (مثل "arm" و"arm7")
screenDensityDpi

integer

كثافة الشاشة بالنقاط لكل بوصة
glEsVersion

integer

إصدار OpenGL
cpuModel

string

طراز وحدة المعالجة المركزية للجهاز، مثل "MSM8974"
cpuMake

string

الشركة المصنّعة لوحدة المعالجة المركزية (CPU) للجهاز، مثل "Qualcomm"
ramMb

integer

ذاكرة الوصول العشوائي (RAM) للجهاز بالميجابايت، مثل "2048"

DeveloperComment

إدخال من المطوّر في محادثة بينه وبين المستخدم

تمثيل JSON 
{
  "text": string,
  "lastModified": {
    object (Timestamp)
  }
}
الحقول
text

string

تشير هذه السمة إلى محتوى التعليق، أي نص الرد.
lastModified

object (Timestamp)

يشير هذا الحقل إلى تاريخ آخر مرة تم فيها تعديل هذا التعليق.

الإجراءات

get

 يستدعي مراجعة واحدة.

list

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

reply

 يتيح الرد على مراجعة واحدة أو تعديل ردّ حالي.

رموز الخطأ

تعرض عمليات هذا المورد رموز خطأ HTTP التالية:

رمز الخطأ السبب الوصف الدقة