Memerlukan otorisasi
Mendapatkan daftar pemain yang disembunyikan dari aplikasi yang diberikan. Metode ini hanya tersedia untuk akun pengguna di konsol developer Anda.
Minta
Permintaan HTTP
GET https://www.googleapis.com/games/v1management/applications/applicationId/players/hidden
Parameter
Nama parameter | Nilai | Deskripsi |
---|---|---|
Parameter jalur | ||
applicationId |
string |
ID aplikasi dari Konsol Google Play. |
Parameter kueri opsional | ||
maxResults |
integer |
Jumlah maksimum resource pemain yang akan ditampilkan dalam respons, yang digunakan untuk paging. Untuk respons apa pun, jumlah sebenarnya resource pemain yang ditampilkan mungkin kurang dari maxResults yang ditentukan.
Nilai yang dapat diterima adalah 1 hingga 15 , inklusif.
|
pageToken |
string |
Token yang ditampilkan oleh permintaan sebelumnya. |
Otorisasi
Permintaan ini memerlukan otorisasi dengan cakupan berikut (baca selengkapnya tentang autentikasi dan otorisasi).
Cakupan |
---|
https://www.googleapis.com/auth/games |
Isi permintaan
Jangan berikan isi permintaan dengan metode ini.
Respons
Jika berhasil, metode ini akan menampilkan isi respons dengan struktur berikut:
{ "kind": "gamesManagement#hiddenPlayerList", "nextPageToken": string, "items": [ { "kind": "gamesManagement#hiddenPlayer", "player": { "kind": "gamesManagement#player", "playerId": string, "displayName": string, "avatarImageUrl": string, "lastPlayedWith": { "timeMillis": long, "autoMatched": boolean }, "name": { "familyName": string, "givenName": string }, "experienceInfo": { "currentExperiencePoints": long, "lastLevelUpTimestampMillis": long, "currentLevel": { "level": integer, "minExperiencePoints": long, "maxExperiencePoints": long }, "nextLevel": { "level": integer, "minExperiencePoints": long, "maxExperiencePoints": long } }, "title": string }, "hiddenTimeMillis": long } ] }
Nama properti | Nilai | Deskripsi | Catatan |
---|---|---|---|
kind |
string |
Secara unik mengidentifikasi jenis resource ini. Nilainya selalu berupa string tetap gamesManagement#hiddenPlayerList . |
|
nextPageToken |
string |
Token penomoran halaman untuk halaman hasil berikutnya. | |
items[] |
list |
Pemain. | |
items[].kind |
string |
Secara unik mengidentifikasi jenis resource ini. Nilainya selalu berupa string tetap gamesManagement#hiddenPlayer . |
|
items[].player |
nested object |
Informasi pemain. | |
items[].player.kind |
string |
Secara unik mengidentifikasi jenis resource ini. Nilainya selalu berupa string tetap gamesManagement#player . |
|
items[].player.playerId |
string |
ID pemain. | |
items[].player.displayName |
string |
Nama yang akan ditampilkan untuk pemain. | |
items[].player.avatarImageUrl |
string |
URL dasar untuk gambar yang mewakili pemain. | |
items[].player.lastPlayedWith |
nested object |
Detail tentang terakhir kali pemain ini memainkan game multiplayer dengan pemain yang saat ini diautentikasi. Diisi untuk anggota koleksi pemain PLAYED_WITH. | |
items[].player.lastPlayedWith.timeMillis |
long |
Waktu terakhir pemain memainkan game dalam milidetik sejak epoch dalam UTC. | |
items[].player.lastPlayedWith.autoMatched |
boolean |
Benar jika pemain dicocokkan secara otomatis dengan pengguna yang saat ini diautentikasi. | |
items[].player.name |
object |
Representasi objek dari setiap komponen nama pemain. Untuk beberapa pemain, kolom ini mungkin tidak ada. | |
items[].player.name.familyName |
string |
Nama keluarga pemain ini. Di beberapa tempat, nama ini dikenal sebagai nama belakang. | |
items[].player.name.givenName |
string |
Nama yang diberikan untuk pemain ini. Di beberapa tempat, nama ini dikenal sebagai nama depan. | |
items[].player.experienceInfo |
nested object |
Objek untuk merepresentasikan informasi pengalaman Play Game bagi pemain. | |
items[].player.experienceInfo.currentExperiencePoints |
long |
Jumlah poin pengalaman saat ini untuk pemain. | |
items[].player.experienceInfo.lastLevelUpTimestampMillis |
long |
Stempel waktu saat pemain naik level, dalam milidetik sejak epoch Unix UTC. | |
items[].player.experienceInfo.currentLevel |
nested object |
Level pemain saat ini. | |
items[].player.experienceInfo.currentLevel.level |
integer |
Level untuk pengguna. | |
items[].player.experienceInfo.currentLevel.minExperiencePoints |
long |
Poin pengalaman minimum untuk level ini. | |
items[].player.experienceInfo.currentLevel.maxExperiencePoints |
long |
Poin pengalaman maksimum untuk level ini. | |
items[].player.experienceInfo.nextLevel |
nested object |
Level pemain berikutnya. Jika level saat ini adalah level maksimum, nilai ini harus sama dengan level saat ini. | |
items[].player.experienceInfo.nextLevel.level |
integer |
Level untuk pengguna. | |
items[].player.experienceInfo.nextLevel.minExperiencePoints |
long |
Poin pengalaman minimum untuk level ini. | |
items[].player.experienceInfo.nextLevel.maxExperiencePoints |
long |
Poin pengalaman maksimum untuk level ini. | |
items[].player.title |
string |
Gelar pemain yang diberikan sebagai reward atas aktivitas game mereka. |