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}}"

merchant Review Id

string

مورد نیاز. کاربر شناسه بازبینی تاجر را برای شناسایی منحصربه‌فرد بررسی تاجر ارائه کرده است.

attributes

object ( MerchantReviewAttributes )

اختیاری. فهرستی از ویژگی‌های بازبینی بازرگان.

custom Attributes[]

object ( CustomAttribute )

مورد نیاز. فهرستی از ویژگی های سفارشی (ارائه شده توسط بازرگان). همچنین می‌توان از آن برای ارسال هر ویژگی از مشخصات داده‌ها به شکل عمومی آن استفاده کرد (به عنوان مثال، { "name": "size type", "value": "regular" } ). این برای ارسال ویژگی‌هایی که به صراحت توسط API نشان داده نشده‌اند، مانند ویژگی‌های آزمایشی مفید است. حداکثر تعداد مجاز کاراکتر برای هر ویژگی سفارشی 10240 است (نماینده مجموع کاراکترها برای نام و مقدار). حداکثر 2500 ویژگی سفارشی را می توان برای هر محصول با حجم کل 102.4 کیلوبایت تنظیم کرد. زیرخط در نام ویژگی های سفارشی پس از درج با فاصله جایگزین می شود.

data Source

string

فقط خروجی منبع داده اولیه بررسی تاجر.

merchant Review Status

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
}
فیلدها
merchant Id

string

مورد نیاز. باید در تمام درخواست ها منحصر به فرد و پایدار باشد. به عبارت دیگر، اگر درخواستی امروز و 90 روز پیش دیگر به همان تاجر مراجعه کند، باید همان شناسه را داشته باشند.

merchant Display Name

string

اختیاری. نام نمایشی قابل خواندن توسط انسان برای تاجر.

min Rating

string ( int64 format)

اختیاری. حداقل تعداد ممکن برای رتبه بندی. این باید بدترین رتبه ممکن باشد و نباید ارزشی برای عدم رتبه بندی باشد.

max Rating

string ( int64 format)

اختیاری. حداکثر تعداد ممکن برای رتبه بندی. مقدار حداکثر رتبه‌بندی باید بیشتر از مقدار حداقل رتبه‌بندی باشد.

rating

number

اختیاری. رتبه بندی کلی بازبین از تاجر.

title

string

اختیاری. عنوان بررسی.

content

string

مورد نیاز. این باید هر متن آزاد ارائه شده توسط کاربر باشد و نباید کوتاه شود. اگر پاسخ‌های متعددی به سؤالات مختلف ارائه شود، همه پاسخ‌ها باید گنجانده شوند، با حداقل زمینه برای منطقی بودن پاسخ‌ها. اگر سؤالات بدون پاسخ رها شدند، نباید زمینه ارائه شود.

reviewer Id

string

اختیاری. یک شناسه دائمی و منحصر به فرد برای نویسنده نظر در سیستم ناشر.

reviewer Username

string

اختیاری. نام نمایشی نویسنده نظر.

is Anonymous

boolean

اختیاری. اگر بازبین ناشناس بماند، روی true تنظیم کنید.

collection Method

enum ( CollectionMethod )

اختیاری. روش مورد استفاده برای جمع آوری مرور.

review Time

string ( Timestamp format)

مورد نیاز. مُهر زمانی که نشان‌دهنده زمان نوشتن نقد است.

review Language

string

مورد نیاز. زبان بازبینی که توسط کد زبان BCP-47 تعریف شده است.

review Country

string

اختیاری. کشوری که در آن بازبینی کننده ترتیب تعریف شده توسط کد کشور آلفا-2 ISO 3166-1 را انجام داده است.

روش جمع آوری

روش مورد استفاده برای جمع آوری مرور.

Enums
COLLECTION_METHOD_UNSPECIFIED روش جمع آوری نامشخص است.
MERCHANT_UNSOLICITED کاربر هنگام ارسال بررسی به درخواست خاصی پاسخ نمی‌داد.
POINT_OF_SALE کاربر در پاسخ به درخواستی که کاربر سفارشی را ثبت کرد، بررسی را ارسال کرد.
AFTER_FULFILLMENT کاربر پس از انجام سفارش کاربر، نظر خود را در پاسخ به درخواست ارسال کرد.

MerchantReview Status

وضعیت بازبینی تاجر، مسائل مربوط به اعتبارسنجی داده‌ها، یعنی اطلاعات مربوط به بررسی بازرگان به‌صورت ناهمزمان محاسبه شده است.

نمایندگی JSON
{
  "destinationStatuses": [
    {
      object (MerchantReviewDestinationStatus)
    }
  ],
  "itemLevelIssues": [
    {
      object (MerchantReviewItemLevelIssue)
    }
  ],
  "createTime": string,
  "lastUpdateTime": string
}
فیلدها
destination Statuses[]

object ( MerchantReviewDestinationStatus )

فقط خروجی مقاصد مورد نظر برای بررسی تاجر.

item Level Issues[]

object ( MerchantReviewItemLevelIssue )

فقط خروجی فهرستی از تمام مشکلات مرتبط با بازبینی تاجر.

create Time

string ( Timestamp format)

فقط خروجی تاریخ ایجاد آیتم در قالب ISO 8601 .

last Update Time

string ( Timestamp format)

فقط خروجی تاریخ آخرین به روز رسانی مورد در قالب ISO 8601 .

MerchantReviewDestinationStatus

وضعیت مقصد وضعیت بازبینی تاجر.

نمایندگی JSON
{
  "reportingContext": enum (ReportingContextEnum)
}
فیلدها
reporting Context

enum ( ReportingContextEnum )

فقط خروجی نام زمینه گزارش.

MerchantReviewItemLevelIssue

ItemLevelIssue وضعیت بازبینی تاجر.

نمایندگی 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

فقط خروجی نام ویژگی، در صورتی که مشکل ناشی از یک ویژگی واحد باشد.

reporting Context

enum ( ReportingContextEnum )

فقط خروجی زمینه گزارش دهی که این مسئله در مورد آن اعمال می شود.

description

string

فقط خروجی شرح مختصر موضوع به زبان انگلیسی.

detail

string

فقط خروجی شرح مفصل موضوع به زبان انگلیسی.

documentation

string

فقط خروجی URL یک صفحه وب برای کمک به حل این مشکل.

شدت

این موضوع چگونه بر ارائه بازبینی تاجر تأثیر می‌گذارد.

Enums
SEVERITY_UNSPECIFIED مشخص نشده است.
NOT_IMPACTED این مسئله نشان دهنده یک هشدار است و تأثیر مستقیمی بر بازبینی تاجر ندارد.
DISAPPROVED مشکل بررسی تاجر را تأیید نمی کند.

روش ها

delete

بررسی فروشنده را حذف می کند.

get

یک بررسی تجاری دریافت می کند.

insert

نظری را برای حساب Merchant Center شما درج می کند.

list

نظرات بازرگان را فهرست می کند.