REST Resource: reviews

แหล่งข้อมูล: ตรวจสอบ

รีวิวแอป Android

การแสดง JSON 
{
  "reviewId": string,
  "authorName": string,
  "comments": [
    {
      object (Comment)
    }
  ]
}
ช่อง
reviewId

string

ตัวระบุที่ไม่ซ้ำกันสำหรับรีวิวนี้
authorName

string

ชื่อของผู้ใช้ที่เขียนรีวิว
comments[]

object (Comment)

ฟิลด์ที่ซ้ำได้ซึ่งมีความคิดเห็นสำหรับการรีวิว

ความคิดเห็น

รายการการสนทนาระหว่างผู้ใช้กับนักพัฒนาแอป

การแสดง JSON 
{

  // Union field comment can be only one of the following:
  "userComment": {
    object (UserComment)
  },
  "developerComment": {
    object (DeveloperComment)
  }
  // End of list of possible types for union field comment.
}
ช่อง

ฟิลด์ Union comment

comment ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
userComment

object (UserComment)

ความคิดเห็นจากผู้ใช้
developerComment

object (DeveloperComment)

ความคิดเห็นจากนักพัฒนาแอป

UserComment

ผู้ใช้เข้าสู่แอปจากบทสนทนาระหว่างผู้ใช้กับนักพัฒนาแอป

การแสดง JSON 
{
  "text": string,
  "lastModified": {
    object (Timestamp)
  },
  "starRating": integer,
  "reviewerLanguage": string,
  "device": string,
  "androidOsVersion": integer,
  "appVersionCode": integer,
  "appVersionName": string,
  "thumbsUpCount": integer,
  "thumbsDownCount": integer,
  "deviceMetadata": {
    object (DeviceMetadata)
  },
  "originalText": string
}
ช่อง
text

string

เนื้อหาของความคิดเห็น เช่น เนื้อหาของรีวิว ในบางกรณี ผู้ใช้สามารถเขียนรีวิวโดยมีชื่อและเนื้อหาแยกกันได้ ในกรณีดังกล่าว ระบบจะเชื่อมชื่อและเนื้อหาเข้าด้วยกันและคั่นด้วยอักขระแท็บ
lastModified

object (Timestamp)

เวลาล่าสุดที่มีการอัปเดตความคิดเห็นนี้
starRating

integer

การให้ดาวที่เชื่อมโยงกับรีวิว ตั้งแต่ 1 ถึง 5
reviewerLanguage

string

รหัสภาษาสำหรับผู้รีวิว ข้อมูลนี้มาจากในการตั้งค่าอุปกรณ์ จึงไม่รับประกันว่าจะตรงกับภาษาที่ใช้เขียนรีวิว อาจไม่มี
device

string

ชื่อรหัสของอุปกรณ์ของผู้รีวิว เช่น klte, flounder อาจไม่มี
androidOsVersion

integer

เวอร์ชัน SDK ของ Android ที่เป็นจำนวนเต็มของอุปกรณ์ของผู้ใช้ในขณะที่เขียนรีวิว เช่น 23 คือ Marshmallow อาจไม่มี
appVersionCode

integer

รหัสเวอร์ชันจำนวนเต็มของแอปตามที่ติดตั้ง ณ เวลาที่เขียนรีวิว อาจไม่มี
appVersionName

string

ชื่อเวอร์ชันสตริงของแอปตามที่ติดตั้ง ณ เวลาที่เขียนรีวิว อาจไม่มี
thumbsUpCount

integer

จำนวนผู้ใช้ที่กดชอบรีวิวนี้
thumbsDownCount

integer

จำนวนผู้ใช้ที่กดไม่ชอบรีวิวนี้
deviceMetadata

object (DeviceMetadata)

ข้อมูลเกี่ยวกับลักษณะของอุปกรณ์ของผู้ใช้
originalText

string

ข้อความรีวิวที่ไม่ได้แปล (ในกรณีที่มีการแปลรีวิว) หากรีวิวไม่ได้รับการแปล ช่องนี้จะว่างเปล่า

การประทับเวลา

การประทับเวลาแสดงช่วงเวลาหนึ่งโดยไม่ขึ้นอยู่กับเขตเวลาหรือปฏิทินท้องถิ่นใดๆ โดยเข้ารหัสเป็นจำนวนวินาทีและเศษวินาทีที่ความละเอียดระดับนาโนวินาที การนับจะสัมพันธ์กับ Epoch ที่เที่ยงคืน UTC ในวันที่ 1 มกราคม 1970

การแสดง JSON 
{
  "seconds": string,
  "nanos": integer
}
ช่อง
seconds

string (int64 format)

แสดงวินาทีของเวลา UTC ตั้งแต่ Epoch ของ Unix
nanos

integer

