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 التالية:

رمز الخطأ السبب الوصف الدقة
400 invalidValue تم إدخال قيمة غير صالحة في الطلب. يتم عرض هذا الرمز غالبًا عند تقديم رمز مميّز غير صالح أو غير مكتمل لعملية الشراء. صحِّح قيمة الحقل غير الصالحة في نص الطلب أو المَعلمات استنادًا إلى مرجع واجهة برمجة التطبيقات.
400 required لم يتم إدخال حقل أو مَعلمة مطلوبة في الطلب. راجِع مستندات واجهة برمجة التطبيقات للتأكّد من تضمين جميع الحقول والمَعلمات الإلزامية.
403 userInsufficientPermission لا يملك المستخدم الإذن الكافي لتنفيذ العملية المطلوبة. تأكَّد من أنّ المستخدم المصادَق عليه لديه الأذونات اللازمة في Google Play Console. لمزيد من التفاصيل، يُرجى الاطّلاع على استخدام حساب خدمة.
404 notFound تعذَّر العثور على المورد المطلوب. تأكَّد من صحة المعرّفات (مثل رمز الشراء أو اسم الحزمة أو معرّف المنتج أو معرّف الاشتراك).
409 concurrentUpdate تمت محاولة تعديل عنصر يتم تعديله في الوقت نفسه. أعِد محاولة إرسال الطلب باستخدام خوارزمية الرقود الأسي الثنائي. تجنَّب إجراء تعديلات متزامنة على المرجع نفسه.
5xx Generic error حدث خطأ عام في خادم Google Play. أعِد محاولة إرسال طلبك.

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