Method: publishers.items.fetchReviews

ดึงข้อมูลรีวิวจากผู้ใช้สำหรับรายการ

คำขอ HTTP

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

URL ใช้ไวยากรณ์การแปลงรหัส gRPC

พารามิเตอร์เส้นทาง

พารามิเตอร์
name

string

ต้องระบุ ชื่อทรัพยากรของสินค้าที่มีการดึงข้อมูลรีวิว รูปแบบ: publishers/{publisher_id}/items/{itemId}

พารามิเตอร์การค้นหา

พารามิเตอร์
pageSize

integer

ไม่บังคับ จำนวนรีวิวสูงสุดที่จะแสดงผล บริการอาจแสดงผลลัพธ์น้อยกว่าค่านี้ หากไม่ระบุ ระบบจะแสดงผลรีวิวไม่เกิน 50 รายการ ค่าสูงสุดคือ 200 โดยค่าที่มากกว่า 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

ชื่อที่แสดงของผู้เขียน