Method: achievementDefinitions.list
Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
Mencantumkan semua definisi pencapaian untuk aplikasi Anda.
Permintaan HTTP
GET https://games.googleapis.com/games/v1/achievements
Parameter kueri
| Parameter |
language |
string
Bahasa pilihan yang akan digunakan untuk string yang ditampilkan oleh metode ini.
|
maxResults |
integer
Jumlah maksimum resource pencapaian yang akan ditampilkan dalam respons, yang digunakan untuk paging. Untuk respons apa pun, jumlah sebenarnya dari resource pencapaian yang ditampilkan mungkin kurang dari maxResults yang ditentukan.
|
pageToken |
string
Token yang ditampilkan oleh permintaan sebelumnya.
|
Isi permintaan
Isi permintaan harus kosong.
Isi respons
Daftar objek definisi pencapaian.
Jika berhasil, isi respons berisi data dengan struktur berikut:
| Representasi JSON |
{
"kind": string,
"nextPageToken": string,
"items": [
{
object (AchievementDefinition)
}
]
} |
| Kolom |
kind |
string
Secara unik mengidentifikasi jenis resource ini. Nilainya selalu berupa string tetap games#achievementDefinitionsListResponse.
|
nextPageToken |
string
Token yang sesuai dengan halaman hasil berikutnya.
|
items[] |
object (AchievementDefinition)
Definisi pencapaian.
|
Cakupan otorisasi
Memerlukan salah satu cakupan OAuth berikut:
https://www.googleapis.com/auth/games
https://www.googleapis.com/auth/games_lite
Untuk informasi selengkapnya, lihat Ringkasan OAuth 2.0.
AchievementDefinition
Objek definisi pencapaian.
| Representasi 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
} |
| Kolom |
kind |
string
Secara unik mengidentifikasi jenis resource ini. Nilainya selalu berupa string tetap games#achievementDefinition.
|
id |
string
ID pencapaian.
|
name |
string
Nama pencapaian.
|
description |
string
Deskripsi pencapaian.
|
achievementType |
enum (AchievementType)
Jenis pencapaian.
|
totalSteps |
integer
Total langkah untuk pencapaian inkremental.
|
formattedTotalSteps |
string
Total langkah untuk pencapaian inkremental sebagai string.
|
revealedIconUrl |
string
URL gambar untuk ikon pencapaian yang ditampilkan.
|
isRevealedIconUrlDefault |
boolean
Menunjukkan apakah gambar ikon yang ditampilkan yang ditampilkan adalah gambar default, atau disediakan oleh game.
|
unlockedIconUrl |
string
URL gambar untuk ikon pencapaian yang terbuka.
|
isUnlockedIconUrlDefault |
boolean
Menunjukkan apakah gambar ikon yang tidak terkunci yang ditampilkan adalah gambar default, atau disediakan oleh game.
|
initialState |
enum (InitialAchievementState)
Status awal pencapaian.
|
experiencePoints |
string (int64 format)
Poin pengalaman yang akan diperoleh saat membuka pencapaian ini.
|
AchievementType
Kemungkinan jenis pencapaian.
| Enum |
STANDARD |
Pencapaian terkunci atau terbuka. |
INCREMENTAL |
Pencapaian bersifat inkremental. |
InitialAchievementState
Kemungkinan status awal pencapaian.
| Enum |
HIDDEN |
Pencapaian disembunyikan. |
REVEALED |
Pencapaian ditampilkan. |
UNLOCKED |
Pencapaian berhasil dibuka. |
Konten dan contoh kode di halaman ini tunduk kepada lisensi yang dijelaskan dalam Lisensi Konten. Java dan OpenJDK adalah merek dagang atau merek dagang terdaftar dari Oracle dan/atau afiliasinya.
Terakhir diperbarui pada 2025-07-27 UTC.
[[["Mudah dipahami","easyToUnderstand","thumb-up"],["Memecahkan masalah saya","solvedMyProblem","thumb-up"],["Lainnya","otherUp","thumb-up"]],[["Informasi yang saya butuhkan tidak ada","missingTheInformationINeed","thumb-down"],["Terlalu rumit/langkahnya terlalu banyak","tooComplicatedTooManySteps","thumb-down"],["Sudah usang","outOfDate","thumb-down"],["Masalah terjemahan","translationIssue","thumb-down"],["Masalah kode / contoh","samplesCodeIssue","thumb-down"],["Lainnya","otherDown","thumb-down"]],["Terakhir diperbarui pada 2025-07-27 UTC."],[],[],null,["# Method: achievementDefinitions.list\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n - [JSON representation](#body.ListAchievementDefinitionsResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [AchievementDefinition](#AchievementDefinition)\n - [JSON representation](#AchievementDefinition.SCHEMA_REPRESENTATION)\n- [AchievementType](#AchievementType)\n- [InitialAchievementState](#InitialAchievementState)\n- [Try it!](#try-it)\n\nLists all the achievement definitions for your application.\n\n### HTTP request\n\n`GET https://games.googleapis.com/games/v1/achievements`\n\n### Query parameters\n\n| Parameters ||\n|--------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `language` | `string` The preferred language to use for strings returned by this method. |\n| `maxResults` | `integer` The maximum number of achievement resources to return in the response, used for paging. For any response, the actual number of achievement resources returned may be less than the specified `maxResults`. |\n| `pageToken` | `string` The token returned by the previous request. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nA list of achievement definition objects.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"kind\": string, \"nextPageToken\": string, \"items\": [ { object (/games/services/web/api/rest/v1/achievementDefinitions/list#AchievementDefinition) } ] } ``` |\n\n| Fields ||\n|-----------------|------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `kind` | `string` Uniquely identifies the type of this resource. Value is always the fixed string `games#achievementDefinitionsListResponse`. |\n| `nextPageToken` | `string` Token corresponding to the next page of results. |\n| `items[]` | `object (`[AchievementDefinition](/games/services/web/api/rest/v1/achievementDefinitions/list#AchievementDefinition)`)` The achievement definitions. |\n\n### Authorization scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://www.googleapis.com/auth/games`\n- `\n https://www.googleapis.com/auth/games_lite`\n\nFor more information, see the [OAuth 2.0 Overview](https://developers.google.com/identity/protocols/OAuth2).\n\nAchievementDefinition\n---------------------\n\nAn achievement definition object.\n\n| JSON representation |\n|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"kind\": string, \"id\": string, \"name\": string, \"description\": string, \"achievementType\": enum (/games/services/web/api/rest/v1/achievementDefinitions/list#AchievementType), \"totalSteps\": integer, \"formattedTotalSteps\": string, \"revealedIconUrl\": string, \"isRevealedIconUrlDefault\": boolean, \"unlockedIconUrl\": string, \"isUnlockedIconUrlDefault\": boolean, \"initialState\": enum (/games/services/web/api/rest/v1/achievementDefinitions/list#InitialAchievementState), \"experiencePoints\": string } ``` |\n\n| Fields ||\n|----------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `kind` | `string` Uniquely identifies the type of this resource. Value is always the fixed string `games#achievementDefinition`. |\n| `id` | `string` The ID of the achievement. |\n| `name` | `string` The name of the achievement. |\n| `description` | `string` The description of the achievement. |\n| `achievementType` | `enum (`[AchievementType](/games/services/web/api/rest/v1/achievementDefinitions/list#AchievementType)`)` The type of the achievement. |\n| `totalSteps` | `integer` The total steps for an incremental achievement. |\n| `formattedTotalSteps` | `string` The total steps for an incremental achievement as a string. |\n| `revealedIconUrl` | `string` The image URL for the revealed achievement icon. |\n| `isRevealedIconUrlDefault` | `boolean` Indicates whether the revealed icon image being returned is a default image, or is provided by the game. |\n| `unlockedIconUrl` | `string` The image URL for the unlocked achievement icon. |\n| `isUnlockedIconUrlDefault` | `boolean` Indicates whether the unlocked icon image being returned is a default image, or is game-provided. |\n| `initialState` | `enum (`[InitialAchievementState](/games/services/web/api/rest/v1/achievementDefinitions/list#InitialAchievementState)`)` The initial state of the achievement. |\n| `experiencePoints` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` Experience points which will be earned when unlocking this achievement. |\n\nAchievementType\n---------------\n\nPossible achievement types.\n\n| Enums ||\n|---------------|-------------------------------------------|\n| `STANDARD` | Achievement is either locked or unlocked. |\n| `INCREMENTAL` | Achievement is incremental. |\n\nInitialAchievementState\n-----------------------\n\nPossible initial states of an achievement.\n\n| Enums ||\n|------------|--------------------------|\n| `HIDDEN` | Achievement is hidden. |\n| `REVEALED` | Achievement is revealed. |\n| `UNLOCKED` | Achievement is unlocked. |"]]
