REST Resource: accounts.merchantReviews

المرجع: MerchantReview

مراجعة للتاجر للمزيد من المعلومات، يمكنك الاطّلاع على المقالة مقدّمة حول خلاصات مراجعات التجار.

تمثيل JSON 
{
  "name": string,
  "merchantReviewId": string,
  "attributes": {
    object (MerchantReviewAttributes)
  },
  "customAttributes": [
    {
      object (CustomAttribute)
    }
  ],
  "dataSource": string,
  "merchantReviewStatus": {
    object (MerchantReviewStatus)
  }
}
الحقول
name

string

المعرّف اسم مراجعة التاجر. التنسيق: "{merchantreview.name=accounts/{account}/merchantReviews/{merchantReview}}"
merchantReviewId

string

مطلوب. قدّم المستخدم معرّف مراجعة التاجر لتحديد مراجعة التاجر بشكل فريد.
attributes

object (MerchantReviewAttributes)

اختياريّ. قائمة بسمات مراجعات التجار
customAttributes[]

object (CustomAttribute)

مطلوب. قائمة بالسمات المخصّصة (التي يقدّمها التاجر) ويمكن استخدامها أيضًا لإرسال أي سمة لمواصفات البيانات في شكلها العام (على سبيل المثال، { "name": "size type", "value": "regular" }). وهو مفيد لإرسال السمات التي لم تعرضها واجهة برمجة التطبيقات بشكل صريح، مثل السمات التجريبية. الحدّ الأقصى المسموح به لعدد الأحرف لكلّ سمة مخصّصة هو 10240 (يمثّل مجموع أحرف الاسم والقيمة). يمكن ضبط 2, 500 سمة مخصّصة كحدّ أقصى لكل منتج، ويبلغ إجمالي حجمها 102.4 كيلوبايت. عند إدراج أسماء السمات المخصّصة، يتم استبدال الشرطة السفلية بمسافات.
dataSource

string

النتائج فقط. مصدر البيانات الأساسي لمراجعة التاجر.
merchantReviewStatus

object (MerchantReviewStatus)

النتائج فقط. حالة مراجعة التاجر، ومشاكل التحقّق من صحة البيانات، أي معلومات حول مراجعة تاجر محسوبة بشكل غير متزامن.

MerchantReviewAttributes

السمات

تمثيل JSON 
{
  "merchantId": string,
  "merchantDisplayName": string,
  "merchantLink": string,
  "merchantRatingLink": string,
  "minRating": string,
  "maxRating": string,
  "rating": number,
  "title": string,
  "content": string,
  "reviewerId": string,
  "reviewerUsername": string,
  "isAnonymous": boolean,
  "collectionMethod": enum (CollectionMethod),
  "reviewTime": string,
  "reviewLanguage": string,
  "reviewCountry": string
}
الحقول
merchantId

string

مطلوب. يجب أن تكون فريدة وثابتة في جميع الطلبات. بعبارة أخرى، إذا كان هناك طلب اليوم وطلب آخر قبل 90 يومًا يشيران إلى التاجر نفسه، يجب أن يكون لهما المعرّف نفسه.
merchantDisplayName

string

اختياريّ. الاسم المعروض للتاجر والذي يمكن للمستخدمين قراءته
minRating

string (int64 format)

اختياريّ. الحد الأدنى لعدد التقييمات يجب أن يكون هذا أسوأ تقييم ممكن، ويجب ألا يكون قيمة لعدم التقييم.
maxRating

string (int64 format)

اختياريّ. الحد الأقصى لعدد التقييمات يجب أن تكون قيمة الحد الأقصى للتقييم أكبر من قيمة الحد الأدنى للتقييم.
rating

number

اختياريّ. تمثّل هذه السمة التقييم العام للتاجر الذي قدّمه المُراجع.
title

string

اختياريّ. تمثّل هذه السمة عنوان المراجعة.
content

string

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

string

اختياريّ. معرّف دائم وفريد لكاتب المراجعة في نظام الناشر
reviewerUsername

string

اختياريّ. الاسم المعروض لمؤلف المراجعة.
isAnonymous

boolean

اختياريّ. اضبط القيمة على true إذا كان يجب إخفاء هوية المُراجع.
collectionMethod

enum (CollectionMethod)

