Package google.shopping.merchant.reviews.v1beta

شاخص

MerchantReviewsService

خدماتی برای مدیریت نظرات بازرگانان.

حذف MerchantReview

rpc DeleteMerchantReview( DeleteMerchantReviewRequest ) returns ( Empty )

بررسی بازرگان را حذف می کند.

محدوده مجوز

به محدوده OAuth زیر نیاز دارد:

  • https://www.googleapis.com/auth/content

برای اطلاعات بیشتر، به نمای کلی OAuth 2.0 مراجعه کنید.

GetMerchantReview

rpc GetMerchantReview( GetMerchantReviewRequest ) returns ( MerchantReview )

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

محدوده مجوز

به محدوده OAuth زیر نیاز دارد:

  • https://www.googleapis.com/auth/content

برای اطلاعات بیشتر، به نمای کلی OAuth 2.0 مراجعه کنید.

InsertMerchantReview

rpc InsertMerchantReview( InsertMerchantReviewRequest ) returns ( MerchantReview )

نظری را برای حساب Merchant Center شما درج می کند. اگر بازبینی از قبل وجود داشته باشد، بررسی با نمونه جدید جایگزین می‌شود.

محدوده مجوز

به محدوده OAuth زیر نیاز دارد:

  • https://www.googleapis.com/auth/content

برای اطلاعات بیشتر، به نمای کلی OAuth 2.0 مراجعه کنید.

ListMerchantReviews

rpc ListMerchantReviews( ListMerchantReviewsRequest ) returns ( ListMerchantReviewsResponse )

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

محدوده مجوز

به محدوده OAuth زیر نیاز دارد:

  • https://www.googleapis.com/auth/content

برای اطلاعات بیشتر، به نمای کلی OAuth 2.0 مراجعه کنید.

Product Reviews Service

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

DeleteProductReview

rpc DeleteProductReview( DeleteProductReviewRequest ) returns ( Empty )

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

محدوده مجوز

به محدوده OAuth زیر نیاز دارد:

  • https://www.googleapis.com/auth/content

برای اطلاعات بیشتر، به نمای کلی OAuth 2.0 مراجعه کنید.

GetProductReview

rpc GetProductReview( GetProductReviewRequest ) returns ( ProductReview )

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

محدوده مجوز

به محدوده OAuth زیر نیاز دارد:

  • https://www.googleapis.com/auth/content

برای اطلاعات بیشتر، به نمای کلی OAuth 2.0 مراجعه کنید.

InsertProductReview

rpc InsertProductReview( InsertProductReviewRequest ) returns ( ProductReview )

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

محدوده مجوز

به محدوده OAuth زیر نیاز دارد:

  • https://www.googleapis.com/auth/content

برای اطلاعات بیشتر، به نمای کلی OAuth 2.0 مراجعه کنید.

ListProductReviews

rpc ListProductReviews( ListProductReviewsRequest ) returns ( ListProductReviewsResponse )

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

محدوده مجوز

به محدوده OAuth زیر نیاز دارد:

  • https://www.googleapis.com/auth/content

برای اطلاعات بیشتر، به نمای کلی OAuth 2.0 مراجعه کنید.

DeleteMerchantReviewRequest

درخواست پیام برای روش DeleteMerchantReview .

فیلدها
name

string

مورد نیاز. شناسه بازبینی تاجر. قالب: حساب‌ها/{حساب}/merchantReviews/{merchantReview}

DeleteProductReviewRequest

درخواست پیام برای روش DeleteProductReview .

فیلدها
name

string

مورد نیاز. شناسه بررسی محصول. قالب: حساب‌ها/{account}/productReviews/{productReview}

GetMerchantReviewRequest

درخواست پیام برای روش GetMerchantReview .

فیلدها
name

string

مورد نیاز. شناسه بازبینی تاجر. قالب: حساب‌ها/{حساب}/merchantReviews/{merchantReview}

GetProductReviewRequest

درخواست پیام برای روش GetProductReview.

فیلدها
name

string

مورد نیاز. شناسه بازبینی تاجر. قالب: حساب‌ها/{account}/productReviews/{productReview}

InsertMerchantReviewRequest

درخواست پیام برای روش InsertMerchantReview .

فیلدها
parent

string

مورد نیاز. حسابی که نظر تاجر در آن درج خواهد شد. قالب: حساب‌ها/{حساب}

merchant_ review

MerchantReview

مورد نیاز. نظر تاجر برای درج.

data_ source

string

مورد نیاز. منبع داده فرمت merchantreview : accounts/{account}/dataSources/{datasource} .

InsertProductReviewRequest

درخواست پیام برای روش InsertProductReview .

فیلدها
parent

string

مورد نیاز. حسابی که بررسی محصول در آن درج خواهد شد. قالب: حساب‌ها/{حساب}

product_ review

ProductReview

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

data_ source

string

مورد نیاز. قالب: accounts/{account}/dataSources/{datasource} .

ListMerchantReviewsRequest

درخواست پیام برای روش ListMerchantsReview .

فیلدها
parent

string

مورد نیاز. حسابی که باید نظرات بازرگان را فهرست کند. قالب: حساب‌ها/{حساب}

page_ size

int32

اختیاری. حداکثر تعداد نظرات بازرگان برای بازگشت. این سرویس می تواند کمتر از این مقدار را برگرداند. حداکثر مقدار 1000 است. مقادیر بالای 1000 به 1000 تبدیل می شوند. اگر مشخص نباشد، حداکثر تعداد بازبینی ها برگردانده می شود.

