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

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

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

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

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

يمثّل الطابع الزمني نقطة في الوقت مستقلة عن أي منطقة زمنية أو تقويم محلي، ويتم ترميزه كعدد من الثواني وأجزاء من الثواني بدقة النانو ثانية. ويكون العدد مرتبطًا بحقبة في منتصف الليل بالتوقيت العالمي المنسَّق في 1 يناير 1970.

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

string (int64 format)

تمثّل هذه السمة ثواني التوقيت العالمي المنسَّق منذ بدء حقبة 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

طراز وحدة المعالجة المركزية للجهاز، مثل "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 التالية:

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