REST Resource: accounts.locations.reviews

المصدر: مراجعة

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

تمثيل JSON 
{
  "name": string,
  "reviewId": string,
  "reviewer": {
    object (Reviewer)
  },
  "starRating": enum (StarRating),
  "comment": string,
  "createTime": string,
  "updateTime": string,
  "reviewReply": {
    object (ReviewReply)
  }
}
الحقول
name

string

تمثّل هذه السمة اسم المورد. بالنسبة إلى "في انتظار المراجعة"، يكون التنسيق accounts/{accountId}/locations/{locationId}/reviews/{reviewId}
reviewId

string

المعرّف الفريد المشفّر
reviewer

object (Reviewer)

تمثّل هذه السمة مؤلف المراجعة.
starRating

enum (StarRating)

تمثّل هذه السمة التقييم بالنجوم للمراجعة.
comment

string

نص المراجعة كنص عادي مع ترميزات
createTime

string (Timestamp format)

الطابع الزمني لوقت كتابة المراجعة

يستخدم المعيار RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه مُمثلاً بالتوقيت العالمي المنسَّق مع حرف Z في النهاية ويستخدم الأرقام الجزئية 0 أو 3 أو 6 أو 9. تُقبل أيضًا المعادلات الأخرى التي لا تستخدم حرف Z. أمثلة: "2014-10-02T15:01:23Z" أو "2014-10-02T15:01:23.045123456Z" أو "2014-10-02T15:01:23+05:30".
updateTime

string (Timestamp format)

الطابع الزمني لآخر تعديل تم إجراؤه على المراجعة

يستخدم المعيار RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه مُمثلاً بالتوقيت العالمي المنسَّق مع حرف Z في النهاية ويستخدم الأرقام الجزئية 0 أو 3 أو 6 أو 9. تُقبل أيضًا المعادلات الأخرى التي لا تستخدم حرف Z. أمثلة: "2014-10-02T15:01:23Z" أو "2014-10-02T15:01:23.045123456Z" أو "2014-10-02T15:01:23+05:30".
reviewReply

object (ReviewReply)

ردّ المالك أو المدير على هذه المراجعة

المراجع

تمثّل هذه السمة مؤلف المراجعة.

تمثيل JSON 
{
  "profilePhotoUrl": string,
  "displayName": string,
  "isAnonymous": boolean
}
الحقول
profilePhotoUrl

string

رابط صورة الملف الشخصي للمُراجِع تتم تعبئة هذا الحقل فقط إذا كانت قيمة isAnonymous هي "خطأ".
displayName

string

تمثّل هذه السمة اسم مقدّم المراجعة. يتم ملء هذا الحقل باسم المُراجع الحقيقي فقط إذا كانت قيمة isAnonymous هي false.
isAnonymous

boolean

تشير إلى ما إذا اختار المُراجع إخفاء هويته.

StarRating

التقييم بالنجوم من أصل خمس نجوم، حيث يشير الرقم خمسة إلى أعلى تقييم.

عمليات التعداد
STAR_RATING_UNSPECIFIED لم يتم تحديد أي قيمة.
ONE نجمة واحدة من أصل خمس نجوم كحد أقصى
TWO نجمتان من أصل خمس نجوم كحد أقصى
THREE ثلاث نجوم من أصل خمسة
FOUR أربع نجوم من أصل خمسة كحد أقصى
FIVE تمثّل هذه السمة الحد الأقصى للتقييم بالنجوم.

ReviewReply

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

تمثيل JSON 
{
  "comment": string,
  "updateTime": string,
  "reviewReplyState": enum (State)
}
الحقول
comment

string

نص الرد كنص عادي مع ترميزات الحد الأقصى للطول هو 4096 بايت.
updateTime

string (Timestamp format)

النتائج فقط. الطابع الزمني لآخر مرة تم فيها تعديل الرد.

يستخدم المعيار RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه مُمثلاً بالتوقيت العالمي المنسَّق مع حرف Z في النهاية ويستخدم الأرقام الجزئية 0 أو 3 أو 6 أو 9. تُقبل أيضًا المعادلات الأخرى التي لا تستخدم حرف Z. أمثلة: "2014-10-02T15:01:23Z" أو "2014-10-02T15:01:23.045123456Z" أو "2014-10-02T15:01:23+05:30".
reviewReplyState

enum (State)

النتائج فقط. تمثّل هذه السمة حالة الردّ على المراجعة.

ولاية

تمثّل هذه السمة حالة الإشراف على ردّ على مراجعة.

عمليات التعداد
REVIEW_REPLY_STATE_UNSPECIFIED تشير إلى أنّ الحالة غير محدّدة.
PENDING تشير إلى أنّ الردّ في انتظار الإشراف.
REJECTED تشير إلى أنّه تم رفض الردّ.
APPROVED تشير إلى أنّه تمت الموافقة على الردّ.

الطُرق

deleteReply

 يحذف هذا الإجراء الردّ على المراجعة المحدّدة.

get

 تعرض هذه السمة المراجعة المحدّدة.

list

 تعرض هذه الطريقة قائمة مراجعات مقسّمة إلى صفحات للموقع الجغرافي المحدّد.

updateReply

 تعدّل هذه الطريقة الردّ على المراجعة المحدّدة.