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