REST Resource: accounts.productReviews

منبع: ProductReview

بررسی یک محصول برای اطلاعات بیشتر، به مقدمه فیدهای بررسی محصول مراجعه کنید

نمایندگی JSON
{
  "name": string,
  "productReviewId": string,
  "attributes": {
    object (ProductReviewAttributes)
  },
  "customAttributes": [
    {
      object (CustomAttribute)
    }
  ],
  "dataSource": string,
  "productReviewStatus": {
    object (ProductReviewStatus)
  }
}
فیلدها
name

string

شناسه. نام بررسی محصول قالب: "{productreview.name=accounts/{account}/productReviews/{productReview}}"

product Review Id

string

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

attributes

object ( ProductReviewAttributes )

اختیاری. لیستی از ویژگی های بررسی محصول

custom Attributes[]

object ( CustomAttribute )

اختیاری. فهرستی از ویژگی های سفارشی (ارائه شده توسط بازرگان).

data Source

string

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

product Review Status

object ( ProductReviewStatus )

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

ProductReview Attributes

صفات.

نمایندگی JSON
{
  "reviewTime": string,
  "pros": [
    string
  ],
  "cons": [
    string
  ],
  "reviewLink": {
    object (ReviewLink)
  },
  "reviewerImageLinks": [
    string
  ],
  "productNames": [
    string
  ],
  "productLinks": [
    string
  ],
  "asins": [
    string
  ],
  "gtins": [
    string
  ],
  "mpns": [
    string
  ],
  "skus": [
    string
  ],
  "brands": [
    string
  ],
  "collectionMethod": enum (CollectionMethod),
  "transactionId": string,
  "aggregatorName": string,
  "subclientName": string,
  "publisherName": string,
  "publisherFavicon": string,
  "reviewerId": string,
  "reviewerIsAnonymous": boolean,
  "reviewerUsername": string,
  "reviewLanguage": string,
  "reviewCountry": string,
  "title": string,
  "content": string,
  "minRating": string,
  "maxRating": string,
  "rating": number,
  "isSpam": boolean
}
فیلدها
review Time

string ( Timestamp format)

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

pros[]

string

اختیاری. شامل مزایای بر اساس نظر داور است. متن boilerplate مانند "pro:" را حذف کنید، مگر اینکه توسط بازبین نوشته شده باشد.

cons[]

string

اختیاری. شامل معایب بر اساس نظر داور است. متن boilerplate مانند "con:" را حذف کنید، مگر اینکه توسط بازبین نوشته شده باشد.

product Names[]

string

اختیاری. نام توصیفی یک محصول

asins[]

string

اختیاری. حاوی ASIN (شماره‌های شناسایی استاندارد آمازون) مرتبط با یک محصول.

gtins[]

string

اختیاری. حاوی GTIN (شماره کالاهای تجاری جهانی) مرتبط با یک محصول. انواع فرعی GTIN (مانند UPC، EAN، ISBN، JAN) پشتیبانی می‌شوند.

mpns[]

string

اختیاری. حاوی MPN (شماره قطعه سازنده) مرتبط با یک محصول.

skus[]

string

اختیاری. حاوی SKU (واحد نگهداری سهام) مرتبط با یک محصول. اغلب این با شناسه پیشنهاد محصول در فید محصول مطابقت دارد.

brands[]

string

اختیاری. شامل نام های تجاری مرتبط با یک محصول است.

collection Method

enum ( CollectionMethod )

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

transaction Id

string

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

aggregator Name

string

اختیاری. نام تجمیع کننده نظرات محصول.

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

subclient Name

string

اختیاری. نام مشتری فرعی نظرات محصول.

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

publisher Name

string

اختیاری. نام ناشر نظرات محصول.

اطلاعات مربوط به ناشر، که ممکن است یک خرده فروش، سازنده، شرکت خدمات بازبینی یا هر نهادی باشد که نظرات محصول را منتشر می کند.

publisher Favicon

string

اختیاری. پیوندی به فاویکون شرکت ناشر. ابعاد تصویر باید اندازه فاویکون باشد: 16x16 پیکسل. فرمت تصویر باید GIF، JPG یا PNG باشد.

