Yetkilendirme gerektiriyor
Belirtilen uygulamada gizlenen oynatıcıların listesini alın. Bu yöntem yalnızca geliştirici konsolunuzdaki kullanıcı hesapları tarafından kullanılabilir.
İstek
HTTP isteği
GET https://www.googleapis.com/games/v1management/applications/applicationId/players/hidden
Parametreler
Parametre adı | Değer | Açıklama |
---|---|---|
Yol parametreleri | ||
applicationId |
string |
Google Play Console'daki uygulama kimliği. |
İsteğe bağlı sorgu parametreleri | ||
maxResults |
integer |
Sayfalara ayırma için kullanılan, yanıtta döndürülecek maksimum oynatıcı kaynağı sayısı. Herhangi bir yanıt için döndürülen oyuncu kaynaklarının gerçek sayısı, belirtilen maxResults değerinden az olabilir.
Kabul edilebilir değerler: 1 - 15 (bu değerler dahil).
|
pageToken |
string |
Önceki istek tarafından döndürülen jeton. |
Yetkilendirme
Bu istek, aşağıdaki kapsamla yetkilendirme gerektiriyor (kimlik doğrulama ve yetkilendirme hakkında daha fazla bilgi edinin).
Kapsam |
---|
https://www.googleapis.com/auth/games |
İstek içeriği
Bu yöntemle istek gövdesi sağlamayın.
Yanıt
Başarılı olursa bu yöntem, aşağıdaki yapıya sahip bir yanıt gövdesi döndürür:
{ "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 } ] }
Mülk adı | Değer | Açıklama | Notlar |
---|---|---|---|
kind |
string |
Bu kaynağın türünü benzersiz bir şekilde tanımlar. Değer her zaman sabit gamesManagement#hiddenPlayerList dizesidir. |
|
nextPageToken |
string |
Sonraki sonuç sayfası için sayfalara ayırma jetonu. | |
items[] |
list |
Oyuncular. | |
items[].kind |
string |
Bu kaynağın türünü benzersiz bir şekilde tanımlar. Değer her zaman sabit gamesManagement#hiddenPlayer dizesidir. |
|
items[].player |
nested object |
Oynatıcı bilgileri. | |
items[].player.kind |
string |
Bu kaynağın türünü benzersiz bir şekilde tanımlar. Değer her zaman sabit gamesManagement#player dizesidir. |
|
items[].player.playerId |
string |
Oynatıcının kimliği. | |
items[].player.displayName |
string |
Oynatıcı için gösterilecek ad. | |
items[].player.avatarImageUrl |
string |
Oynatıcıyı temsil eden resmin temel URL'si. | |
items[].player.lastPlayedWith |
nested object |
Bu oyuncunun, kimliği doğrulanmış oyuncuyla en son ne zaman çok oyunculu bir oyun oynadığıyla ilgili ayrıntılar. PLAYED_WITH oyuncu koleksiyonu üyeleri için doldurulur. | |
items[].player.lastPlayedWith.timeMillis |
long |
Oyuncunun, UTC zaman diliminden bu yana geçen milisaniye cinsinden oyunu en son oynadığı zaman. | |
items[].player.lastPlayedWith.autoMatched |
boolean |
Oynatıcı, kimliği doğrulanmış kullanıcıyla otomatik olarak eşleşiyorsa doğru değerini döndürür. | |
items[].player.name |
object |
Oyuncu adının bağımsız bileşenlerinin nesne gösterimi. Bazı oyuncular için bu alanlar mevcut olmayabilir. | |
items[].player.name.familyName |
string |
Bu oyuncunun soyadı. Bazı yerlerde bu soyadına soyadı denir. | |
items[].player.name.givenName |
string |
Bu oyuncuya verilen ad. Bazı yerlerde bu ada ad olarak bilinir. | |
items[].player.experienceInfo |
nested object |
Oyuncu için Play Oyun deneyimi bilgilerini temsil eden bir nesne. | |
items[].player.experienceInfo.currentExperiencePoints |
long |
Oyuncunun mevcut deneyim puanı sayısı. | |
items[].player.experienceInfo.lastLevelUpTimestampMillis |
long |
Unix döneminden (UTC) bu yana oyuncuya seviye atlatıldığından milisaniye cinsinden zaman damgası. | |
items[].player.experienceInfo.currentLevel |
nested object |
Oynatıcının mevcut seviyesi. | |
items[].player.experienceInfo.currentLevel.level |
integer |
Kullanıcının düzeyi. | |
items[].player.experienceInfo.currentLevel.minExperiencePoints |
long |
Bu seviye için minimum deneyim puanı. | |
items[].player.experienceInfo.currentLevel.maxExperiencePoints |
long |
Bu seviye için maksimum deneyim puanı. | |
items[].player.experienceInfo.nextLevel |
nested object |
Oyuncunun bir sonraki seviyesi. Geçerli seviye maksimum seviyeyse bu seviye ile aynı olmalıdır. | |
items[].player.experienceInfo.nextLevel.level |
integer |
Kullanıcının düzeyi. | |
items[].player.experienceInfo.nextLevel.minExperiencePoints |
long |
Bu seviye için minimum deneyim puanı. | |
items[].player.experienceInfo.nextLevel.maxExperiencePoints |
long |
Bu seviye için maksimum deneyim puanı. | |
items[].player.title |
string |
Oyuncunun unvanı, oyun etkinlikleri için ödüllendirilir. |