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 รางวัลพิเศษถูกปลดล็อก