Method: accounts.locations.batchGetReviews

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

درخواست HTTP

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

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

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

پارامترها
name

string

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

درخواست بدنه

بدنه درخواست شامل داده‌هایی با ساختار زیر است:

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

string

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

pageSize

integer

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

pageToken

string

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

orderBy

string

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

ignoreRatingOnlyReviews
(deprecated)

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 Overview .

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

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

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

string

نام منبع مکان.

review

object ( Review )

یک بررسی برای مکان.