reviewer Id

string

اختیاری. نویسنده بررسی محصول

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

reviewer Is Anonymous

boolean

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

reviewer Username

string

اختیاری. نام بازبینی کننده بررسی محصول.

review Language

string

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

review Country

string

اختیاری. کشور بررسی تعریف شده توسط ISO 3166-1 Alpha-2 Code Country.

title

string

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

content

string

مورد نیاز. محتوای بررسی.

min Rating

string ( int64 format)

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

max Rating

string ( int64 format)

اختیاری. حداکثر تعداد ممکن برای رتبه بندی. مقدار حداکثر امتیاز باید بیشتر از مقدار ویژگی min باشد.

rating

number

اختیاری. امتیاز کلی بازبین از محصول.

is Spam

boolean

اختیاری. نشان می دهد که آیا بررسی به عنوان هرزنامه در سیستم ناشر علامت گذاری شده است یا خیر.

تایپ کنید

نوع URI بازبینی

Enums
TYPE_UNSPECIFIED تایپ نامشخص
SINGLETON صفحه بررسی فقط شامل همین بررسی است.
GROUP صفحه بررسی شامل گروهی از نظرات از جمله این بررسی است.

روش جمع آوری

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

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

وضعیت بررسی محصول

وضعیت بررسی محصول

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

object ( ProductReviewDestinationStatus )

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

item Level Issues[]

object ( ProductReviewItemLevelIssue )

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

create Time

string ( Timestamp format)

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

last Update Time

string ( Timestamp format)

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

ProductReviewDestinationStatus

وضعیت مقصد وضعیت بررسی محصول.

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

enum ( ReportingContextEnum )

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

ProductReviewItemLevelIssue

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 Issue بررسی محصول را تأیید نمی کند.

روش ها

delete

بررسی محصول را حذف می کند.

get

بررسی محصول را دریافت می کند.

insert

بررسی محصول را درج می کند.

list

بررسی های محصول را فهرست می کند.
،

منبع: ProductReview

بررسی یک محصول برای اطلاعات بیشتر، به مقدمه فیدهای بررسی محصول مراجعه کنید

نمایندگی JSON
{
  "name": string,
  "productReviewId": string,
  "attributes": {
    object (ProductReviewAttributes)
  },
  "customAttributes": [
    {
      object (CustomAttribute)
    }
  ],
  "dataSource": string,
  "productReviewStatus": {
    object (ProductReviewStatus)
  }
}
فیلدها
name

string

شناسه. نام بررسی محصول قالب: "{productreview.name=accounts/{account}/productReviews/{productReview}}"

product Review Id

string

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

attributes

object ( ProductReviewAttributes )

اختیاری. لیستی از ویژگی های بررسی محصول

custom Attributes[]

object ( CustomAttribute )

اختیاری. فهرستی از ویژگی های سفارشی (ارائه شده توسط بازرگان).

data Source

string

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

product Review Status

object ( ProductReviewStatus )

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

ProductReview Attributes

صفات.

نمایندگی JSON
{
  "reviewTime": string,
  "pros": [
    string
  ],
  "cons": [
    string
  ],
  "reviewLink": {
    object (ReviewLink)
  },
  "reviewerImageLinks": [
    string
  ],
  "productNames": [
    string
  ],
  "productLinks": [
    string
  ],
  "asins": [
    string
  ],
  "gtins": [
    string
  ],
  "mpns": [
    string
  ],
  "skus": [
    string
  ],
  "brands": [
    string
  ],
  "collectionMethod": enum (CollectionMethod),
  "transactionId": string,
  "aggregatorName": string,
  "subclientName": string,
  "publisherName": string,
  "publisherFavicon": string,
  "reviewerId": string,
  "reviewerIsAnonymous": boolean,
  "reviewerUsername": string,
  "reviewLanguage": string,
  "reviewCountry": string,
  "title": string,
  "content": string,
  "minRating": string,
  "maxRating": string,
  "rating": number,
  "isSpam": boolean
}
فیلدها
review Time

