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

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.

LocationReview

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

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

string

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

object (Review)

مراجعة للموقع الجغرافي.