تعرض قائمة المراجعات المقسّمة على صفحات لجميع المواقع الجغرافية المحدّدة. تكون هذه العملية صالحة فقط إذا تم إثبات صحة المواقع الجغرافية المحدّدة.
طلب HTTP
POST https://mybusiness.googleapis.com/v4/{name=accounts/*}/locations:batchGetReviews
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
مَعلمات المسار
المَعلمات | |
---|---|
name |
اسم الحساب الذي يمكن من خلاله استرداد قائمة المراجعات على مستوى مواقع جغرافية متعددة |
نص الطلب
يحتوي نص الطلب على بيانات بالبنية التالية:
تمثيل JSON | |
---|---|
{ "locationNames": [ string ], "pageSize": integer, "pageToken": string, "orderBy": string, "ignoreRatingOnlyReviews": boolean } |
الحقول | |
---|---|
locationNames[] |
مجموعة من المواقع الجغرافية لجلب مراجعات عنها، يتم تحديدها بأسمائها. |
pageSize |
عدد المراجعات المطلوب جلبها لكل صفحة القيمة التلقائية هي 50. |
pageToken |
وفي حال تحديد ذلك، يجلب الصفحة التالية من المراجعات. |
orderBy |
اختياريّ. تحديد الحقل لترتيب المراجعات حسبه. وفي حال عدم تحديد ذلك، سيتم ضبط ترتيب المراجعات تلقائيًا على |
ignoreRatingOnlyReviews |
ما إذا كان سيتم تجاهل المراجعات الخاصة بالتقييم فقط. |
نص الاستجابة
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
رسالة رد لـ Review.BatchGetReviews
تمثيل JSON | |
---|---|
{
"locationReviews": [
{
object ( |
الحقول | |
---|---|
locationReviews[] |
المراجعات التي تتضمّن معلومات الموقع الجغرافي |
nextPageToken |
إذا تجاوز عدد المراجعات حجم الصفحة المطلوب، تتم تعبئة هذا الحقل برمز مميّز لجلب الصفحة التالية من المراجعات عند إجراء مكالمات لاحقة. إذا لم يكن هناك المزيد من المراجعات، لن يظهر هذا الحقل في الردّ. |
نطاقات الأذونات
يتطلب استخدام أحد نطاقات 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 ( |
الحقول | |
---|---|
name |
اسم مورد الموقع. |
review |
مراجعة للموقع. |