Memerlukan otorisasi
Mendapatkan daftar pemain yang disembunyikan dari aplikasi tertentu. Metode ini hanya tersedia untuk akun pengguna konsol developer Anda.
Permintaan
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 untuk ditampilkan dalam respons, yang digunakan untuk paging. Untuk respons apa pun, jumlah resource pemutar sebenarnya 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 memberikan 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. Nilai selalu berupa string tetap gamesManagement#hiddenPlayerList . |
|
nextPageToken |
string |
Token penomoran halaman untuk halaman hasil berikutnya. | |
items[] |
list |
Para pemain. | |
items[].kind |
string |
Secara unik mengidentifikasi jenis resource ini. Nilai selalu berupa string tetap gamesManagement#hiddenPlayer . |
|
items[].player |
nested object |
Informasi pemain. | |
items[].player.kind |
string |
Secara unik mengidentifikasi jenis resource ini. Nilai selalu berupa string tetap gamesManagement#player . |
|
items[].player.playerId |
string |
ID pemain. | |
items[].player.displayName |
string |
Nama yang akan ditampilkan oleh pemutar. | |
items[].player.avatarImageUrl |
string |
URL dasar untuk gambar yang mewakili pemutar. | |
items[].player.lastPlayedWith |
nested object |
Detail tentang kapan terakhir kali pemain ini bermain game multiplayer dengan pemain yang saat ini diautentikasi. Diisi untuk anggota koleksi pemutar PLAYED_WITH. | |
items[].player.lastPlayedWith.timeMillis |
long |
Terakhir kali pemain memainkan game dalam milidetik sejak epoch dalam UTC. | |
items[].player.lastPlayedWith.autoMatched |
boolean |
True jika pemain dicocokkan secara otomatis dengan pengguna yang saat ini diautentikasi. | |
items[].player.name |
object |
Representasi objek dari komponen individual dari nama pemain. Untuk beberapa pemain, kolom ini mungkin tidak ada. | |
items[].player.name.familyName |
string |
Nama belakang pemain ini. Di beberapa tempat, nama ini dikenal sebagai nama belakang. | |
items[].player.name.givenName |
string |
Nama depan pemain ini. Di beberapa tempat, nama ini dikenal sebagai nama depan. | |
items[].player.experienceInfo |
nested object |
Objek untuk mewakili 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 ribuan 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, 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 |
Judul pemain yang diberikan reward karena aktivitas game mereka. |