page_ token

string

اختیاری. یک نشانه صفحه، دریافت شده از تماس قبلی ListMerchantReviews . این را برای بازیابی صفحه بعدی ارائه کنید.

هنگام صفحه بندی، تمام پارامترهای دیگر ارائه شده به ListMerchantReviews باید با فراخوانی که نشانه صفحه را ارائه می کند مطابقت داشته باشد.

ListMerchantReviewsResponse

پیام پاسخ برای روش ListMerchantsReview .

فیلدها
merchant_ reviews[]

MerchantReview

بررسی تاجر.

next_ page_ token

string

نشانه برای بازیابی صفحه بعدی نتایج.

ListProductReviewsRequest

درخواست پیام برای متد ListProductReviews.

فیلدها
parent

string

مورد نیاز. حسابی که باید نظرات محصول را فهرست کند. قالب: حساب‌ها/{حساب}

page_ size

int32

اختیاری. حداکثر تعداد محصولات برای بازگشت. این سرویس ممکن است کمتر از این مقدار را بازگرداند.

page_ token

string

اختیاری. یک نشانه صفحه، دریافت شده از تماس قبلی ListProductReviews . این را برای بازیابی صفحه بعدی ارائه کنید.

هنگام صفحه بندی، تمام پارامترهای دیگر ارائه شده به ListProductReviews باید با فراخوانی که توکن صفحه را ارائه می کند مطابقت داشته باشد.

ListProductReviewsResponse

پیام پاسخ برای روش ListProductReviews.

فیلدها
product_ reviews[]

ProductReview

بررسی محصول

next_ page_ token

string

یک نشانه، که می تواند به عنوان page_token برای بازیابی صفحه بعدی ارسال شود. اگر این قسمت حذف شود، هیچ صفحه بعدی وجود ندارد.

MerchantReview

نقدی برای یک تاجر برای اطلاعات بیشتر، به مقدمه فیدهای بازبینی بازرگان مراجعه کنید

فیلدها
name

string

شناسه. نام بررسی تاجر. قالب: "{merchantreview.name=accounts/{account}/merchantReviews/{merchantReview}}"

merchant_ review_ id

string

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

attributes

MerchantReviewAttributes

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

custom_ attributes[]

CustomAttribute

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

data_ source

string

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

merchant_ review_ status

MerchantReviewStatus

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

MerchantReviewAttributes

صفات.

فیلدها
merchant_ id

string

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

merchant_ display_ name

string

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

min_ rating

int64

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

max_ rating

int64

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

rating

double

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

title

string

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

content

string

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

reviewer_ id

string

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

reviewer_ username

string

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

is_ anonymous

bool

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

collection_ method

CollectionMethod

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

review_ time

Timestamp

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

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

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

فیلدها
destination_ statuses[]

MerchantReviewDestinationStatus

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

item_ level_ issues[]

MerchantReviewItemLevelIssue

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

create_ time

Timestamp

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

last_ update_ time

Timestamp

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

MerchantReviewDestinationStatus

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

فیلدها
reporting_ context

ReportingContextEnum

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

MerchantReviewItemLevelIssue

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

فیلدها
code

string

فقط خروجی کد خطای مشکل

severity

Severity

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

resolution

string

فقط خروجی اینکه آیا این موضوع توسط تاجر قابل حل است یا خیر.

attribute

string

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

reporting_ context

ReportingContextEnum

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

description

string

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

detail

string

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

documentation

string

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

شدت

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

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

بررسی محصول

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

فیلدها
name

string

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

product_ review_ id

string

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

attributes

ProductReviewAttributes

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

custom_ attributes[]

CustomAttribute

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

data_ source

string

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

product_ review_ status

ProductReviewStatus

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

ProductReview Attributes

صفات.

فیلدها
review_ time

Timestamp

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

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

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

bool

اختیاری. اگر بازبین ناشناس بماند، روی 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

int64

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

max_ rating

int64

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

rating

double

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

is_ spam

bool

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

روش جمع آوری

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

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

تایپ کنید

نوع URI بازبینی

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

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

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

فیلدها
destination_ statuses[]

ProductReviewDestinationStatus

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

item_ level_ issues[]

ProductReviewItemLevelIssue

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

create_ time

Timestamp

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

last_ update_ time

Timestamp

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

ProductReviewDestinationStatus

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

فیلدها
reporting_ context

ReportingContextEnum

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

ProductReviewItemLevelIssue

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

فیلدها
code

string

فقط خروجی کد خطای مشکل

severity

Severity

فقط خروجی چگونه این موضوع بر ارائه بررسی محصول تأثیر می گذارد.

resolution

string

فقط خروجی اینکه آیا این موضوع توسط تاجر قابل حل است یا خیر.

attribute

string

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

reporting_ context

ReportingContextEnum

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

description

string

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

detail

string

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

documentation

string

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

شدت

این مسئله چگونه بر ارائه بررسی محصول تأثیر می گذارد.

Enums
SEVERITY_UNSPECIFIED مشخص نشده است.
NOT_IMPACTED این موضوع یک هشدار است و تأثیر مستقیمی بر بررسی محصول ندارد.
DISAPPROVED Issue بررسی محصول را تأیید نمی کند.