Method: achievements.list

แสดงความคืบหน้าสำหรับรางวัลพิเศษทั้งหมดของแอปพลิเคชันสำหรับโปรแกรมเล่นที่ตรวจสอบสิทธิ์แล้วในปัจจุบัน

คำขอ HTTP

GET https://games.googleapis.com/games/v1/players/{playerId}/achievements

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

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

string

รหัสผู้เล่น ระบบอาจใช้ค่า me แทนรหัสของโปรแกรมเล่นที่ตรวจสอบสิทธิ์แล้ว

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

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

string

ภาษาที่ต้องการใช้สำหรับสตริงที่แสดงผลโดยวิธีนี้
maxResults

integer

จำนวนสูงสุดของทรัพยากรรางวัลพิเศษที่จะแสดงผลในการตอบสนอง ใช้สำหรับการแบ่งหน้า สำหรับการตอบกลับใดๆ จำนวนจริงของทรัพยากรรางวัลพิเศษที่แสดงผลอาจน้อยกว่า maxResults ที่ระบุไว้
pageToken

string

โทเค็นที่แสดงผลโดยคำขอก่อนหน้า
state

enum (State)

บอกเซิร์ฟเวอร์ให้แสดงผลเฉพาะรางวัลพิเศษที่มีสถานะตามที่ระบุ หากไม่ได้ระบุพารามิเตอร์นี้ ระบบจะแสดงผลรางวัลพิเศษทั้งหมด

เนื้อหาของคำขอ

เนื้อหาของคำขอต้องว่างเปล่า

เนื้อหาการตอบกลับ

รายการออบเจ็กต์รางวัลพิเศษ

หากทำสำเร็จ เนื้อหาการตอบกลับจะมีข้อมูลซึ่งมีโครงสร้างดังต่อไปนี้

การแสดง JSON 
{
  "kind": string,
  "nextPageToken": string,
  "items": [
    {
      object (PlayerAchievement)
    }
  ]
}
ช่อง
kind

string

ระบุประเภทของทรัพยากรนี้โดยไม่ซ้ำกัน ค่าจะเป็นสตริงคงที่ games#playerAchievementListResponse เสมอ
nextPageToken

string

โทเค็นที่สอดคล้องกับหน้าถัดไปของผลการค้นหา
items[]

object (PlayerAchievement)

รางวัลพิเศษ

ขอบเขตการให้สิทธิ์

ต้องมีขอบเขต OAuth อย่างใดอย่างหนึ่งต่อไปนี้

  • https://www.googleapis.com/auth/games
  • https://www.googleapis.com/auth/games_lite

ดูข้อมูลเพิ่มเติมได้ที่ภาพรวมของ OAuth 2.0

รัฐ

Enum
ALL แสดงรายการรางวัลพิเศษทั้งหมด โดยตัวเลือกนี้คือค่าเริ่มต้น
HIDDEN แสดงเฉพาะรางวัลพิเศษที่ซ่อนไว้
REVEALED แสดงเฉพาะรางวัลพิเศษที่เปิดเผย
UNLOCKED แสดงเฉพาะรางวัลพิเศษที่ปลดล็อก

PlayerAchievement

ออบเจ็กต์รางวัลพิเศษ

การแสดง JSON 
{
  "kind": string,
  "id": string,
  "currentSteps": integer,
  "formattedCurrentStepsString": string,
  "achievementState": enum (State),
  "lastUpdatedTimestamp": string,
  "experiencePoints": string
}
ช่อง
kind

string

ระบุประเภทของทรัพยากรนี้โดยไม่ซ้ำกัน ค่าจะเป็นสตริงคงที่ games#playerAchievement เสมอ
id

string

รหัสของรางวัลพิเศษ
currentSteps

integer

ขั้นตอนปัจจุบันสำหรับรางวัลพิเศษที่เพิ่มขึ้น
formattedCurrentStepsString

string

ขั้นตอนปัจจุบันสำหรับรางวัลพิเศษที่เพิ่มขึ้นเป็นสตริง
achievementState

enum (State)

สถานะของรางวัลพิเศษ
lastUpdatedTimestamp

string (int64 format)

การประทับเวลาของการแก้ไขล่าสุดกับสถานะของรางวัลพิเศษนี้
experiencePoints

string (int64 format)

คะแนนประสบการณ์ที่ได้รับจากรางวัลพิเศษ ช่องนี้ไม่มีอยู่สำหรับรางวัลพิเศษที่ยังไม่ได้ปลดล็อกและ 0 สำหรับรางวัลพิเศษที่ผู้ทดสอบปลดล็อกแล้วแต่ที่ยังไม่ได้เผยแพร่

รัฐ

ระบุสถานะที่เป็นไปได้ของรางวัลพิเศษ

Enum
HIDDEN รางวัลพิเศษซ่อนอยู่
REVEALED แสดงความสำเร็จ
UNLOCKED รางวัลพิเศษถูกปลดล็อกแล้ว