REST Resource: reviews

منبع: نقد و بررسی

نقد و بررسی یک اپلیکیشن اندروید

نمایش 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 )

نظر یک توسعه‌دهنده.

نظر کاربر

ورود کاربر از مکالمه بین کاربر و توسعه‌دهنده.

نمایش 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

امتیاز ستاره‌ای مرتبط با نقد، از ۱ تا ۵.

reviewerLanguage

string

کد زبان برای بررسی‌کننده. این کد از تنظیمات دستگاه گرفته شده است، بنابراین تضمینی وجود ندارد که با زبانی که بررسی با آن نوشته شده است مطابقت داشته باشد. ممکن است وجود نداشته باشد.

device

string

اسم رمز دستگاه بررسی‌کننده، مثلاً klte، flounder. ممکن است وجود نداشته باشد.

androidOsVersion

integer

نسخه صحیح Android SDK دستگاه کاربر در زمان نگارش نقد، مثلاً ۲۳ مارشمالو. ممکن است وجود نداشته باشد.

appVersionCode

integer

کد نسخه صحیح برنامه همانطور که در زمان نوشتن نقد نصب شده است. ممکن است وجود نداشته باشد.

appVersionName

string

نام نسخه برنامه که در زمان نوشتن نقد نصب شده است را به صورت رشته‌ای وارد کنید. ممکن است وجود نداشته باشد.

thumbsUpCount

integer

تعداد کاربرانی که به این نظر امتیاز مثبت داده‌اند.

thumbsDownCount

integer

تعداد کاربرانی که به این نظر رأی منفی داده‌اند.

deviceMetadata

object ( DeviceMetadata )

اطلاعات مربوط به ویژگی‌های دستگاه کاربر.

originalText

string

متن ترجمه نشده نقد، جایی که نقد ترجمه شده است. اگر نقد ترجمه نشده باشد، این قسمت خالی گذاشته می‌شود.

مهر زمانی

یک مهر زمان، نقطه‌ای از زمان را مستقل از هر منطقه زمانی یا تقویم محلی نشان می‌دهد که به صورت تعداد ثانیه‌ها و کسری از ثانیه‌ها با وضوح نانوثانیه کدگذاری شده است. این تعداد نسبت به یک دوره زمانی در نیمه‌شب UTC در ۱ ژانویه ۱۹۷۰ است.

نمایش JSON 
{
  "seconds": string,
  "nanos": integer
}
فیلدها
seconds

string ( int64 format)

ثانیه‌های زمان UTC را از زمان آغاز یونیکس نشان می‌دهد.

nanos

integer

کسرهای غیر منفی ثانیه با وضوح نانوثانیه. باید شامل ۰ تا ۹۹۹۹۹۹۹۹۹۹۹ باشد.

دستگاهفراداده

ویژگی‌های دستگاه کاربر.

نمایش 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

سازنده دستگاه (مثلاً موتورولا)

deviceClass

string

کلاس دستگاه (مثلاً تبلت)

screenWidthPx

integer

عرض صفحه نمایش بر حسب پیکسل

screenHeightPx

integer

ارتفاع صفحه نمایش بر حسب پیکسل

nativePlatform

string

فهرست پلتفرم‌های بومی (مثلاً "arm"، "arm7") که با ویرگول از هم جدا شده‌اند

screenDensityDpi

integer

تراکم صفحه نمایش (DPI)

glEsVersion

integer

نسخه OpenGL

cpuModel

string

مدل CPU دستگاه، مثلاً "MSM8974"

cpuMake

string

سازنده پردازنده دستگاه، مثلاً "Qualcomm"

ramMb

integer

رم دستگاه بر حسب مگابایت، مثلاً "2048"

نظر توسعه‌دهنده

ورودی توسعه‌دهنده از مکالمه بین کاربر و توسعه‌دهنده.

نمایش JSON 
{
  "text": string,
  "lastModified": {
    object (Timestamp)
  }
}
فیلدها
text

string

محتوای نظر، یعنی بدنه پاسخ.

lastModified

object ( Timestamp )

آخرین باری که این نظر به‌روزرسانی شده است.

روش‌ها

get

 یک بررسی واحد دریافت می‌کند.

list

 همه نقدها را فهرست می‌کند.

reply

 به یک نظر پاسخ می‌دهد، یا یک پاسخ موجود را به‌روزرسانی می‌کند.

کدهای خطا

عملیات این منبع، کدهای خطای HTTP زیر را برمی‌گرداند:

کد خطا دلیل توضیحات وضوح تصویر
400 invalidValue مقدار نامعتبری در درخواست ارائه شده است. این اغلب به عنوان یک توکن خرید ناقص یا نامعتبر برگردانده می‌شود. مقدار فیلد نامعتبر را در بدنه درخواست یا پارامترها بر اساس مرجع API اصلاح کنید.
400 required یک فیلد یا پارامتر الزامی در درخواست وجود ندارد. برای اطمینان از وجود تمام فیلدها و پارامترهای اجباری، به مستندات API مراجعه کنید.
403 userInsufficientPermission کاربر مجوز کافی برای انجام عملیات درخواستی را ندارد. مطمئن شوید که کاربر احراز هویت شده مجوزهای لازم را در کنسول گوگل پلی دارد. برای جزئیات بیشتر به بخش «استفاده از حساب کاربری سرویس» مراجعه کنید.
404 notFound منبع مورد نظر یافت نشد. تأیید کنید که شناسه‌ها (مثلاً توکن خرید، نام بسته، شناسه محصول، شناسه اشتراک) صحیح باشند.
409 concurrentUpdate تلاشی برای به‌روزرسانی شیء‌ای که به‌طور همزمان به‌روزرسانی می‌شود، صورت گرفته است. درخواست را با backoff نمایی دوباره امتحان کنید. از تغییرات همزمان در همان منبع خودداری کنید.
5xx Generic error خطای عمومی در سرور گوگل پلی. درخواست خود را دوباره امتحان کنید.

اگر مشکل همچنان ادامه داشت، با مدیر حساب Google Play خود تماس بگیرید یا درخواست پشتیبانی ارسال کنید. داشبورد وضعیت Play را برای هرگونه قطعی شناخته شده بررسی کنید.