Method: achievements.list

Mencantumkan progres untuk semua pencapaian aplikasi Anda bagi 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 lebih disukai untuk 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.
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 berisi data dengan struktur berikut:

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

string

Secara unik mengidentifikasi jenis resource ini. Nilainya 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.

Status

Enum
ALL Mencantumkan semua pencapaian. Ini adalah defaultnya.
HIDDEN Hanya mencantumkan pencapaian tersembunyi.
REVEALED Hanya menampilkan pencapaian yang terungkap.
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. Nilainya selalu berupa string tetap games#playerAchievement.
id

string

ID pencapaian.
currentSteps

integer

Langkah saat ini untuk pencapaian inkremental.
formattedCurrentStepsString

string

Langkah saat ini untuk pencapaian inkremental sebagai string.
achievementState

enum (State)

Status pencapaian.
lastUpdatedTimestamp

string (int64 format)

Stempel waktu modifikasi terakhir pada 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 tidak dipublikasikan.

Status

Menentukan kemungkinan status pencapaian.

Enum
HIDDEN Pencapaian disembunyikan.
REVEALED Pencapaian ditampilkan.
UNLOCKED Pencapaian berhasil dibuka.