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
(deprecated)

boolean

تحديد ما إذا كان سيتم تجاهل المراجعات التي تتضمّن تقييمًا فقط

نص الاستجابة

رسالة الردّ على Reviews.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 Overview.

LocationReview

تمثّل هذه السمة مراجعة تتضمّن معلومات الموقع الجغرافي.

تمثيل JSON 
{
  "name": string,
  "review": {
    object (Review)
  }
}
الحقول
name

string

اسم مورد الموقع الجغرافي
review

object (Review)

تمثّل هذه السمة مراجعة للموقع الجغرافي.