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

الاسم الرمزي لجهاز المُراجع، على سبيل المثال: كلتي فلوندر قد تكون غير متاحة.

androidOsVersion

integer

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

appVersionCode

integer

رمز إصدار صحيح للتطبيق حسب ما تم تثبيته وقت كتابة المراجعة. قد تكون غير متاحة.

appVersionName

string

اسم إصدار السلسلة للتطبيق الذي تم تثبيته وقت كتابة المراجعة. قد تكون غير متاحة.

thumbsUpCount

integer

عدد المستخدمين الذين أبدوا إعجابهم بهذا التعليق

thumbsDownCount

integer

عدد المستخدمين الذين لم يعجبهم هذا التعليق

deviceMetadata

object (DeviceMetadata)

تمثّل هذه السمة معلومات عن خصائص جهاز المستخدم.

originalText

string

تمثّل هذه السمة النص غير المترجَم للمراجعة، حيث تمت ترجمة المراجعة. إذا لم تتم ترجمة المراجعة، يُترك هذا الحقل فارغًا.

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

يمثِّل الطابع الزمني نقطة زمنية مستقلة عن أي منطقة زمنية أو تقويم محلي، حيث يتم ترميزها بعدد الثواني والكسور من الثواني بدقة نانوثانية. ويرجع هذا العدد إلى حقبة في منتصف الليل حسب التوقيت العالمي المنسَّق في 1 كانون الثاني (يناير) 1970.

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

string (int64 format)

يمثل ذلك ثواني من التوقيت العالمي المنسق (UTC) منذ حقبة Unix.

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

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

cpuMake

string

نوع وحدة المعالجة المركزية (CPU) للجهاز، مثل: "كوالكوم"

ramMb

integer

ذاكرة الوصول العشوائي للجهاز بالميغابايت، على سبيل المثال "2048"

DeveloperComment

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

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

string

محتوى التعليق، أي نص الردّ

lastModified

object (Timestamp)

تاريخ آخر تعديل تم فيه تعديل هذا التعليق

الطُرق

get

يحصل على مراجعة واحدة.

list

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

reply

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