- คำขอ HTTP
- พารามิเตอร์เส้นทาง
- พารามิเตอร์การค้นหา
- เนื้อความของคำขอ
- เนื้อหาการตอบกลับ
- ขอบเขตการให้สิทธิ์
- สถานะ
- PlayerAchievement
- สถานะ
- ลองใช้งาน
แสดงความคืบหน้าสำหรับรางวัลพิเศษทั้งหมดของแอปพลิเคชันของคุณสำหรับโปรแกรมเล่นที่ตรวจสอบสิทธิ์แล้วในปัจจุบัน
คำขอ HTTP
GET https://games.googleapis.com/games/v1/players/{playerId}/achievements
พารามิเตอร์เส้นทาง
พารามิเตอร์ | |
---|---|
playerId |
รหัสผู้เล่น ระบบอาจใช้ค่า |
พารามิเตอร์การค้นหา
พารามิเตอร์ | |
---|---|
language |
ภาษาที่ต้องการใช้สำหรับสตริงที่แสดงผลโดยวิธีการนี้ |
maxResults |
จำนวนทรัพยากรรางวัลพิเศษสูงสุดที่จะแสดงผลในการตอบสนอง ซึ่งใช้สำหรับการแบ่งหน้า สำหรับการตอบกลับ จำนวนทรัพยากรของรางวัลพิเศษที่แสดงจริงอาจน้อยกว่า |
pageToken |
โทเค็นที่ส่งกลับโดยคำขอก่อนหน้า |
state |
กำหนดให้เซิร์ฟเวอร์แสดงผลเฉพาะรางวัลพิเศษที่มีสถานะที่ระบุ หากไม่ได้ระบุพารามิเตอร์นี้ ระบบจะแสดงผลรางวัลพิเศษทั้งหมด |
เนื้อหาของคำขอ
เนื้อหาของคำขอต้องว่างเปล่า
เนื้อหาการตอบกลับ
รายการออบเจ็กต์รางวัลพิเศษ
หากทำสำเร็จ เนื้อหาการตอบกลับจะมีข้อมูลซึ่งมีโครงสร้างดังต่อไปนี้
การแสดง JSON |
---|
{
"kind": string,
"nextPageToken": string,
"items": [
{
object ( |
ช่อง | |
---|---|
kind |
ระบุประเภทของทรัพยากรนี้โดยไม่ซ้ำกัน ค่าเป็นสตริงคงที่ |
nextPageToken |
โทเค็นที่ตรงกับผลการค้นหาหน้าถัดไป |
items[] |
ความสำเร็จ |
ขอบเขตการให้สิทธิ์
ต้องใช้ขอบเขต 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 ( |
ช่อง | |
---|---|
kind |
ระบุประเภทของทรัพยากรนี้โดยไม่ซ้ำกัน ค่าเป็นสตริงคงที่ |
id |
รหัสของรางวัลพิเศษ |
currentSteps |
ขั้นตอนปัจจุบันสำหรับรางวัลพิเศษแบบเพิ่มขึ้นเรื่อยๆ |
formattedCurrentStepsString |
ขั้นตอนปัจจุบันสำหรับรางวัลพิเศษแบบเพิ่มขึ้นเรื่อยๆ เป็นสตริง |
achievementState |
สถานะของรางวัลพิเศษ |
lastUpdatedTimestamp |
การประทับเวลาของการแก้ไขสถานะของรางวัลพิเศษนี้ครั้งล่าสุด |
experiencePoints |
คะแนนประสบการณ์ที่ได้รับจากรางวัลพิเศษนี้ ช่องนี้จะไม่มีสำหรับรางวัลพิเศษที่ยังไม่ได้ปลดล็อก และ 0 สำหรับรางวัลพิเศษที่ผู้ทดสอบปลดล็อกแล้วแต่ยังไม่ได้เผยแพร่ |
รัฐ
กำหนดสถานะที่เป็นไปได้ของรางวัลพิเศษ
Enum | |
---|---|
HIDDEN |
รางวัลพิเศษซ่อนอยู่ |
REVEALED |
รางวัลพิเศษจะปรากฏขึ้น |
UNLOCKED |
รางวัลพิเศษถูกปลดล็อก |