Method: publishers.items.fetchReviews

مرورهای کاربر را برای موردی واکشی کنید.

درخواست HTTP

GET https://chromewebstore.googleapis.com/v2/{name=publishers/*/items/*}:fetchReviews

نشانی وب از نحو تراتبدیل gRPC استفاده می‌کند.

پارامترهای مسیر

پارامترها
name

string

الزامی. نام منبع موردی که مرورهای آن واکشی می‌شود. قالب: publishers/{publisher_id}/items/{itemId}

پارامترهای پُرسمان

پارامترها
pageSize

integer

اختیاری. حداکثر تعداد مرورها برای برگرداندن. سرویس ممکن است کمتر از این مقدار را برگرداند. اگر مشخص نشده باشد، حداکثر ۵۰ مرور برگردانده می‌شود. حداکثر مقدار ۲۰۰ است؛ مقادیر بالاتر از ۲۰۰ به ۲۰۰ تبدیل می‌شوند.
pageToken

string

اختیاری. یک توکن صفحه، که از تماس قبلی items.fetchReviews دریافت شده است. برای بازیابی صفحه بعدی، این را ارائه دهید.

هنگام صفحه‌بندی، همه پارامترهای دیگری که به items.fetchReviews ارائه می‌شوند باید با فراخوانی‌ای که کد صفحه را ارائه کرده است مطابقت داشته باشند.
filter

string

اختیاری. فیلتری برای اعمال روی مرورها. فقط مقایسه برابری در رده‌بندی پشتیبانی می‌شود، مثلاً rating = 5.
orderBy

string

اختیاری. فهرست اختیاری جداشده با کاما از فیلدهایی که نتایج براساس آن‌ها مرتب می‌شود. ترتیب مرتب‌سازی پیش‌فرض صعودی (asc) است. فیلدهای پشتیبانی‌شده عبارت‌اند از: - rating: ترتیب‌های پشتیبانی‌شده asc (پیش‌فرض) و desc هستند. - createTime: فقط desc (جدیدترین در ابتدا) پشتیبانی می‌شود؛ desc باید به‌طور صریح مشخص شود زیرا پیش‌فرض asc است. مثال: rating desc، createTime desc، یا rating desc, createTime desc.

متن درخواست

بدنه درخواست باید خالی باشد.

بدنه پاسخ

پیام پاسخ برای items.fetchReviews.

درصورت موفقیت‌آمیز بودن، بدنه پاسخ حاوی داده‌هایی با ساختار زیر است:

نمایش JSON 
{
  "reviews": [
    {
      object (Review)
    }
  ],
  "nextPageToken": string
}
فیلدها
reviews[]

object (Review)

فهرست مرورها.
nextPageToken

string

نشانه‌ای که می‌تواند به‌عنوان pageToken برای بازیابی صفحه بعدی ارسال شود. اگر این فیلد حذف شود، صفحه بعدی وجود ندارد.

دامنه‌های مجوز

به یکی از دامنه‌های OAuth زیر نیاز دارد:

  • https://www.googleapis.com/auth/chromewebstore
  • https://www.googleapis.com/auth/chromewebstore.readonly

مرور

مروری که کاربر برای رده‌بندی محصولی در «نت‌بازار Chrome» نوشته است.

نمایش JSON 
{
  "name": string,
  "item": string,
  "authorInfo": {
    object (AuthorInfo)
  },
  "rating": integer,
  "comment": string,
  "createTime": string
}
فیلدها
name

string

شناسه. نام منبع را مرور کنید. قالب: reviews/{reviewId}
item

string

فقط خروجی. موردی که این مرور آن را ارزیابی می‌کند. قالب: publishers/{publisher}/items/{item}
authorInfo

object (AuthorInfo)

اطلاعات درباره نویسنده مرور.
rating

integer

رده‌بندی مورد، بین ۱ تا ۵.
comment

string

محتوای مرور.
createTime

string (Timestamp format)

فقط خروجی. زمان پست شدن مرور.

از RFC 3339 استفاده می‌کند، که در آن خروجی تولیدشده همیشه Z-نرمال‌سازی می‌شود و از ۰، ۳، ۶، یا ۹ رقم اعشاری استفاده می‌کند. انحراف‌های غیراز «Z» نیز پذیرفته می‌شود. مثال‌ها: "2014-10-02T15:01:23Z"، "2014-10-02T15:01:23.045123456Z"، یا "2014-10-02T15:01:23+05:30".

AuthorInfo

اطلاعات درباره نویسنده مرور.

نمایش JSON 
{
  "displayName": string
}
فیلدها
displayName

string

نام نمایشی نویسنده.