Method: achievements.list

Mencantumkan progres semua pencapaian aplikasi Anda untuk pemain yang saat ini diautentikasi.

Permintaan HTTP

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

Parameter jalur

Parameter
playerId

string

ID pemain. Nilai me dapat digunakan sebagai pengganti ID pemain yang diautentikasi.

Parameter kueri

Parameter
language

string

Bahasa yang dipilih untuk digunakan untuk string yang ditampilkan oleh metode ini.
maxResults

integer

Jumlah maksimum resource pencapaian untuk ditampilkan dalam respons, yang digunakan untuk paging. Untuk respons apa pun, jumlah resource pencapaian sebenarnya yang ditampilkan mungkin lebih kecil dari maxResults yang ditentukan.
pageToken

string

Token yang ditampilkan oleh permintaan sebelumnya.
state

enum (State)

Memberi tahu server untuk hanya menampilkan pencapaian dengan status yang ditentukan. Jika parameter ini tidak ditentukan, semua pencapaian akan ditampilkan.

Isi permintaan

Isi permintaan harus kosong.

Isi respons

Daftar objek pencapaian.

Jika berhasil, isi respons memuat data dengan struktur berikut:

Representasi JSON 
{
  "kind": string,
  "nextPageToken": string,
  "items": [
    {
      object (PlayerAchievement)
    }
  ]
}
Kolom
kind

string

Secara unik mengidentifikasi jenis resource ini. Nilai selalu berupa string tetap games#playerAchievementListResponse.
nextPageToken

string

Token yang sesuai dengan halaman hasil berikutnya.
items[]

object (PlayerAchievement)

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.

Negara Bagian

Enum
ALL Mencantumkan semua pencapaian. Ini adalah defaultnya.
HIDDEN Hanya cantumkan pencapaian tersembunyi.
REVEALED Hanya cantumkan pencapaian yang diungkapkan.
UNLOCKED Hanya cantumkan pencapaian yang terbuka.

PlayerAchievement

Objek pencapaian.

Representasi JSON 
{
  "kind": string,
  "id": string,
  "currentSteps": integer,
  "formattedCurrentStepsString": string,
  "achievementState": enum (State),
  "lastUpdatedTimestamp": string,
  "experiencePoints": string
}
Kolom
kind

string

Secara unik mengidentifikasi jenis resource ini. Nilai selalu berupa string tetap games#playerAchievement.
id

string

ID pencapaian.
currentSteps

integer

Langkah-langkah saat ini untuk pencapaian inkremental.
formattedCurrentStepsString

string

Langkah-langkah saat ini untuk pencapaian inkremental sebagai string.
achievementState

enum (State)

Status pencapaian.
lastUpdatedTimestamp

string (int64 format)

Stempel waktu modifikasi terakhir ke status pencapaian ini.
experiencePoints

string (int64 format)

Poin pengalaman yang diperoleh untuk pencapaian. Kolom ini tidak ada untuk pencapaian yang belum dibuka dan 0 untuk pencapaian yang telah dibuka oleh penguji, tetapi belum dipublikasikan.

Negara Bagian

Menentukan kemungkinan status pencapaian.

Enum
HIDDEN Pencapaian disembunyikan.
REVEALED Pencapaian terungkap.
UNLOCKED Pencapaian terbuka.