אינדקס
MerchantReviewsService
(ממשק)ProductReviewsService
(ממשק)DeleteMerchantReviewRequest
(הודעה)DeleteProductReviewRequest
(הודעה)GetMerchantReviewRequest
(הודעה)GetProductReviewRequest
(הודעה)InsertMerchantReviewRequest
(הודעה)InsertProductReviewRequest
(הודעה)ListMerchantReviewsRequest
(הודעה)ListMerchantReviewsResponse
(הודעה)ListProductReviewsRequest
(הודעה)ListProductReviewsResponse
(הודעה)MerchantReview
(הודעה)MerchantReviewAttributes
(הודעה)MerchantReviewAttributes.CollectionMethod
(enum)MerchantReviewStatus
(הודעה)MerchantReviewStatus.MerchantReviewDestinationStatus
(הודעה)MerchantReviewStatus.MerchantReviewItemLevelIssue
(הודעה)MerchantReviewStatus.MerchantReviewItemLevelIssue.Severity
(enum)ProductReview
(הודעה)ProductReviewAttributes
(הודעה)ProductReviewAttributes.CollectionMethod
(enum)ProductReviewAttributes.ReviewLink
(הודעה)ProductReviewAttributes.ReviewLink.Type
(enum)ProductReviewStatus
(הודעה)ProductReviewStatus.ProductReviewDestinationStatus
(הודעה)ProductReviewStatus.ProductReviewItemLevelIssue
(הודעה)ProductReviewStatus.ProductReviewItemLevelIssue.Severity
(enum)
MerchantReviewsService
שירות לניהול ביקורות על מוכרים.
DeleteMerchantReview |
---|
מחיקת ביקורת על מוכר.
|
GetMerchantReview |
---|
מקבל ביקורת על מוכר.
|
InsertMerchantReview |
---|
הוספת בדיקה לחשבון Merchant Center. אם הבדיקה כבר קיימת, היא מוחלפת במופע החדש.
|
ListMerchantReviews |
---|
הצגת ביקורות על מוכרים.
|
ProductReviewsService
שירות לניהול ביקורות על מוצרים.
DeleteProductReview |
---|
מחיקת ביקורת על מוצר.
|
GetProductReview |
---|
הפונקציה מקבלת ביקורת על מוצר.
|
InsertProductReview |
---|
הוספה של ביקורת על מוצר.
|
ListProductReviews |
---|
רשימת ביקורות על מוצרים.
|
DeleteMerchantReviewRequest
הודעת הבקשה של השיטה DeleteMerchantReview
.
שדות | |
---|---|
name |
חובה. המזהה של הביקורת על המוכר. פורמט: accounts/{account}/merchantReviews/{merchantReview} |
DeleteProductReviewRequest
הודעת הבקשה של השיטה DeleteProductReview
.
שדות | |
---|---|
name |
חובה. המזהה של הביקורת על המוצר. פורמט: accounts/{account}/productReviews/{productReview} |
GetMerchantReviewRequest
הודעת הבקשה של השיטה GetMerchantReview
.
שדות | |
---|---|
name |
חובה. המזהה של הביקורת על המוכר. פורמט: accounts/{account}/merchantReviews/{merchantReview} |
GetProductReviewRequest
הודעת הבקשה לשיטה GetProductReview.
שדות | |
---|---|
name |
חובה. המזהה של הביקורת על המוכר. פורמט: accounts/{account}/productReviews/{productReview} |
InsertMerchantReviewRequest
הודעת הבקשה של השיטה InsertMerchantReview
.
שדות | |
---|---|
parent |
חובה. החשבון שאליו תתווסף הביקורת על המוכר. פורמט: accounts/{account} |
merchant_ |
חובה. הביקורת על המוכר שרוצים להוסיף. |
data_ |
חובה. מקור הנתונים של הפורמט merchantreview: |
InsertProductReviewRequest
הודעת הבקשה של השיטה InsertProductReview
.
שדות | |
---|---|
parent |
חובה. החשבון שאליו תתווסף הביקורת על המוצר. פורמט: accounts/{account} |
product_ |
חובה. הביקורת על המוצר שרוצים להוסיף. |
data_ |
חובה. פורמט: |
ListMerchantReviewsRequest
הודעת הבקשה של השיטה ListMerchantsReview
.
שדות | |
---|---|
parent |
חובה. החשבון שבו רוצים להציג ביקורות על מוכרים. פורמט: accounts/{account} |
page_ |
אופציונלי. המספר המקסימלי של ביקורות על מוכרים שיוחזר. השירות יכול להחזיר פחות מהערך הזה. הערך המקסימלי הוא 1,000. ערכים מעל 1,000 מוגדרים כ-1,000. אם לא מצוין, יוצג המספר המקסימלי של הביקורות. |
page_ |
אופציונלי. אסימון דף, שהתקבל משיחה קודמת של כשמחלקים את הדפים, כל הפרמטרים האחרים שסופקו ל- |
ListMerchantReviewsResponse
הודעת התגובה של השיטה ListMerchantsReview
.
שדות | |
---|---|
merchant_ |
הביקורת על המוֹכר. |
next_ |
האסימון לאחזור של דף התוצאות הבא. |
ListProductReviewsRequest
הודעת הבקשה של שיטת ListProductReviews.
שדות | |
---|---|
parent |
חובה. החשבון שבו רוצים להציג את הביקורות על המוצרים. פורמט: accounts/{account} |
page_ |
אופציונלי. המספר המקסימלי של מוצרים להחזרה. יכול להיות שהשירות יחזיר פחות מהערך הזה. |
page_ |
אופציונלי. אסימון דף, שהתקבל משיחה קודמת של כשמחלקים את הדפים, כל הפרמטרים האחרים שסופקו ל- |
ListProductReviewsResponse
הודעת התגובה של השיטה ListProductReviews.
שדות | |
---|---|
product_ |
הביקורת על המוצר. |
next_ |
אסימון שאפשר לשלוח כ- |
MerchantReview
ביקורת על מוכר. מידע נוסף זמין במאמר מבוא לפידים של ביקורות על מוצרים של מוכרים
שדות | |
---|---|
name |
מזהה. השם של הביקורת על המוכר. פורמט: |
merchant_ |
חובה. המשתמש סיפק את מזהה הביקורת של המוכר כדי לזהות באופן ייחודי את הביקורת של המוכר. |
attributes |
אופציונלי. רשימה של מאפיינים של ביקורות על מוכרים. |
custom_ |
חובה. רשימה של מאפיינים מותאמים אישית (שסופקו על ידי המוכר). אפשר להשתמש בו גם כדי לשלוח כל מאפיין של מפרט הנתונים בצורתו הגנרית (לדוגמה, |
data_ |
פלט בלבד. מקור הנתונים הראשי של הביקורת על המוכר. |
merchant_ |
פלט בלבד. הסטטוס של בדיקת המוכר, בעיות באימות הנתונים, כלומר מידע על בדיקת המוכר שמחושב באופן אסינכרוני. |
MerchantReviewAttributes
מאפיינים.
שדות | |
---|---|
merchant_ |
חובה. המזהה חייב להיות ייחודי וקבוע בכל הבקשות. במילים אחרות, אם בקשה שהוגשה היום ובקשה אחרת שהוגשה לפני 90 יום מתייחסות לאותו מוכר, הן צריכות להיות בעלות אותו מזהה. |
merchant_ |
אופציונלי. השם המוצג של המוכר, שקריא לבני אדם. |
merchant_ |
אופציונלי. כתובת ה-URL של האתר הראשי של המוֹכר. אין להשתמש בכתובת URL להפניה אוטומטית עבור הערך הזה. במילים אחרות, הערך צריך להפנות ישירות לאתר של המוכר. |
merchant_ |
אופציונלי. כתובת ה-URL של דף הנחיתה שמארח את הביקורות על המוכר הזה. אין להשתמש בכתובת URL להפניה אוטומטית. |
min_ |
אופציונלי. המספר המינימלי האפשרי לדירוג. זה צריך להיות הדירוג הנמוך ביותר האפשרי, ולא ערך של 'ללא דירוג'. |
max_ |
אופציונלי. המספר המקסימלי האפשרי לדירוג. הערך של הדירוג המקסימלי חייב להיות גדול מהערך של הדירוג המינימלי. |
rating |
אופציונלי. הדירוג הכולל של המוכר על ידי הבודק. |
title |
אופציונלי. כותרת הביקורת. |
content |
חובה. זהו טקסט חופשי שהמשתמש מספק, ואין לקצר אותו. אם יש כמה תשובות לשאלות שונות, צריך לכלול את כל התשובות, עם הקשר מינימלי כדי שהתשובות יהיו הגיוניות. אין לספק הקשר אם שאלות לא נענו. |
reviewer_ |
אופציונלי. מזהה ייחודי וקבוע של מחבר הביקורת במערכת של בעל התוכן הדיגיטלי. |
reviewer_ |
אופציונלי. השם המוצג של כותב הביקורת. |
is_ |
אופציונלי. מגדירים את הערך כ-true אם כותב הביקורת צריך להישאר בעילום שם. |
collection_ |
אופציונלי. השיטה שבה השתמשו כדי לאסוף את הביקורת. |
review_ |
חובה. חותמת הזמן שמציינת מתי הביקורת נכתבה. |
review_ |
חובה. השפה של הביקורת, לפי קוד השפה BCP-47. |
review_ |
אופציונלי. המדינה שבה מבצע הבדיקה ביצע את ההזמנה, לפי קוד המדינה לפי תקן ISO 3166-1 Alpha-2. |
CollectionMethod
השיטה שבה השתמשו כדי לאסוף את הביקורת.
טיפוסים בני מנייה (enum) | |
---|---|
COLLECTION_METHOD_UNSPECIFIED |
שיטת האיסוף לא צוינה. |
MERCHANT_UNSOLICITED |
המשתמש לא השיב לבקשת תגובה ספציפית כששלח את הביקורת. |
POINT_OF_SALE |
המשתמש שלח את הביקורת בתגובה לבקשת משוב כשביצע הזמנה. |
AFTER_FULFILLMENT |
המשתמש שלח את הביקורת בתגובה לבקשת תגובה לאחר שההזמנה שלו בוצעה. |
MerchantReviewStatus
הסטטוס של בדיקת המוכר, בעיות באימות הנתונים, כלומר מידע על בדיקת המוכר שמחושב באופן אסינכרוני.
שדות | |
---|---|
destination_ |
פלט בלבד. היעדים המיועדים לבדיקת המוכר. |
item_ |
פלט בלבד. רשימה של כל הבעיות שמשויכות לבדיקה של המוכר. |
create_ |
פלט בלבד. התאריך שבו הפריט נוצר, בפורמט ISO 8601. |
last_ |
פלט בלבד. התאריך שבו הפריט עודכן לאחרונה, בפורמט ISO 8601. |
MerchantReviewDestinationStatus
סטטוס היעד של סטטוס הבדיקה של המוכר.
שדות | |
---|---|
reporting_ |
פלט בלבד. השם של ההקשר של הדיווח. |
MerchantReviewItemLevelIssue
הסטטוס של בדיקת המוכר ב-ItemLevelIssue.
שדות | |
---|---|
code |
פלט בלבד. קוד השגיאה של הבעיה. |
severity |
פלט בלבד. איך הבעיה הזו משפיעה על הצגת הביקורת על המוכר. |
resolution |
פלט בלבד. אם המוכר יכול לפתור את הבעיה. |
attribute |
פלט בלבד. שם המאפיין, אם הבעיה נגרמת על ידי מאפיין יחיד. |
reporting_ |
פלט בלבד. ההקשר של הדיווח שאליו הבעיה רלוונטית. |
description |
פלט בלבד. תיאור קצר של הבעיה באנגלית. |
detail |
פלט בלבד. תיאור מפורט של הבעיה באנגלית. |
documentation |
פלט בלבד. כתובת ה-URL של דף אינטרנט שיעזור לנו לפתור את הבעיה. |
מידת החומרה
איך הבעיה משפיעה על הצגת הביקורת על המוכר.
טיפוסים בני מנייה (enum) | |
---|---|
SEVERITY_UNSPECIFIED |
לא צוין. |
NOT_IMPACTED |
הבעיה הזו מייצגת אזהרה ואין לה השפעה ישירה על בדיקת המוכר. |
DISAPPROVED |
הבעיה גורמת לדחיית הביקורת על המוכר. |
ProductReview
ביקורת על מוצר. מידע נוסף זמין במאמר מבוא לפידים של ביקורות על מוצרים
שדות | |
---|---|
name |
מזהה. השם של הביקורת על המוצר. פורמט: |
product_ |
חובה. המזהה הקבוע והייחודי של הביקורת על המוצר במערכת של בעל התוכן הדיגיטלי. |
attributes |
אופציונלי. רשימה של מאפיינים של ביקורות על מוצרים. |
custom_ |
אופציונלי. רשימה של מאפיינים מותאמים אישית (שסופקו על ידי המוכר). |
data_ |
פלט בלבד. מקור הנתונים הראשי של הביקורת על המוצר. |
product_ |
פלט בלבד. הסטטוס של ביקורת על מוצר, בעיות באימות נתונים, כלומר מידע על ביקורת על מוצר שמחושב באופן אסינכרוני. |
ProductReviewAttributes
מאפיינים.
שדות | |
---|---|
review_ |
חובה. חותמת הזמן שמציינת מתי הביקורת נכתבה. |
pros[] |
אופציונלי. מכיל את היתרונות על סמך דעת הבודק. מומלץ להשמיט טקסט סטנדרטי כמו 'יתרון:', אלא אם הוא נכתב על ידי מבקר/ת. |
cons[] |
אופציונלי. כאן מפורטים החסרונות לפי דעת כותב הביקורת. מומלץ להשמיט טקסט סטנדרטי כמו 'con:', אלא אם הוא נכתב על ידי הבודק. |
review_ |
אופציונלי. ה-URI של דף הנחיתה של הביקורת. |
reviewer_ |
אופציונלי. URI לתמונה של המוצר שנבדק, שנוצרה על ידי מחבר הביקורת. ה-URI לא חייב להסתיים בסיומת של קובץ תמונה. |
product_ |
אופציונלי. שם תיאורי של מוצר. |
product_ |
אופציונלי. ה-URI של המוצר. הערך של ה-URI הזה יכול להיות זהה לערך של הרכיב |
asins[] |
אופציונלי. מכיל מספרי ASIN (מספרים סטנדרטיים מזהים של Amazon) שמשויכים למוצר. |
gtins[] |
אופציונלי. מכיל מספרי GTIN (מספרים של פריטים מסחריים גלובליים) שמשויכים למוצר. יש תמיכה בסוגי משנה של GTIN (למשל UPC, EAN, ISBN, JAN). |
mpns[] |
אופציונלי. מכיל קודי MPN (מספרי חלק של יצרן) שמשויכים למוצר. |
skus[] |
אופציונלי. מכיל מק"טים (מספרים קטלוגיים) שמשויכים למוצר. לרוב, המזהה הזה תואם למזהה המבצע של המוצר בפיד המוצרים. |
brands[] |
אופציונלי. מכיל שמות של מותגים שמשויכים למוצר. |
collection_ |
אופציונלי. השיטה שבה השתמשו כדי לאסוף את הביקורת. |
transaction_ |
אופציונלי. מזהה ייחודי וקבוע של העסקה שמשויכת לביקורת במערכת של בעל התוכן הדיגיטלי. אפשר להשתמש במזהה הזה כדי לציין שכמה ביקורות משויכות לאותה עסקה. |
aggregator_ |
אופציונלי. השם של הכלי לאיסוף הביקורות על המוצרים. בעלי תוכן דיגיטלי יכולים להשתמש באתר אגרגטור של ביקורות כדי לנהל את הביקורות ולספק את הפיד. הרכיב הזה מציין שימוש באגרגטור ומכיל מידע על האגרגטור. |
subclient_ |
אופציונלי. השם של לקוח המשנה של הביקורות על המוצרים. לקוח המשנה הוא מזהה של מקור הביקורות על המוצר. הוא צריך להיות זהה לספרייה שצוינה בנתיב של מקור הנתונים בקובץ. |
publisher_ |
אופציונלי. השם של המוציא לאור של הביקורות על המוצרים. המידע על בעל התוכן הדיגיטלי, שיכול להיות קמעונאי, יצרן, חברת שירותי ביקורות או כל ישות שמפרסמת ביקורות על מוצרים. |
publisher_ |
אופציונלי. קישור לסמליל החברה של בעל התוכן הדיגיטלי. מידות התמונה צריכות להיות בגודל של סמל favicon: 16x16 פיקסלים. פורמט התמונה צריך להיות GIF, JPG או PNG. |
reviewer_ |
אופציונלי. המחבר של הביקורת על המוצר. מזהה ייחודי וקבוע של מחבר הביקורת במערכת של בעל התוכן הדיגיטלי. |
reviewer_ |
אופציונלי. מגדירים את הערך כ-true אם כותב הביקורת צריך להישאר בעילום שם. |
reviewer_ |
אופציונלי. השם של כותב הביקורת על המוצר. |
review_ |
אופציונלי. השפה של הביקורת, מוגדרת לפי קוד השפה BCP-47. |
review_ |
אופציונלי. המדינה של הבדיקה, לפי קוד המדינה בפורמט ISO 3166-1 Alpha-2. |
title |
אופציונלי. כותרת הביקורת. |
content |
חובה. התוכן של הביקורת. |
min_ |
אופציונלי. מכיל את הדירוגים המשויכים לביקורת. המספר המינימלי האפשרי לדירוג. זה צריך להיות הדירוג הנמוך ביותר האפשרי, ולא ערך של 'ללא דירוג'. |
max_ |
אופציונלי. המספר המקסימלי האפשרי לדירוג. הערך של הדירוג המקסימלי חייב להיות גדול מהערך של המאפיין המינימלי. |
rating |
אופציונלי. הדירוג הכולל של המוצר על ידי מבקר/ת. |
is_ |
אופציונלי. מציין אם הביקורת סומנה כספאם במערכת של בעל התוכן הדיגיטלי. |
CollectionMethod
השיטה שבה השתמשו כדי לאסוף את הביקורת.
טיפוסים בני מנייה (enum) | |
---|---|
COLLECTION_METHOD_UNSPECIFIED |
שיטת האיסוף לא צוינה. |
UNSOLICITED |
המשתמש לא השיב לבקשת תגובה ספציפית כששלח את הביקורת. |
POST_FULFILLMENT |
המשתמש שלח את הביקורת בתגובה לבקשת תגובה לאחר שההזמנה שלו בוצעה. |
ReviewLink
ה-URI של דף הנחיתה של הביקורת.
שדות | |
---|---|
type |
אופציונלי. הסוג של ה-URI של הבדיקה. |
link |
אופציונלי. ה-URI של דף הנחיתה של הביקורת. לדוגמה: |
סוג
הסוג של ה-URI של הבדיקה.
טיפוסים בני מנייה (enum) | |
---|---|
TYPE_UNSPECIFIED |
הסוג לא צוין. |
SINGLETON |
דף הביקורות מכיל רק את הביקורת הזו. |
GROUP |
דף הביקורות מכיל קבוצה של ביקורות, כולל הביקורת הזו. |
ProductReviewStatus
סטטוס בדיקת המוצר.
שדות | |
---|---|
destination_ |
פלט בלבד. היעדים המיועדים של הביקורת על המוצר. |
item_ |
פלט בלבד. רשימה של כל הבעיות שמשויכות לבדיקה של המוצר. |
create_ |
פלט בלבד. התאריך שבו הפריט נוצר, בפורמט ISO 8601. |
last_ |
פלט בלבד. התאריך שבו הפריט עודכן לאחרונה, בפורמט ISO 8601. |
ProductReviewDestinationStatus
סטטוס היעד של סטטוס בדיקת המוצר.
שדות | |
---|---|
reporting_ |
פלט בלבד. השם של ההקשר של הדיווח. |
ProductReviewItemLevelIssue
הבעיה ברמת הפריט בסטטוס הבדיקה של המוצר.
שדות | |
---|---|
code |
פלט בלבד. קוד השגיאה של הבעיה. |
severity |
פלט בלבד. איך הבעיה הזו משפיעה על הצגת הביקורת על המוצר. |
resolution |
פלט בלבד. אם המוכר יכול לפתור את הבעיה. |
attribute |
פלט בלבד. שם המאפיין, אם הבעיה נגרמת על ידי מאפיין יחיד. |
reporting_ |
פלט בלבד. ההקשר של הדיווח שאליו הבעיה רלוונטית. |
description |
פלט בלבד. תיאור קצר של הבעיה באנגלית. |
detail |
פלט בלבד. תיאור מפורט של הבעיה באנגלית. |
documentation |
פלט בלבד. כתובת ה-URL של דף אינטרנט שיעזור לנו לפתור את הבעיה. |
מידת החומרה
איך הבעיה משפיעה על הצגת הביקורת על המוצר.
טיפוסים בני מנייה (enum) | |
---|---|
SEVERITY_UNSPECIFIED |
לא צוין. |
NOT_IMPACTED |
הבעיה הזו מייצגת אזהרה ואין לה השפעה ישירה על הביקורת על המוצר. |
DISAPPROVED |
הבעיה גורמת לפסילה של בדיקת המוצר. |