- Yêu cầu HTTP
- 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
- AchievementDefinition
- AchievementType
- InitialAchievementState
- Hãy làm thử!
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 |
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ề. |
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 ( |
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[] |
Đị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 ( |
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. |
name |
Tên của thành tích. |
description |
Nội dung mô tả về thành tích. |
achievementType |
Loại thành tích. |
totalSteps |
Tổng số bước để đạt được một thành tích gia tăng. |
formattedTotalSteps |
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 |
URL hình ảnh của biểu tượng thành tích đã công bố. |
isRevealedIconUrlDefault |
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 |
URL hình ảnh của biểu tượng thành tích đã mở khoá. |
isUnlockedIconUrlDefault |
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 |
Trạng thái ban đầu của thành tích. |
experiencePoints |
Đ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á. |