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