Method: achievements.list

Liệt kê tiến trình của tất cả thành tích của ứng dụng cho người chơi hiện đã được xác thực.

Yêu cầu HTTP

GET https://games.googleapis.com/games/v1/players/{playerId}/achievements

Tham số đường dẫn

Các tham số
playerId

string

Mã nhận dạng người chơi. Giá trị của me có thể được sử dụng thay cho mã của người chơi đã xác thực.

Tham số truy vấn

Các tham số
language

string

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

integer

Số tài nguyên thành tích tối đa cần trả về trong phản hồi, được dùng để phân trang. Đối với mọi phản hồi, 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 được yêu cầu trước đó trả về.
state

enum (State)

Yêu cầu máy chủ chỉ trả về các thành tích có trạng thái đã chỉ định. Nếu bạn không chỉ định tham số này, thì tất cả thành tích sẽ đượ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 đối tượng 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 (PlayerAchievement)
    }
  ]
}
Các 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 cố định games#playerAchievementListResponse.
nextPageToken

string

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

object (PlayerAchievement)

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 Tổng quan về OAuth 2.0.

Tiểu bang

Enum
ALL Liệt kê tất cả thành tích. Đây là lựa chọn mặc định.
HIDDEN Chỉ liệt kê những thành tích bị ẩn.
REVEALED Danh sách chỉ đã tiết lộ thành tích.
UNLOCKED Chỉ liệt kê những thành tích đã mở khóa.

PlayerAchievement

Đối tượng thành tích.

Biểu diễn dưới dạng JSON 
{
  "kind": string,
  "id": string,
  "currentSteps": integer,
  "formattedCurrentStepsString": string,
  "achievementState": enum (State),
  "lastUpdatedTimestamp": string,
  "experiencePoints": string
}
Các 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 cố định games#playerAchievement.
id

string

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

integer

Các bước hiện tại để đạt được một thành tích gia tăng.
formattedCurrentStepsString

string

Các bước hiện tại để đạt được thành tích gia tăng dưới dạng một chuỗi.
achievementState

enum (State)

Trạng thái của thành tích.
lastUpdatedTimestamp

string (int64 format)

Dấu thời gian của lần sửa đổi gần đây nhất đối với trạng thái của thành tích này.
experiencePoints

string (int64 format)

Số điểm kinh nghiệm đã nhận được cho thành tích này. Trường này không có đối với thành tích chưa được mở khóa và 0 đối với thành tích đã được người thử nghiệm mở khóa nhưng chưa được xuất bản.

Tiểu bang

Xác định các trạng thái 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ở khóa.