لعرض قائمة المراجعات المقسّمة على صفحات للموقع الجغرافي المحدّد. تكون هذه العملية صالحة فقط إذا تم إثبات صحة الموقع الجغرافي المحدد.
طلب HTTP
GET https://mybusiness.googleapis.com/v4/{parent=accounts/*/locations/*}/reviews
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
مَعلمات المسار
المَعلمات | |
---|---|
parent |
اسم الموقع الجغرافي المطلوب جلب مراجعات عنه |
معلمات طلب البحث
المَعلمات | |
---|---|
pageSize |
عدد المراجعات المطلوب جلبها لكل صفحة الحد الأقصى لعدد |
pageToken |
وفي حال تحديد ذلك، يجلب الصفحة التالية من المراجعات. |
orderBy |
تحديد الحقل لترتيب المراجعات حسبه. وفي حال عدم تحديد ذلك، سيتم ضبط ترتيب المراجعات تلقائيًا على |
نص الطلب
يجب أن يكون نص الطلب فارغًا.
نص الاستجابة
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
رسالة الرد لـ Review.ListReviews.
تمثيل JSON | |
---|---|
{
"reviews": [
{
object ( |
الحقول | |
---|---|
reviews[] |
المراجعات. |
averageRating |
متوسط التقييم بالنجوم لجميع المراجعات الخاصة بهذا الموقع على مقياس من 1 إلى 5، حيث يمثل الرقم 5 أعلى تقييم. |
totalReviewCount |
إجمالي عدد المراجعات لهذا الموقع الجغرافي. |
nextPageToken |
إذا تجاوز عدد المراجعات حجم الصفحة المطلوب، تتم تعبئة هذا الحقل برمز مميّز لجلب الصفحة التالية من المراجعات في عملية استدعاء لاحقة إلى review.list. إذا لم يكن هناك المزيد من المراجعات، هذا الحقل غير متوفّر في الرد. |
نطاقات الأذونات
يتطلب استخدام أحد نطاقات OAuth التالية:
https://www.googleapis.com/auth/plus.business.manage
https://www.googleapis.com/auth/business.manage
لمزيد من المعلومات، راجِع نظرة عامة على بروتوكول OAuth 2.0.