Applications: listHidden

Yetkilendirme gerektirir

Belirtilen uygulamadan gizlenen oyuncuları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 Yanıtta döndürülecek ve sayfalama için kullanılan maksimum oynatıcı kaynağı sayısı. Yanıtlar için döndürülen gerçek oyuncu kaynağı sayısı, belirtilen maxResults değerinden az olabilir. Kabul edilebilir değerler 1 - 15 (bu değerler dahil) arasındadır.
pageToken string Önceki istek tarafından döndürülen jeton.

Yetkilendirme

Bu istek, aşağıdaki kapsamla yetkilendirme gerektirir (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 gamesManagement#hiddenPlayerList sabit 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 gamesManagement#hiddenPlayer sabit 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 gamesManagement#player sabit 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ış geçerli oyuncuyla çok oyunculu bir oyunu en son ne zaman oynadığı hakkında ayrıntılar. PLAYED_WITH oyuncu koleksiyonu üyeleri için doldurulur.
items[].player.lastPlayedWith.timeMillis long Oyuncunun, UTC saat diliminde sıfırdan bu yana oyunu milisaniye cinsinden en son oynadığı zaman.
items[].player.lastPlayedWith.autoMatched boolean Oynatıcı, geçerli olarak kimliği doğrulanmış kullanıcıyla otomatik olarak eşleştirildiyse doğru değerini döndürür.
items[].player.name object Oyuncu adının bağımsız bileşenlerinin bir nesne gösterimi. Bazı oyuncularda bu alanlar mevcut olmayabilir.
items[].player.name.familyName string Bu oyuncunun aile adı. Bazı yerlerde bu, soyadı olarak bilinir.
items[].player.name.givenName string Bu oyuncuya verilen ad. Bazı yerlerde bu, ad olarak bilinir.
items[].player.experienceInfo nested object Oyuncu için Play Oyun deneyimi bilgilerini temsil eden bir nesne.
items[].player.experienceInfo.currentExperiencePoints long Oyuncu için mevcut deneyim puanı sayısı.
items[].player.experienceInfo.lastLevelUpTimestampMillis long Unix dönemi UTC'den bu yana oynatıcının seviye atladığı zamanın zaman damgası (milisaniye).
items[].player.experienceInfo.currentLevel nested object Oyuncunun 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. Mevcut seviye maksimum seviye ise, bu seviye geçerli düzeyle 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 faaliyetlerinin karşılığıdır.
items[].hiddenTimeMillis long Bu oyuncunun gizlendiği zaman.