string ( Timestamp format)

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

pros[]

string

اختیاری. شامل مزایای بر اساس نظر داور است. متن boilerplate مانند "pro:" را حذف کنید، مگر اینکه توسط بازبین نوشته شده باشد.

cons[]

string

اختیاری. شامل معایب بر اساس نظر داور است. متن boilerplate مانند "con:" را حذف کنید، مگر اینکه توسط بازبین نوشته شده باشد.

product Names[]

string

اختیاری. نام توصیفی یک محصول

asins[]

string

اختیاری. حاوی ASIN (شماره‌های شناسایی استاندارد آمازون) مرتبط با یک محصول.

gtins[]

string

اختیاری. حاوی GTIN (شماره کالاهای تجاری جهانی) مرتبط با یک محصول. انواع فرعی GTIN (مانند UPC، EAN، ISBN، JAN) پشتیبانی می‌شوند.

mpns[]

string

اختیاری. حاوی MPN (شماره قطعه سازنده) مرتبط با یک محصول.

skus[]

string

اختیاری. حاوی SKU (واحد نگهداری سهام) مرتبط با یک محصول. اغلب این با شناسه پیشنهاد محصول در فید محصول مطابقت دارد.

brands[]

string

اختیاری. شامل نام های تجاری مرتبط با یک محصول است.

collection Method

enum ( CollectionMethod )

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

transaction Id

string

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

aggregator Name

string

اختیاری. نام تجمیع کننده نظرات محصول.

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

subclient Name

string

اختیاری. نام مشتری فرعی نظرات محصول.

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

publisher Name

string

اختیاری. نام ناشر نظرات محصول.

اطلاعات مربوط به ناشر، که ممکن است یک خرده فروش، سازنده، شرکت خدمات بازبینی یا هر نهادی باشد که نظرات محصول را منتشر می کند.

publisher Favicon

string

اختیاری. پیوندی به فاویکون شرکت ناشر. ابعاد تصویر باید اندازه فاویکون باشد: 16x16 پیکسل. فرمت تصویر باید GIF، JPG یا PNG باشد.

reviewer Id

string

اختیاری. نویسنده بررسی محصول

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

reviewer Is Anonymous

boolean

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

reviewer Username

string

اختیاری. نام بازبینی کننده بررسی محصول.

review Language

string

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

review Country

string

اختیاری. کشور بررسی تعریف شده توسط ISO 3166-1 Alpha-2 Code Country.

title

string

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

content

string

مورد نیاز. محتوای بررسی.

min Rating

string ( int64 format)

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

max Rating

string ( int64 format)

اختیاری. حداکثر تعداد ممکن برای رتبه بندی. مقدار حداکثر امتیاز باید بیشتر از مقدار ویژگی min باشد.

rating

number

اختیاری. امتیاز کلی بازبین از محصول.

is Spam

boolean

اختیاری. نشان می دهد که آیا بررسی به عنوان هرزنامه در سیستم ناشر علامت گذاری شده است یا خیر.

تایپ کنید

نوع URI بازبینی

Enums
TYPE_UNSPECIFIED تایپ نامشخص
SINGLETON صفحه بررسی فقط شامل همین بررسی است.
GROUP صفحه بررسی شامل گروهی از نظرات از جمله این بررسی است.

روش جمع آوری

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

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

وضعیت بررسی محصول

وضعیت بررسی محصول

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

object ( ProductReviewDestinationStatus )

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

item Level Issues[]

object ( ProductReviewItemLevelIssue )

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

create Time

string ( Timestamp format)

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

last Update Time

string ( Timestamp format)

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

ProductReviewDestinationStatus

وضعیت مقصد وضعیت بررسی محصول.

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

enum ( ReportingContextEnum )

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

ProductReviewItemLevelIssue

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 Issue بررسی محصول را تأیید نمی کند.

روش ها

delete

بررسی محصول را حذف می کند.

get

بررسی محصول را دریافت می کند.

insert

بررسی محصول را درج می کند.

list

بررسی های محصول را فهرست می کند.