REST Resource: players

Kaynak: Oynatıcı

Oynatıcı kaynağı.

JSON gösterimi 
{
  "kind": string,
  "playerId": string,
  "displayName": string,
  "avatarImageUrl": string,
  "bannerUrlPortrait": string,
  "bannerUrlLandscape": string,
  "originalPlayerId": string,
  "profileSettings": {
    object (ProfileSettings)
  },
  "name": {
    "familyName": string,
    "givenName": string
  },
  "experienceInfo": {
    object (PlayerExperienceInfo)
  },
  "title": string,
  "friendStatus": enum (FriendStatus),
  "gamePlayerId": string
}
Alanlar
kind

string

Bu kaynağın türünü benzersiz bir şekilde tanımlar. Değer her zaman games#player sabit dizesidir
playerId

string

Oynatıcının kimliği.
displayName

string

Oynatıcı için gösterilecek ad.
avatarImageUrl

string

Oynatıcıyı temsil eden resmin temel URL'si.
bannerUrlPortrait

string

Dikey mod oynatıcı banner resminin URL'si.
bannerUrlLandscape

string

Yatay mod oynatıcı banner resminin URL'si.
originalPlayerId

string

Söz konusu oyunda ilk kez oturum açtığında bu oyuncu için kullanılan oyuncu kimliği. Bu alan yalnızca istekte bulunan oyuncu için, yalnızca daha sonra oyuncu kimliği değiştiyse ve yalnızca oyuncu kimliklerinin yeniden eşlenmesini destekleyen istemciler için Player.get çağrıları için doldurulur.
profileSettings

object (ProfileSettings)

Oyuncunun profil ayarları. Oyuncu profilinin diğer oyuncular tarafından görünüp görünmeyeceğini kontrol eder.
name

object

Oyuncu adının bağımsız bileşenlerinin bir nesne gösterimi. Bazı oyuncularda bu alanlar mevcut olmayabilir.
name.familyName

string

Bu oyuncunun aile adı. Bazı yerlerde bu, soyadı olarak bilinir.
name.givenName

string

Bu oyuncuya verilen ad. Bazı yerlerde bu, ad olarak bilinir.
experienceInfo

object (PlayerExperienceInfo)

Oyuncu için Play Oyun deneyimi bilgilerini temsil eden bir nesne.
title

string

Oyuncunun unvanı, oyun faaliyetlerinin karşılığıdır.
friendStatus

enum (FriendStatus)

İlgili oyuncunun istekte bulunan kişiye göre arkadaşlık durumu. Oyuncu, arkadaş listesini oyunla paylaşmıyorsa bu ayar iptal edilmez.
gamePlayerId

string

Uygulama başına benzersiz oynatıcı tanımlayıcısı.

ProfileSettings

Profil ayarları

JSON gösterimi 
{
  "kind": string,
  "profileVisible": boolean,
  "friendsListVisibility": enum (FriendsListVisibility)
}
Alanlar
kind

string

Bu kaynağın türünü benzersiz bir şekilde tanımlar. Değer her zaman games#profileSettings sabit dizesidir.
profileVisible

boolean

Oyuncu profilinin şu anda oturum açmış olan oyuncu tarafından görünür olup olmadığı.
friendsListVisibility

enum (FriendsListVisibility)

FriendsListVisibility

Oyuncunun arkadaş listesinin bu oyun tarafından görülüp görülmediği veya istenip istenmediği. Bu alan yalnızca o anda oturum açmış olan oynatıcı için doldurulur.

Sıralamalar
VISIBLE Oyun, arkadaş listesini şu anda görebilir.
REQUEST_REQUIRED Geliştiricinin arkadaş listesine erişimi yok, ancak rıza iletişim kutusunu göstermek için Android API'yi çağırabilir.
UNAVAILABLE Arkadaş listesi şu anda bu kullanıcı için kullanılamıyor ve kullanıcı kalıcı olarak reddettiği veya arkadaşlar özelliği bu kişi için kullanılabilir olmadığı için şu anda erişim isteğinde bulunulamıyor. Bu durumda arkadaş listesine erişim isteme girişimleri başarısız olur.

PlayerExperienceInfo

Oyuncunun deneyimiyle ilgili birinci/üçüncü taraf meta verileri.

JSON gösterimi 
{
  "kind": string,
  "currentExperiencePoints": string,
  "lastLevelUpTimestampMillis": string,
  "currentLevel": {
    object (PlayerLevel)
  },
  "nextLevel": {
    object (PlayerLevel)
  }
}
Alanlar
kind

string

Bu kaynağın türünü benzersiz bir şekilde tanımlar. Değer her zaman games#playerExperienceInfo sabit dizesidir.
currentExperiencePoints

string (int64 format)

Oyuncu için mevcut deneyim puanı sayısı.
lastLevelUpTimestampMillis

string (int64 format)

Unix dönemi UTC'den bu yana oynatıcının seviye atladığı zamanın zaman damgası (milisaniye).
currentLevel

object (PlayerLevel)

Oyuncunun mevcut seviyesi.
nextLevel

object (PlayerLevel)

Oyuncunun bir sonraki seviyesi. Mevcut seviye maksimum seviye ise, bu seviye geçerli düzeyle aynı olmalıdır.

PlayerLevel

Kullanıcının düzeyiyle ilgili birinci taraf/üçüncü taraf meta verileri.

JSON gösterimi 
{
  "kind": string,
  "level": integer,
  "minExperiencePoints": string,
  "maxExperiencePoints": string
}
Alanlar
kind

string

Bu kaynağın türünü benzersiz bir şekilde tanımlar. Değer her zaman games#playerLevel sabit dizesidir.
level

integer

Kullanıcının düzeyi.
minExperiencePoints

string (int64 format)

Bu seviye için minimum deneyim puanı.
maxExperiencePoints

string (int64 format)

Bu seviye için maksimum deneyim puanı.

FriendStatus

Oyuncular arasındaki arkadaşlık ilişkilerini tanımlar.

Sıralamalar
NO_RELATIONSHIP Oyuncular arasında herhangi bir ilişki yoktur.
FRIEND Oyuncu ve istek sahibi arkadaş.

Yöntemler

get

 Belirtilen kimliğe sahip Player kaynağını alır.

getMultipleApplicationPlayerIds

 Çağrı yapan uygulamayla aynı geliştirici tarafından istenen tüm oyunlarda geçerli olarak kimliği doğrulanmış oyuncunun uygulama oynatıcı kimliklerini alın.

getScopedPlayerIds

 Şu anda kimliği doğrulanmış kullanıcı için kapsamlı oynatıcı tanımlayıcılarını alır.

list

 Şu anda kimliği doğrulanmış kullanıcı için oynatıcı koleksiyonunu alın.