Method: publishers.items.fetchReviews

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

בקשת HTTP

GET https://chromewebstore.googleapis.com/v2/{name=publishers/*/items/*}:fetchReviews

כתובת ה-URL כתובה בתחביר של gRPC Transcoding.

פרמטרים של הנתיב

פרמטרים
name

string

חובה. שם המשאב של הפריט שהביקורות שלו מאוחזרות. פורמט: publishers/{publisher_id}/items/{itemId}

פרמטרים של שאילתה

פרמטרים
pageSize

integer

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

string

אופציונלי. טוקן של דף שהתקבל מקריאה קודמת של items.fetchReviews. צריך להזין את הטוקן כדי לאחזר את הדף הבא.

כשמבצעים חלוקה לעמודים, כל הפרמטרים האחרים שסופקו ל-items.fetchReviews חייבים להיות זהים לקריאה שסיפקה את הטוקן של הדף.
filter

string

אופציונלי. מסנן שאפשר להחיל על הביקורות. אפשר להשוות רק דירוגים שווים, למשל rating = 5.
orderBy

string

אופציונלי. רשימה אופציונלית מופרדת בפסיקים של שדות שלפיהם התוצאות ימוינו. סדר המיון שמוגדר כברירת מחדל הוא סדר עולה (asc). השדות הנתמכים הם: - rating: סדרי המיון הנתמכים הם asc (ברירת המחדל) ו-desc. ‫- createTime: יש תמיכה רק ב-desc (הכי חדש קודם). צריך לציין את desc באופן מפורש כי ברירת המחדל היא asc. לדוגמה: rating desc,‏ createTime desc או rating desc, createTime desc.

גוף הבקשה

גוף הבקשה צריך להיות ריק.

גוף התשובה

הודעת התגובה של items.fetchReviews.

אם הפעולה מצליחה, גוף התשובה מכיל נתונים במבנה הבא:

ייצוג ב-JSON 
{
  "reviews": [
    {
      object (Review)
    }
  ],
  "nextPageToken": string
}
שדות
reviews[]

object (Review)

רשימת הביקורות.
nextPageToken

string

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

היקפי הרשאות

נדרש אחד מהיקפי ההרשאות הבאים של OAuth:

  • https://www.googleapis.com/auth/chromewebstore
  • https://www.googleapis.com/auth/chromewebstore.readonly

בדיקה

ביקורת שמשתמש כתב כדי לדרג פריט בחנות האינטרנט של Chrome.

ייצוג ב-JSON 
{
  "name": string,
  "item": string,
  "authorInfo": {
    object (AuthorInfo)
  },
  "rating": integer,
  "comment": string,
  "createTime": string
}
שדות
name

string

מזהה. שם המשאב של הביקורת. פורמט: reviews/{reviewId}
item

string

פלט בלבד. הפריט שהביקורת הזו מעריכה. פורמט: publishers/{publisher}/items/{item}
authorInfo

object (AuthorInfo)

מידע על מחבר הביקורת.
rating

integer

דירוג הפריט, בין 1 ל-5.
comment

string

תוכן הביקורת.
createTime

string (Timestamp format)

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

הפורמט הוא RFC 3339, והפלט שנוצר תמיד יהיה מנורמל ל-Z וישתמש ב-0, 3, 6 או 9 ספרות אחרי הנקודה העשרונית. אפשר להשתמש גם בהיסטים אחרים, לא רק ב-Z. לדוגמה: "2014-10-02T15:01:23Z",‏ "2014-10-02T15:01:23.045123456Z" או "2014-10-02T15:01:23+05:30".

AuthorInfo

מידע על מחבר הביקורת.

ייצוג ב-JSON 
{
  "displayName": string
}
שדות
displayName

string

השם המוצג של המחבר.