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

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

integer

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

DeveloperComment

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

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

string

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

object (Timestamp)

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

الطُرق

get

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

list

 تعرض هذه السمة جميع المراجعات.

reply

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

رموز الخطأ

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

رمز الخطأ السبب الدقة
5xx حدث خطأ عام في خادم Google Play. أعِد محاولة إرسال طلبك.

إذا استمرت المشكلة، يُرجى التواصل مع مدير حسابك على Google Play أو إرسال طلب دعم. ننصحك بالاطّلاع على لوحة البيانات الخاصة بحالة Play لمعرفة ما إذا كان هناك أي انقطاع معروف في الخدمة.
409 حدث خطأ أثناء تعديل التزامن.

حدثت محاولة لتعديل عنصر قيد التعديل. على سبيل المثال، يتم الإقرار بعملية شراء من خلال استدعاء الطريقة acknowledgePurchase() في Play Billing Library واستدعاء الطريقة purchases.products.acknowledge في Play Developer API في الوقت نفسه.

 أعِد محاولة إرسال طلبك.