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" }). האפשרות הזו שימושית לשליחת מאפיינים שלא נחשפו במפורש על ידי ה-API, כמו מאפיינים ניסיוניים. מספר התווים המקסימלי לכל מאפיין מותאם אישית הוא 10240 (המספר הכולל של תווים הוא השם והערך). אפשר להגדיר עד 2,500 מאפיינים מותאמים אישית לכל מוצר, בגודל כולל של 102.4KB. אחרי ההוספה, קווים תחתונים בשמות של מאפיינים מותאמים אישית יוחלפו ברווחים.
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

השיטה ששימשה לאיסוף הביקורת.

טיפוסים בני מנייה (enum)
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

רמת 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

פלט בלבד. שם המאפיין, אם הבעיה נגרמת על ידי מאפיין יחיד.
reportingContext

enum (ReportingContextEnum)

פלט בלבד. ההקשר של הדיווח שאליו הבעיה רלוונטית.
description

string

פלט בלבד. תיאור קצר של הבעיה באנגלית.
detail

string

פלט בלבד. תיאור מפורט של הבעיה באנגלית.
documentation

string

פלט בלבד. כתובת ה-URL של דף אינטרנט שיעזור לנו לפתור את הבעיה.

מידת החומרה

איך הבעיה משפיעה על הצגת הביקורת על המוכר.

טיפוסים בני מנייה (enum)
SEVERITY_UNSPECIFIED לא צוין.
NOT_IMPACTED הבעיה הזו מייצגת אזהרה ואין לה השפעה ישירה על בדיקת המוכר.
DISAPPROVED הבעיה גורמת לדחיית הביקורת על המוכר.

שיטות

delete

 מחיקת הביקורת של המוכר.

get

 מקבל ביקורת על מוכר.

insert

 הוספת בדיקה לחשבון Merchant Center.

list

 הצגת ביקורות על מוכרים.