- Yêu cầu HTTP
- Tham số đường dẫn
- Tham số truy vấn
- Nội dung yêu cầu
- Nội dung phản hồi
- Phạm vi uỷ quyền
- Trạng thái
- PlayerAchievement
- Trạng thái
- Hãy làm thử!
Liệt kê tiến trình của tất cả thành tích trong ứng dụng của bạn 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
Tham số | |
---|---|
playerId |
Mã nhận dạng người chơi. Bạn có thể sử dụng giá trị của |
Tham số truy vấn
Tham số | |
---|---|
language |
Ngôn ngữ ưu tiên để sử dụng cho các chuỗi được phương thức này trả về. |
maxResults |
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 |
pageToken |
Mã thông báo do yêu cầu trước đó trả về. |
state |
Yêu cầu máy chủ chỉ trả về các thành tích ở trạng thái đã chỉ định. Nếu tham số này không được chỉ định, 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 các đố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 ( |
Trường | |
---|---|
kind |
Xác định duy nhất loại tài nguyên này. Giá trị luôn là chuỗi |
nextPageToken |
Mã thông báo tương ứng với trang kết quả tiếp theo. |
items[] |
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.
Tiểu bang
Enum | |
---|---|
ALL |
Liệt kê tất cả thành tích. Đây là tuỳ chọn mặc định. |
HIDDEN |
Chỉ liệt kê những thành tích bị ẩn. |
REVEALED |
Danh sách chỉ được tiết lộ thành tích. |
UNLOCKED |
Chỉ liệt kê những thành tích đã mở khóa. |
PlayerAchievement
Một đố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 ( |
Trường | |
---|---|
kind |
Xác định duy nhất loại tài nguyên này. Giá trị luôn là chuỗi |
id |
Mã của thành tích. |
currentSteps |
Các bước hiện tại để đạt được thành tích dần dần. |
formattedCurrentStepsString |
Các bước hiện tại để đạt được thành tích gia tăng dưới dạng chuỗi. |
achievementState |
Trạng thái của thành tích. |
lastUpdatedTimestamp |
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 |
Số điểm kinh nghiệm kiếm đượ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 mà người kiểm tra đã 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ở khoá. |