Method: accounts.locations.reviews.list

لیست صفحه‌بندی‌شده‌ی نظرات را برای مکان مشخص‌شده برمی‌گرداند. این عملیات فقط در صورتی معتبر است که مکان مشخص‌شده تأیید شده باشد.

درخواست HTTP

GET https://mybusiness.googleapis.com/v4/{parent=accounts/*/locations/*}/reviews

این URL از سینتکس Transcoding در gRPC استفاده می‌کند.

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

پارامترها
parent

string

نام مکانی که قرار است نظرات درباره آن دریافت شود.

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

پارامترها
pageSize

integer

چند نقد و بررسی برای هر صفحه باید دریافت شود. حداکثر pageSize ۵۰ است.

pageToken

string

در صورت مشخص شدن، صفحه بعدی نظرات را دریافت می‌کند.

orderBy

string

فیلدی را برای مرتب‌سازی نظرات مشخص می‌کند. اگر مشخص نشود، ترتیب نظرات برگردانده شده به طور پیش‌فرض updateTime desc خواهد بود. ترتیب‌های معتبر برای مرتب‌سازی بر اساس rating ، rating desc و updateTime desc هستند.

درخواست بدنه

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

بدنه پاسخ

پیام پاسخ برای Reviews.ListReviews.

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

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

object ( Review )

نقدها

averageRating

number

میانگین امتیاز ستاره‌ای همه نظرات برای این مکان در مقیاس ۱ تا ۵، که ۵ بالاترین امتیاز است.

totalReviewCount

integer

تعداد کل نظرات برای این مکان.

nextPageToken

string

اگر تعداد نظرات از اندازه صفحه درخواستی بیشتر شود، این فیلد با یک توکن پر می‌شود تا صفحه بعدی نظرات در فراخوانی بعدی reviews.list بازیابی شود. اگر نظرات بیشتری وجود نداشته باشد، این فیلد در پاسخ وجود ندارد.

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

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

  • https://www.googleapis.com/auth/plus.business.manage
  • https://www.googleapis.com/auth/business.manage

برای اطلاعات بیشتر، بهOAuth 2.0 Overview .