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)
  },
  "reviewMediaItems": [
    {
      object (ReviewMediaItem)
    }
  ]
}
الحقول
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)

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

object (ReviewMediaItem)

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

المراجع

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

تمثيل 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),
  "policyViolation": enum (PolicyViolation)
}
الحقول
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)

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

enum (PolicyViolation)

اختياريّ. النتائج فقط. انتهاك السياسة الذي أدّى إلى الرفض تتم تعبئة هذا الحقل فقط إذا كانت قيمة reviewReplyState هي REJECTED.

ولاية

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

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

PolicyViolation

تمثّل هذه السمة انتهاكات السياسات الموحّدة. قد تتم إضافة قيم جديدة في المستقبل. يجب أن تكون التطبيقات جاهزة للتعامل مع القيم غير المعروفة.

عمليات التعداد
POLICY_VIOLATION_UNSPECIFIED تمثّل هذه السمة انتهاكًا غير محدّد للسياسة.
ACCOUNT_RESTRICTED_AND_SUSPENDED تم فرض قيود على أحد حسابات Google المرتبطة بهذا الملف التجاري، ما أدّى إلى تعليق الملف التجاري.
ACCOUNT_RESTRICTED_AND_EDIT_REJECTED تم فرض قيود على أحد حسابات Google المرتبطة بهذا الملف التجاري، ما أدّى إلى رفض التعديلات. على عكس ACCOUNT_RESTRICTED_AND_SUSPENDED، يظلّ الملف التجاري نفسه نشطًا ولا يتم تعليقه.
ASSOCIATED_ACCOUNT_SUSPENDED أحد حسابات Google المرتبطة بهذا الملف التجاري ليس في وضع جيد. وتم تعليق الملفات التجارية المرتبطة بهذا الحساب.
BUSINESS_INELIGIBLE نشاطك التجاري غير مؤهَّل لامتلاك ملف تجاري.
OWNERSHIP_REVOKED لقد طالب حساب Google آخر بهذا الملف التجاري. لم يعُد بإمكانك إدارة هذا الملف التجاري.
LOCATION_SUSPENDED تم تعليق هذا الملف التجاري.
LOCATION_DISABLED تم إيقاف هذا الملف التجاري.
LOCATION_VERIFICATION_REQUIRED لم يتم إثبات ملكية هذا الملف التجاري.
PO_BOX تم تعليق ملفك التجاري لأنّه لا يمكن أن يكون عنوان نشاطك التجاري صندوق بريد.
GOOGLE_PAY_SUSPENSION تم تعليق الملفات التجارية المرتبطة بملف الدفع.
EDITING_RESTRICTION لا يمكن لهذا الملف التجاري حاليًا تلقّي التعديلات العلنية. أوقفت Google إمكانية تعديل هذا الموقع الجغرافي لمنع نشر محتوى ينتهك السياسات.
ILLEGAL_BUSINESS_HOURS_EDIT يتعذّر على فئة مؤسستك تعديل ساعات العمل.
FAKE_ENGAGEMENT لا يُسمح بالمساهمات المخالفة لسياستنا بشأن التفاعلات الزائفة. تشمل التفاعلات الزائفة المحتوى الذي يتم تقديمه مقابل الحصول على حوافز، والمحتوى الذي يهدف إلى التلاعب بتقييم المكان، وغير ذلك من المحتوى الذي لا يمثل تجربة حقيقية.
ADULT_THEMED لا يُسمح بالمساهمات المخالفة لسياستنا بشأن المحتوى الذي يتناول مواضيع ملائمة للبالغين فقط. وتشمل مواضيع البالغين المحتوى الجنسي غير الفاضح وغيره من المحتوى المخصّص للبالغين.
SEXUALLY_EXPLICIT لا يُسمح بالمساهمات المخالفة لسياستنا بشأن المحتوى الجنسي الفاضح. ويشمل المحتوى الجنسي الفاضح مشاهد عُري تعرض الأعضاء التناسلية أو صورًا أو أوصافًا لأفعال جنسية.
ADVERTISING_AND_SOLICITATION لا يُسمح بالمساهمات المخالفة لسياستنا بشأن عرض الإعلانات أو طلب الخدمات. ويشمل ذلك المحتوى الترويجي أو التجاري أو المحتوى الذي يتم نشره مقابل الحصول على مزايا.
DANGEROUS لا يُسمح بالمساهمات المخالفة لسياستنا بشأن المحتوى الخطير. يروّج المحتوى الخطير لأفعال ضارّة أو يسهّل تنفيذها أو يشجّع عليها.
GIBBERISH_AND_REPETITIVE لا يُسمح بالمحتوى المخالف لسياستنا بشأن المحتوى غير الواضح أو المتكرّر. ويؤدي المحتوى غير الواضح أو المتكرّر إلى التغطية على المعلومات المفيدة التي يمكن للآخرين العثور عليها على Google.
REPETITIVE لا يُسمح بالمساهمات المخالفة لسياستنا بشأن المحتوى المتكرّر. يتضمن المحتوى المتكرّر المحتوى المتطابق أو المشابه الذي تمت إضافته عدة مرات من حساب واحد أو أكثر.
UNCLEAR لا يُسمح بالمحتوى المخالف لسياستنا بشأن المحتوى غير الواضح. يتضمن المحتوى غير الواضح أحرفًا عشوائية أو محتوى آخر ليس له أي معنى.
ILLEGAL لا يُسمح بالمساهمات المخالفة لسياستنا بشأن المحتوى غير القانوني.
OFF_TOPIC لا يُسمح بالمساهمات المخالفة لسياستنا بشأن المحتوى الخارج عن الموضوع. يشمل ذلك التعليقات العامة أو التعليقات حول مسائل سياسية أو اجتماعية والمناقشات الشخصية غير اللائقة.
OFFENSIVE لا يُسمح بالمساهمات المخالفة لسياستنا بشأن المحتوى المسيء. قد يتسبب المحتوى المسيء في شعور شخص آخر بالغضب الشديد أو الإهانة أو عدم الاحترام.
VIOLENCE_AND_GORE لا يُسمح بالمحتوى المخالف لسياستنا بشأن المحتوى العنيف والدموي. ويشمل المحتوى العنيف والدموي مشاهد متطرفة تعرض أشخاصًا أو حيوانات ويصوّر أعمال عنف واقعية أو دماء أو أجزاء من الجسم أو أحشاء.
CHILD_SAFETY لا يُسمح بالمساهمات المخالفة لسياستنا بشأن سلامة الأطفال. يشمل ذلك المساهمات التي تعرّض الأطفال للخطر أو تستغلّهم أو تسيء إليهم، أو التي تستخدم خدمات Google في تلك الأغراض.
HARASSMENT لا يُسمح بالمساهمات المخالفة لسياستنا بشأن التحرش. ويشمل ذلك المحتوى الذي ينطوي على تسلُّط أو تهديد أو استغلال جنسي أو يتسبب في خوف شخص معيّن على سلامته.
HATE_SPEECH لا يُسمح بالمساهمات المخالفة لسياستنا بشأن الكلام الذي يحض على الكراهية. ويشمل ذلك المحتوى الذي يحرّض على العنف أو التمييز أو الاستخفاف أو يتغاضى عنها أو الذي يحرّض على الكراهية على أساس سمات محميّة أو سمات أخرى مرتبطة بالتهميش أو التمييز الممنهجَين.
IMPERSONATION لا يُسمح بالمساهمات المخالفة لسياستنا بشأن انتحال الهوية. ويشمل ذلك انتحال هوية مزوّرة بهدف تضليل الآخرين أو الحصول على مزايا غير ملائمة.
MISINFORMATION لا يُسمح بالمساهمات المخالفة لسياستنا بشأن المعلومات الخاطئة. وتشمل المعلومات الخاطئة المعلومات غير الصحيحة أو غير الدقيقة التي قد تؤدي إلى إلحاق ضرر كبير بالأشخاص أو الأنشطة التجارية أو المجتمع.
MISREPRESENTATION لا يُسمح بالمساهمات المخالفة لسياستنا بشأن الوصف المضلِّل. ويشمل الوصف المضلِّل المعلومات المضلِّلة أو عدم ذكر التفاصيل المهمّة بغرض الحصول على مزايا غير ملائمة.
OBSCENITY_AND_PROFANITY لا يُسمح بالمساهمات المخالفة لسياستنا بشأن اللغة الفاحشة أو النابية. ويشمل ذلك الكلمات أو الإيماءات التي تُعتبر مسيئة أو بذيئة في المجتمع المحلي.
PERSONAL_INFO لا يُسمح بالمساهمات المخالفة لسياستنا بشأن المعلومات الشخصية. تشمل هذه المعلومات أي معلومات خاصة أو سرية، مثل معلومات بطاقة الدفع أو السجلّات الطبية أو مستندات التعريف الصادرة عن جهة حكومية، سواء كانت لك أو لشخص آخر.
REGULATED_GOODS_AND_SERVICES لا يُسمح بالمساهمات المخالفة لسياستنا بشأن السلع والخدمات الخاضعة للرقابة. ويشمل ذلك عرض عبارات تحث المستخدم على اتخاذ إجراء أو تقديم عروض لبيع منتجات أو خدمات تخضع للّوائح القانونية المحلية.
GENERIC_VANDALISM لا يُسمح بالمحتوى الذي ينتهك سياساتنا بشأن المحتوى المسيء أو المنخفض الجودة.
GENERIC_FRAUD لا يُسمح بالمحتوى الذي ينتهك سياساتنا بشأن المحتوى والسلوك المخادعَين. والمحتوى المخادع يضلِّل الآخرين أو يخدعهم عمدًا.
PHOTOS_AND_VIDEOS_CRITERIA لا يُسمح بالمساهمات غير المتوافقة مع معايير الصور والفيديوهات.
MODERATION_ERROR حدث خطأ أثناء معالجة المحتوى الخاص بك.
PRIVACY لا يُسمح بالمساهمات المخالفة لسياسة الخصوصية بشأن المحتوى الذي يساهم به المستخدمون على "خرائط Google".
GENERIC_VIOLATION إنّ المحتوى الخاص بك يخالف سياساتنا ولا يُسمح به.
GENERIC_QUALITY لا يُسمح بالمحتوى الذي ينتهك سياساتنا بشأن المحتوى المنخفض الجودة.
IDENTITY_CHANGE يختلف التغيير الذي أجريته كثيرًا عن النشاط التجاري الذي تم إنشاؤه. يشكّل ذلك انتهاكًا لسياستنا.
GEOGRAPHIC_LOCATION_CHANGE تشير إلى أنّ الموقع الجغرافي الفعلي (العنوان أو خطوط الطول والعرض) للنشاط التجاري قد تغيّر بشكل كبير منذ إنشاء الملف التجاري.

ReviewMediaItem

تمثّل هذه السمة وسائط (صورة أو فيديو) مرتبطة بمراجعة.

تمثيل JSON 
{
  "thumbnailUrl": string,
  "thumbnailLabel": string,
  "videoUrl": string
}
الحقول
thumbnailUrl

string

النتائج فقط. تمثّل هذه السمة عنوان URL الخاص بـ FIFE للصورة أو الصورة المصغّرة للفيديو إذا كانت السمة videoUrl متوفّرة.
thumbnailLabel

string

النتائج فقط. تمثّل هذه السمة التصنيف الذي يقدّمه المؤلّف لـ thumbnailUrl.
videoUrl

string

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

الطُرق

deleteReply

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

get

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

list

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

updateReply

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