เศษส่วนของวินาทีที่ไม่เป็นลบที่ความละเอียดระดับนาโนวินาที ต้องอยู่ระหว่าง 0 ถึง 999,999,999 เท่านั้น

DeviceMetadata

ลักษณะของอุปกรณ์ของผู้ใช้

การแสดง JSON 
{
  "productName": string,
  "manufacturer": string,
  "deviceClass": string,
  "screenWidthPx": integer,
  "screenHeightPx": integer,
  "nativePlatform": string,
  "screenDensityDpi": integer,
  "glEsVersion": integer,
  "cpuModel": string,
  "cpuMake": string,
  "ramMb": integer
}
ช่อง
productName

string

ชื่อรุ่นของอุปกรณ์ (เช่น Droid)
manufacturer

string

ผู้ผลิตอุปกรณ์ (เช่น Motorola)
deviceClass

string

คลาสของอุปกรณ์ (เช่น แท็บเล็ต)
screenWidthPx

integer

ความกว้างของหน้าจอเป็นพิกเซล
screenHeightPx

integer

ความสูงของหน้าจอเป็นพิกเซล
nativePlatform

string

รายการแพลตฟอร์มเนทีฟที่คั่นด้วยคอมมา (เช่น "arm", "arm7")
screenDensityDpi

integer

ความหนาแน่นของหน้าจอใน DPI
glEsVersion

integer

เวอร์ชัน OpenGL
cpuModel

string

รุ่น CPU ของอุปกรณ์ เช่น "MSM8974"
cpuMake

string

ผู้ผลิต CPU ของอุปกรณ์ เช่น "Qualcomm"
ramMb

integer

RAM ของอุปกรณ์ในหน่วยเมกะไบต์ เช่น "2048"

DeveloperComment

รายการของนักพัฒนาแอปจากการสนทนาระหว่างผู้ใช้กับนักพัฒนาแอป

การแสดง JSON 
{
  "text": string,
  "lastModified": {
    object (Timestamp)
  }
}
ช่อง
text

string

เนื้อหาของความคิดเห็น เช่น เนื้อหาการตอบกลับ
lastModified

object (Timestamp)

เวลาล่าสุดที่มีการอัปเดตความคิดเห็นนี้

เมธอด

get

 ได้รับรีวิวเดียว

list

 แสดงรีวิวทั้งหมด

reply

 ตอบกลับรีวิวเดียวหรืออัปเดตคำตอบที่มีอยู่

รหัสข้อผิดพลาด

การดำเนินการของทรัพยากรนี้จะแสดงรหัสข้อผิดพลาด HTTP ต่อไปนี้

รหัสข้อผิดพลาด เหตุผล คำอธิบาย ความละเอียด
400 invalidValue ระบุค่าไม่ถูกต้องในคำขอ โดยมักจะแสดงเมื่อโทเค็นการซื้อมีรูปแบบไม่ถูกต้องหรือไม่ถูกต้อง แก้ไขค่าฟิลด์ที่ไม่ถูกต้องในเนื้อหาคำขอหรือพารามิเตอร์ตามข้อมูลอ้างอิงของ API
400 required คำขอไม่มีช่องหรือพารามิเตอร์ที่จำเป็น อ่านเอกสารประกอบของ API เพื่อให้แน่ใจว่ามีช่องและพารามิเตอร์ที่จำเป็นทั้งหมด
403 userInsufficientPermission ผู้ใช้มีสิทธิ์ไม่เพียงพอในการดำเนินการที่ขอ ตรวจสอบว่าผู้ใช้ที่ได้รับการตรวจสอบสิทธิ์มีสิทธิ์ที่จำเป็นใน Google Play Console ดูรายละเอียดเพิ่มเติมได้ที่ การใช้บัญชีบริการ
404 notFound ไม่พบทรัพยากรที่ขอ ตรวจสอบว่าตัวระบุ (เช่น โทเค็นการซื้อ ชื่อแพ็กเกจ รหัสผลิตภัณฑ์ รหัสการสมัครใช้บริการ) ถูกต้อง
409 concurrentUpdate มีการพยายามอัปเดตออบเจ็กต์ที่กำลังอัปเดตพร้อมกัน ลองส่งคำขออีกครั้งโดยใช้ Exponential Backoff หลีกเลี่ยงการแก้ไขทรัพยากรเดียวกันพร้อมกัน
5xx Generic error ข้อผิดพลาดทั่วไปในเซิร์ฟเวอร์ของ Google Play ลองส่งคำขออีกครั้ง

หากยังคงพบปัญหาอยู่ โปรดติดต่อผู้จัดการลูกค้า Google Play หรือส่งคำขอรับการสนับสนุน โปรดตรวจสอบแดชบอร์ดสถานะของ Play เพื่อดูการหยุดทำงานที่ทราบ