Method: accounts.locations.batchGetReviews

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

درخواست HTTP

POST https://mybusiness.googleapis.com/v4/{name=accounts/*}/locations:batchGetReviews

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

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

پارامترها
name

string

نام حسابی که از آن فهرستی از نظرات در چندین مکان بازیابی می‌شود.

درخواست بدن

بدنه درخواست حاوی داده هایی با ساختار زیر است:

نمایندگی JSON 
{
  "locationNames": [
    string
  ],
  "pageSize": integer,
  "pageToken": string,
  "orderBy": string,
  "ignoreRatingOnlyReviews": boolean
}
فیلدها
locationNames[]

string

مجموعه‌ای از مکان‌ها برای واکشی نظرات، که با نام آنها مشخص شده است.

pageSize

integer

تعداد نظرات برای واکشی در هر صفحه. مقدار پیش فرض 50 است.

pageToken

string

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

orderBy

string

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

ignoreRatingOnlyReviews

boolean

نادیده گرفتن نظرات فقط رتبه‌بندی.

بدن پاسخگو

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

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

نمایندگی JSON 
{
  "locationReviews": [
    {
      object (LocationReview)
    }
  ],
  "nextPageToken": string
}
فیلدها
locationReviews[]

object ( LocationReview )

نظرات با اطلاعات مکان.

nextPageToken

string

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

محدوده مجوز

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

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

برای اطلاعات بیشتر، به نمای کلی OAuth 2.0 مراجعه کنید.

LocationReview

نمایانگر یک بررسی با اطلاعات مکان است.

نمایندگی JSON 
{
  "name": string,
  "review": {
    object (Review)
  }
}
فیلدها
name

string

نام منبع مکان

review

object ( Review )

بررسی موقعیت مکانی