Method: accounts.locations.batchGetReviews

تعرض قائمة المراجعات المقسّمة على صفحات لجميع المواقع الجغرافية المحدّدة. تكون هذه العملية صالحة فقط إذا تم إثبات صحة المواقع الجغرافية المحدّدة.

طلب HTTP

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

يستخدِم عنوان URL بنية تحويل ترميز gRPC.

مَعلمات المسار

المَعلمات
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

ما إذا كان سيتم تجاهل المراجعات الخاصة بالتقييم فقط.

نص الاستجابة

إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:

رسالة رد لـ Review.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)

مراجعة للموقع.