Method: accounts.locations.reviews.list

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

درخواست HTTP

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

URL از دستور GRPC Transcoding استفاده می کند.

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

پارامترها
parent

string

نام مکان برای واکشی نظرات.

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

پارامترها
pageSize

integer

تعداد نظرات برای واکشی در هر صفحه. حداکثر pageSize 50 است.

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

میانگین رتبه‌بندی ستاره همه نظرات برای این مکان در مقیاس 1 تا 5، که در آن 5 بالاترین رتبه است.

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 مراجعه کنید.