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.

نص الطلب

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

نص الاستجابة

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

رسالة ردّ على Reviews.ListReviews.

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

object (Review)

المراجعات.
averageRating

number

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

integer

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

string

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

نطاقات التفويض

يتطلب هذا الإعداد أحد نطاقات OAuth التالية:

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

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