Method: achievementDefinitions.list

Liệt kê tất cả định nghĩa thành tích cho ứng dụng của bạn.

Yêu cầu HTTP

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

Tham số truy vấn

Tham số
language

string

Ngôn ngữ ưu tiên để sử dụng cho các chuỗi được phương thức này trả về.
maxResults

integer

Số lượng tài nguyên thành tích tối đa cần trả về trong phản hồi, dùng để phân trang. Đối với bất kỳ phản hồi nào, số lượng tài nguyên thành tích thực tế được trả về có thể ít hơn maxResults được chỉ định.
pageToken

string

Mã thông báo do yêu cầu trước đó trả về.

Nội dung yêu cầu

Nội dung yêu cầu phải trống.

Nội dung phản hồi

Danh sách các đối tượng định nghĩa thành tích.

Nếu thành công, phần nội dung phản hồi sẽ chứa dữ liệu có cấu trúc sau:

Biểu diễn dưới dạng JSON 
{
  "kind": string,
  "nextPageToken": string,
  "items": [
    {
      object (AchievementDefinition)
    }
  ]
}
Trường
kind

string

Xác định duy nhất loại tài nguyên này. Giá trị luôn là chuỗi games#achievementDefinitionsListResponse cố định.
nextPageToken

string

Mã thông báo tương ứng với trang kết quả tiếp theo.
items[]

object (AchievementDefinition)

Định nghĩa thành tích.

Phạm vi uỷ quyền

Yêu cầu một trong các phạm vi OAuth sau:

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

Để biết thêm thông tin, hãy xem bài viết Tổng quan về OAuth 2.0.

AchievementDefinition

Đối tượng định nghĩa thành tích.

Biểu diễn dưới dạng 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
}
Trường
kind

string

Xác định duy nhất loại tài nguyên này. Giá trị luôn là chuỗi games#achievementDefinition cố định.
id

string

Mã của thành tích.
name

string

Tên của thành tích.
description

string

Nội dung mô tả về thành tích.
achievementType

enum (AchievementType)

Loại thành tích.
totalSteps

integer

Tổng số bước để đạt được một thành tích gia tăng.
formattedTotalSteps

string

Tổng số bước của một thành tích tăng dần dưới dạng một chuỗi.
revealedIconUrl

string

URL hình ảnh của biểu tượng thành tích đã công bố.
isRevealedIconUrlDefault

boolean

Cho biết liệu hình ảnh biểu tượng được tiết lộ mà hệ thống trả về là hình ảnh mặc định hay do trò chơi cung cấp.
unlockedIconUrl

string

URL hình ảnh của biểu tượng thành tích đã mở khoá.
isUnlockedIconUrlDefault

boolean

Cho biết liệu hình ảnh biểu tượng đã mở khoá được trả về là hình ảnh mặc định hay do trò chơi cung cấp.
initialState

enum (InitialAchievementState)

Trạng thái ban đầu của thành tích.
experiencePoints

string (int64 format)

Điểm kinh nghiệm bạn sẽ nhận được khi mở khoá thành tích này.

AchievementType

Các loại thành tích có thể có.

Enum
STANDARD Thành tích đang bị khoá hoặc đã mở khoá.
INCREMENTAL Thành tích ngày càng gia tăng.

InitialAchievementState

Các trạng thái ban đầu có thể có của một thành tích.

Enum
HIDDEN Thành tích bị ẩn.
REVEALED Thành tích đã được tiết lộ.
UNLOCKED Thành tích đã được mở khoá.