Method: achievementDefinitions.list

แสดงคำนิยามของรางวัลพิเศษทั้งหมดสำหรับแอปพลิเคชันของคุณ

คำขอ HTTP

GET https://games.googleapis.com/games/v1/achievements

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

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

string

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

integer

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

string

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

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

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

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

รายการออบเจ็กต์คำจำกัดความของรางวัลพิเศษ

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

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

string

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

string

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

object (AchievementDefinition)

คำจำกัดความของรางวัลพิเศษ

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

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

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

สำหรับข้อมูลเพิ่มเติม โปรดดูที่ภาพรวมของ OAuth 2.0

AchievementDefinition

ออบเจ็กต์คำจำกัดความของรางวัลพิเศษ

การแสดง JSON 
{
  "kind": string,
  "id": string,
  "name": string,
  "description": string,
  "achievementType": enum (AchievementType),
  "totalSteps": integer,
  "formattedTotalSteps": string,
  "revealedIconUrl": string,
  "isRevealedIconUrlDefault": boolean,
  "unlockedIconUrl": string,
  "isUnlockedIconUrlDefault": boolean,
  "initialState": enum (InitialAchievementState),
  "experiencePoints": string
}
ช่อง
kind

string

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

string

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

string

ชื่อของรางวัลพิเศษ
description

string

คำอธิบายของรางวัลพิเศษ
achievementType

enum (AchievementType)

ประเภทของรางวัลพิเศษ
totalSteps

integer

ขั้นตอนทั้งหมดสำหรับรางวัลพิเศษแบบเพิ่มขึ้นเรื่อยๆ
formattedTotalSteps

string

ขั้นตอนทั้งหมดของรางวัลพิเศษแบบเพิ่มขึ้นเรื่อยๆ เป็นสตริง
revealedIconUrl

string

URL รูปภาพสำหรับไอคอนรางวัลพิเศษที่แสดงขึ้น
isRevealedIconUrlDefault

boolean

ระบุว่าภาพไอคอนที่แสดงขึ้นเป็นภาพเริ่มต้นหรือมาจากเกม
unlockedIconUrl

string

URL รูปภาพของไอคอนรางวัลพิเศษที่ปลดล็อกแล้ว
isUnlockedIconUrlDefault

boolean

ระบุว่าภาพไอคอนที่ปลดล็อกแล้วที่ส่งกลับมาเป็นภาพเริ่มต้นหรือเป็นภาพจากเกม
initialState

enum (InitialAchievementState)

สถานะเริ่มต้นของรางวัลพิเศษ
experiencePoints

string (int64 format)

คะแนนประสบการณ์ที่จะได้รับเมื่อปลดล็อกรางวัลพิเศษนี้

AchievementType

ประเภทรางวัลพิเศษที่เป็นไปได้

Enum
STANDARD รางวัลพิเศษถูกล็อกหรือปลดล็อกอยู่
INCREMENTAL ความสำเร็จนั้นเพิ่มขึ้นเรื่อยๆ

InitialAchievementState

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

Enum
HIDDEN รางวัลพิเศษซ่อนอยู่
REVEALED รางวัลพิเศษจะปรากฏขึ้น
UNLOCKED รางวัลพิเศษถูกปลดล็อก