اختياريّ. تمثّل هذه السمة الطريقة المستخدمة لجمع المراجعة.
reviewTime

string (Timestamp format)

مطلوب. الطابع الزمني الذي يشير إلى وقت كتابة المراجعة
reviewLanguage

string

مطلوب. لغة المراجعة المحدّدة حسب رمز اللغة BCP-47
reviewCountry

string

اختياريّ. البلد الذي قدّم فيه المراجع الطلب، وفقًا لرمز البلد وفقًا لمعيار ISO 3166-1 Alpha-2

CollectionMethod

الطريقة المستخدَمة لجمع المراجعة

عمليات التعداد
COLLECTION_METHOD_UNSPECIFIED طريقة الجمع غير محددة.
MERCHANT_UNSOLICITED لم يكن المستخدم يردّ على طلب معيّن عند إرسال المراجعة.
POINT_OF_SALE أرسل المستخدم المراجعة استجابةً لطلب عندما قدّم طلبًا.
AFTER_FULFILLMENT أرسل المستخدم المراجعة استجابةً لطلب بعد تنفيذ طلبه.

MerchantReviewStatus

حالة مراجعة التاجر، ومشاكل التحقّق من البيانات، أي معلومات عن مراجعة التاجر التي يتم احتسابها بشكل غير متزامن

تمثيل JSON 
{
  "destinationStatuses": [
    {
      object (MerchantReviewDestinationStatus)
    }
  ],
  "itemLevelIssues": [
    {
      object (MerchantReviewItemLevelIssue)
    }
  ],
  "createTime": string,
  "lastUpdateTime": string
}
الحقول
destinationStatuses[]

object (MerchantReviewDestinationStatus)

النتائج فقط. الوجهات المقصودة لمراجعة التاجر
itemLevelIssues[]

object (MerchantReviewItemLevelIssue)

النتائج فقط. قائمة بكل المشاكل المرتبطة بمراجعة التاجر
createTime

string (Timestamp format)

النتائج فقط. تاريخ إنشاء العنصر، بتنسيق ISO 8601
lastUpdateTime

string (Timestamp format)

النتائج فقط. تاريخ آخر تعديل على العنصر، بتنسيق ISO 8601

MerchantReviewDestinationStatus

حالة الوجهة لحالة مراجعة التاجر.

تمثيل JSON 
{
  "reportingContext": enum (ReportingContextEnum)
}
الحقول
reportingContext

enum (ReportingContextEnum)

النتائج فقط. اسم سياق الإبلاغ

MerchantReviewItemLevelIssue

تمثّل هذه السمة السمة Itemlevelالمشكلة المتعلقة بحالة مراجعة التاجر.

تمثيل JSON 
{
  "code": string,
  "severity": enum (Severity),
  "resolution": string,
  "attribute": string,
  "reportingContext": enum (ReportingContextEnum),
  "description": string,
  "detail": string,
  "documentation": string
}
الحقول
code

string

النتائج فقط. رمز الخطأ للمشكلة.
severity

enum (Severity)

النتائج فقط. كيفية تأثير هذه المشكلة في عرض مراجعة التاجر
resolution

string

النتائج فقط. ما إذا كان بإمكان التاجر حلّ المشكلة
attribute

string

النتائج فقط. اسم السمة، إذا كانت المشكلة ناتجة عن سمة واحدة.
reportingContext

enum (ReportingContextEnum)

النتائج فقط. سياق إعداد التقارير الذي تنطبق عليه المشكلة.
description

string

النتائج فقط. وصف موجز للمشكلة باللغة الإنجليزية
detail

string

النتائج فقط. وصف مفصل للمشكلة باللغة الإنجليزية.
documentation

string

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

درجة الخطورة

كيفية تأثير المشكلة في عرض مراجعة التاجر

عمليات التعداد
SEVERITY_UNSPECIFIED غير محدّد
NOT_IMPACTED تشير هذه المشكلة إلى تحذير وليس لها تأثير مباشر على مراجعة التاجر.
DISAPPROVED تؤدي المشكلة إلى رفض مراجعة التاجر.

الطُرق

delete

 يتم حذف مراجعة التاجر.

get

 تلقّي مراجعة من التاجر

insert

 إدراج مراجعة لحسابك على Merchant Center

list

 يعرض مراجعات التجار.