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

string

חובה. המזהה הקבוע והייחודי של הביקורת על המוצר במערכת של בעל התוכן הדיגיטלי.
attributes

object (ProductReviewAttributes)

זה שינוי אופציונלי. רשימה של מאפיינים של ביקורות על מוצרים.
customAttributes[]

object (CustomAttribute)

זה שינוי אופציונלי. רשימה של מאפיינים מותאמים אישית (שסופקו על ידי המוכר).
dataSource

string

פלט בלבד. מקור הנתונים הראשי של הביקורת על המוצר.
productReviewStatus

object (ProductReviewStatus)

פלט בלבד. הסטטוס של ביקורת על מוצר, בעיות באימות נתונים, כלומר מידע על ביקורת על מוצר שמחושב באופן אסינכרוני.

ProductReviewAttributes

מאפיינים.

ייצוג ב-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
}
שדות
reviewTime

string (Timestamp format)

חובה. חותמת הזמן שמציינת מתי הביקורת נכתבה.
pros[]

string

זה שינוי אופציונלי. כאן מפורטים היתרונות על סמך דעת הבודק. יש להשמיט טקסט סטנדרטי כמו "pro: ", אלא אם הוא נכתב על ידי כותב הביקורת.
cons[]

string

זה שינוי אופציונלי. כאן מפורטים החסרונות לפי דעת כותב הביקורת. מומלץ להשמיט טקסט סטנדרטי כמו 'con:‎', אלא אם הוא נכתב על ידי הבודק.
productNames[]

string

זה שינוי אופציונלי. שם תיאורי של מוצר.
asins[]

string

זה שינוי אופציונלי. מכיל מספרי ASIN (מספרים סטנדרטיים מזהים של Amazon) שמשויכים למוצר.
gtins[]

string

זה שינוי אופציונלי. מכיל מספרי GTIN (מספרים של פריטים מסחריים גלובליים) שמשויכים למוצר. יש תמיכה בסוגי משנה של GTIN (למשל, UPC,‏ EAN,‏ ISBN,‏ JAN).
mpns[]

string

זה שינוי אופציונלי. מכיל קודי MPN (מספרי חלק של יצרן) שמשויכים למוצר.
skus[]

string

זה שינוי אופציונלי. מכילה מק"טים (יחידות מלאי) שמשויכים למוצר. לרוב, המזהה הזה תואם למזהה המבצע של המוצר בפיד המוצרים.
brands[]

string

זה שינוי אופציונלי. מכיל שמות של מותגים שמשויכים למוצר.
collectionMethod

enum (CollectionMethod)

זה שינוי אופציונלי. השיטה שבה השתמשו כדי לאסוף את הביקורת.
transactionId

string

זה שינוי אופציונלי. מזהה ייחודי קבוע של העסקה המשויכת לביקורת במערכת של בעל התוכן הדיגיטלי. אפשר להשתמש במזהה הזה כדי לציין שכמה ביקורות משויכות לאותה עסקה.
aggregatorName

string

זה שינוי אופציונלי. השם של הכלי לאיסוף הביקורות על המוצרים.

בעלי תוכן דיגיטלי יכולים להשתמש באתר אגרגטור של ביקורות כדי לנהל את הביקורות ולספק את הפיד. הרכיב הזה מציין שימוש באגרגטור ומכיל מידע על האגרגטור.
subclientName

string

זה שינוי אופציונלי. השם של לקוח המשנה של הביקורות על המוצרים.

לקוח המשנה הוא מזהה של מקור הביקורות על המוצר. הוא צריך להיות זהה לספרייה שצוינה בנתיב של מקור נתוני הקובץ.
publisherName

string

זה שינוי אופציונלי. השם של בעל התוכן הדיגיטלי שמפרסם את הביקורות על המוצרים.

המידע על בעל התוכן הדיגיטלי, שיכול להיות קמעונאי, יצרן, חברת שירותי ביקורות או כל ישות שמפרסמת ביקורות על מוצרים.
publisherFavicon

string

