Method: achievements.list
Koleksiyonlar ile düzeninizi koruyun
İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.
Kimliği doğrulanmış olan oynatıcı için uygulamanızın tüm başarılarının ilerleme durumunu listeler.
HTTP isteği
GET https://games.googleapis.com/games/v1/players/{playerId}/achievements
Yol parametreleri
| Parametreler |
playerId |
string
Oynatıcı kimliği. me değeri, kimliği doğrulanmış oynatıcının kimliği yerine kullanılabilir.
|
Sorgu parametreleri
| Parametreler |
language |
string
Bu yöntemin döndürdüğü dizeler için kullanılması tercih edilen dil.
|
maxResults |
integer
Sayfalara ayırma için kullanılan, yanıtta döndürülecek maksimum başarı kaynağı sayısı. Tüm yanıtlar için döndürülen başarı kaynaklarının sayısı, belirtilen maxResults değerinden az olabilir.
|
pageToken |
string
Önceki istek tarafından döndürülen jeton.
|
state |
enum (State)
Sunucuya yalnızca belirtilen durumdaki başarıları döndürmesini söyler. Bu parametre belirtilmezse tüm başarılar döndürülür.
|
İstek içeriği
İstek metni boş olmalıdır.
Yanıt gövdesi
Başarı nesnelerinin listesi.
Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:
| JSON gösterimi |
{
"kind": string,
"nextPageToken": string,
"items": [
{
object (PlayerAchievement)
}
]
} |
| Alanlar |
kind |
string
Bu kaynağın türünü benzersiz bir şekilde tanımlar. Değer her zaman sabit games#playerAchievementListResponse dizesidir.
|
nextPageToken |
string
Sonraki sonuç sayfasına karşılık gelen jeton.
|
items[] |
object (PlayerAchievement)
Başarılar.
|
Yetkilendirme kapsamları
Aşağıdaki OAuth kapsamlarından birini gerektirir:
https://www.googleapis.com/auth/games
https://www.googleapis.com/auth/games_lite
Daha fazla bilgi için OAuth 2.0 Overview (OAuth 2.0'a Genel Bakış) sayfasına göz atın.
Eyalet
| Sıralamalar |
ALL |
Tüm başarıları listele. Bu, varsayılan ayardır. |
HIDDEN |
Yalnızca gizli başarıları listele. |
REVEALED |
Yalnızca gösterilen başarıları listele. |
UNLOCKED |
Yalnızca kilidi açılan başarıları listele. |
PlayerAchievement
| JSON gösterimi |
{
"kind": string,
"id": string,
"currentSteps": integer,
"formattedCurrentStepsString": string,
"achievementState": enum (State),
"lastUpdatedTimestamp": string,
"experiencePoints": string
} |
| Alanlar |
kind |
string
Bu kaynağın türünü benzersiz bir şekilde tanımlar. Değer her zaman sabit games#playerAchievement dizesidir.
|
id |
string
Başarının kimliği.
|
currentSteps |
integer
Artımlı bir başarı için mevcut adımlar.
|
formattedCurrentStepsString |
string
Dize halinde artımlı bir başarı için geçerli adımlar.
|
achievementState |
enum (State)
Başarının durumu.
|
lastUpdatedTimestamp |
string (int64 format)
Bu başarının durumunda yapılan son değişikliğin zaman damgası.
|
experiencePoints |
string (int64 format)
Başarı için kazanılan deneyim puanları. Bu alan, henüz kilidi açılmamış başarılar için eksik, test kullanıcıları tarafından kilidi açılan ancak yayınlanmamış başarılar için 0 değerini alır.
|
Eyalet
Bir başarının olası durumlarını tanımlar.
| Sıralamalar |
HIDDEN |
Başarı gizlendi. |
REVEALED |
Başarı açıklandı. |
UNLOCKED |
Başarının kilidi açıldı. |
Bu sayfadaki içerik ve kod örnekleri, İçerik Lisansı sayfasında açıklanan lisanslara tabidir. Java ve OpenJDK, Oracle ve/veya satış ortaklarının tescilli ticari markasıdır.
Son güncelleme tarihi: 2025-07-27 UTC.
[null,null,["Son güncelleme tarihi: 2025-07-27 UTC."],[],[],null,["# Method: achievements.list\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n - [JSON representation](#body.ListAchievementsResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [State](#State)\n- [PlayerAchievement](#PlayerAchievement)\n - [JSON representation](#PlayerAchievement.SCHEMA_REPRESENTATION)\n- [State](#State_1)\n- [Try it!](#try-it)\n\nLists the progress for all your application's achievements for the currently authenticated player.\n\n### HTTP request\n\n`GET https://games.googleapis.com/games/v1/players/{playerId}/achievements`\n\n### Path parameters\n\n| Parameters ||\n|------------|----------------------------------------------------------------------------------------------|\n| `playerId` | `string` A player ID. A value of `me` may be used in place of the authenticated player's ID. |\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| `state` | `enum (`[State](/games/services/web/api/rest/v1/achievements/list#State)`)` Tells the server to return only achievements with the specified state. If this parameter isn't specified, all achievements are returned. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nA list of achievement 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/achievements/list#PlayerAchievement) } ] } ``` |\n\n| Fields ||\n|-----------------|---------------------------------------------------------------------------------------------------------------------------------|\n| `kind` | `string` Uniquely identifies the type of this resource. Value is always the fixed string `games#playerAchievementListResponse`. |\n| `nextPageToken` | `string` Token corresponding to the next page of results. |\n| `items[]` | `object (`[PlayerAchievement](/games/services/web/api/rest/v1/achievements/list#PlayerAchievement)`)` The achievements. |\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\nState\n-----\n\n| Enums ||\n|------------|---------------------------------------------|\n| `ALL` | List all achievements. This is the default. |\n| `HIDDEN` | List only hidden achievements. |\n| `REVEALED` | List only revealed achievements. |\n| `UNLOCKED` | List only unlocked achievements. |\n\nPlayerAchievement\n-----------------\n\nAn achievement object.\n\n| JSON representation |\n|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"kind\": string, \"id\": string, \"currentSteps\": integer, \"formattedCurrentStepsString\": string, \"achievementState\": enum (/games/services/web/api/rest/v1/achievements/list#State_1), \"lastUpdatedTimestamp\": string, \"experiencePoints\": string } ``` |\n\n| Fields ||\n|-------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `kind` | `string` Uniquely identifies the type of this resource. Value is always the fixed string `games#playerAchievement`. |\n| `id` | `string` The ID of the achievement. |\n| `currentSteps` | `integer` The current steps for an incremental achievement. |\n| `formattedCurrentStepsString` | `string` The current steps for an incremental achievement as a string. |\n| `achievementState` | `enum (`[State](/games/services/web/api/rest/v1/achievements/list#State_1)`)` The state of the achievement. |\n| `lastUpdatedTimestamp` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` The timestamp of the last modification to this achievement's state. |\n| `experiencePoints` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` Experience points earned for the achievement. This field is absent for achievements that have not yet been unlocked and 0 for achievements that have been unlocked by testers but that are unpublished. |\n\nState\n-----\n\nDefines possible states of an achievement.\n\n| Enums ||\n|------------|--------------------------|\n| `HIDDEN` | Achievement is hidden. |\n| `REVEALED` | Achievement is revealed. |\n| `UNLOCKED` | Achievement is unlocked. |"]]
