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