זה שינוי אופציונלי. קישור לסמליל החברה של בעל התוכן הדיגיטלי. מידות התמונה צריכות להיות בגודל של סמל favicon: 16x16 פיקסלים. פורמט התמונה צריך להיות GIF, ‏ JPG או PNG.
reviewerId

string

זה שינוי אופציונלי. המחבר של הביקורת על המוצר.

מזהה ייחודי וקבוע של מחבר הביקורת במערכת של בעל התוכן הדיגיטלי.
reviewerIsAnonymous

boolean

זה שינוי אופציונלי. מגדירים את הערך כ-true אם כותב הביקורת צריך להישאר בעילום שם.
reviewerUsername

string

זה שינוי אופציונלי. השם של כותב הביקורת על המוצר.
reviewLanguage

string

זה שינוי אופציונלי. השפה של הביקורת, לפי קוד השפה BCP-47.
reviewCountry

string

זה שינוי אופציונלי. המדינה של הבדיקה, לפי קוד המדינה בפורמט ISO 3166-1 Alpha-2.
title

string

זה שינוי אופציונלי. כותרת הביקורת.
content

string

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

string (int64 format)

זה שינוי אופציונלי. מכיל את הדירוגים המשויכים לביקורת. המספר המינימלי האפשרי לדירוג. זה צריך להיות הדירוג הגרוע ביותר האפשרי, ולא יכול להיות ערך ללא דירוג.
maxRating

string (int64 format)

זה שינוי אופציונלי. המספר המקסימלי האפשרי לדירוג. הערך של הדירוג המקסימלי חייב להיות גדול מהערך של המאפיין המינימלי.
rating

number

זה שינוי אופציונלי. הדירוג הכולל של כותב הביקורת למוצר.
isSpam

boolean

זה שינוי אופציונלי. מציין אם הביקורת סומנה כספאם במערכת של בעל התוכן הדיגיטלי.

סוג

הסוג של ה-URI של הבדיקה.

טיפוסים בני מנייה (enum)
TYPE_UNSPECIFIED הסוג לא צוין.
SINGLETON דף הביקורות מכיל רק את הביקורת הזו.
GROUP דף הביקורות מכיל קבוצה של ביקורות, כולל הביקורת הזו.

CollectionMethod

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

טיפוסים בני מנייה (enum)
COLLECTION_METHOD_UNSPECIFIED שיטת האיסוף לא צוינה.
UNSOLICITED המשתמש לא השיב לבקשת תגובה ספציפית כששלח את הביקורת.
POST_FULFILLMENT המשתמש שלח את הביקורת בתגובה לבקשת תגובה לאחר שההזמנה שלו בוצעה.

ProductReviewStatus

סטטוס בדיקת המוצר.

ייצוג JSON 
{
  "destinationStatuses": [
    {
      object (ProductReviewDestinationStatus)
    }
  ],
  "itemLevelIssues": [
    {
      object (ProductReviewItemLevelIssue)
    }
  ],
  "createTime": string,
  "lastUpdateTime": string
}
שדות
destinationStatuses[]

object (ProductReviewDestinationStatus)

פלט בלבד. היעדים המיועדים של הביקורת על המוצר.
itemLevelIssues[]

object (ProductReviewItemLevelIssue)

פלט בלבד. רשימה של כל הבעיות שמשויכות לבדיקה של המוצר.
createTime

string (Timestamp format)

פלט בלבד. התאריך שבו הפריט נוצר, בפורמט ISO 8601.
lastUpdateTime

string (Timestamp format)

פלט בלבד. התאריך שבו הפריט עודכן לאחרונה, בפורמט ISO 8601.

ProductReviewDestinationStatus

סטטוס היעד של סטטוס בדיקת המוצר.

ייצוג ב-JSON 
{
  "reportingContext": enum (ReportingContextEnum)
}
שדות
reportingContext

enum (ReportingContextEnum)

פלט בלבד. השם של הקשר הדיווח.

ProductReviewItemLevelIssue

הבעיה ברמת הפריט בסטטוס בדיקת המוצר.

ייצוג ב-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

 הוספה של ביקורת על מוצר.

list

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