Method: accounts.locations.reviews.list

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

طلب HTTP

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

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

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

المَعلمات
parent

string

اسم الموقع الجغرافي المطلوب جلب مراجعات عنه

معلمات طلب البحث

المَعلمات
pageSize

integer

عدد المراجعات المطلوب جلبها لكل صفحة الحد الأقصى لعدد pageSize هو 50.
pageToken

string

وفي حال تحديد ذلك، يجلب الصفحة التالية من المراجعات.
orderBy

string

تحديد الحقل لترتيب المراجعات حسبه. وفي حال عدم تحديد ذلك، سيتم ضبط ترتيب المراجعات تلقائيًا على updateTime desc. الطلبات الصالحة للترتيب حسبها هي rating وrating desc وupdateTime desc.

نص الطلب

يجب أن يكون نص الطلب فارغًا.

نص الاستجابة

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

رسالة الرد لـ Review.ListReviews.

تمثيل JSON 
{
  "reviews": [
    {
      object (Review)
    }
  ],
  "averageRating": number,
  "totalReviewCount": integer,
  "nextPageToken": string
}
الحقول
reviews[]

object (Review)

المراجعات.
averageRating

number

متوسط التقييم بالنجوم لجميع المراجعات الخاصة بهذا الموقع على مقياس من 1 إلى 5، حيث يمثل الرقم 5 أعلى تقييم.
totalReviewCount

integer

إجمالي عدد المراجعات لهذا الموقع الجغرافي.
nextPageToken

string

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

نطاقات الأذونات

يتطلب استخدام أحد نطاقات OAuth التالية:

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

لمزيد من المعلومات، راجِع نظرة عامة على بروتوكول OAuth 2.0.