Memerlukan otorisasi
Mendapatkan daftar pemain yang disembunyikan dari aplikasi tertentu. Metode ini hanya tersedia untuk akun pengguna untuk 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 pemutar yang 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 lebih lanjut 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. 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 pemutar. | |
items[].player.kind |
string |
Secara unik mengidentifikasi jenis resource ini. Nilai selalu berupa string tetap gamesManagement#player . |
|
items[].player.playerId |
string |
ID pemutar. | |
items[].player.displayName |
string |
Nama yang akan ditampilkan untuk pemutar. | |
items[].player.avatarImageUrl |
string |
URL dasar untuk gambar yang mewakili pemutar. | |
items[].player.lastPlayedWith |
nested object |
Detail tentang waktu terakhir kali pemain ini bermain game multiplayer dengan pemain yang saat ini diautentikasi. Diisi untuk anggota koleksi pemain 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 pemutar dicocokkan secara otomatis dengan pengguna yang saat ini diautentikasi. | |
items[].player.name |
object |
Representasi objek dari masing-masing komponen nama pemain. Kolom ini mungkin tidak ada untuk beberapa pemain. | |
items[].player.name.familyName |
string |
Nama keluarga pemain ini. Di beberapa tempat, ini dikenal sebagai nama belakang. | |
items[].player.name.givenName |
string |
Nama depan pemain ini. Di beberapa tempat, 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 ribuan sejak Unix epoch 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 diberikan untuk aktivitas game mereka. |