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 sabit games#player 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ısının banner resminin URL'si.
originalPlayerId

string

Söz konusu oyunda ilk kez oturum açan oyuncu için kullanılan oyuncu kimliği. Bu alan yalnızca oynatıcı kimliği sonradan değişmişse ve yalnızca oynatıcı kimliklerinin yeniden eşlenmesini destekleyen istemciler için istekte bulunan oynatıcı için Player.get çağrılarında doldurulur.
profileSettings

object (ProfileSettings)

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

object

Oyuncu adının bağımsız bileşenlerinin nesne gösterimi. Bazı oyuncular için bu alanlar mevcut olmayabilir.
name.familyName

string

Bu oyuncunun soyadı. Bazı yerlerde bu soyadına soyadı denir.
name.givenName

string

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

object (PlayerExperienceInfo)

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

string

Oyuncunun unvanı, oyun etkinlikleri için ödüllendirilir.
friendStatus

enum (FriendStatus)

Belirtilen oyuncunun, istekte bulunan kişiye göre arkadaş durumu. Oyuncu, arkadaş listesini oyunla paylaşmıyorsa bu ayar etkin olmaz.
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 sabit games#profileSettings dizesidir.
profileVisible

boolean

Oyuncu profilinin oturumu açık olan oyuncuya 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 şu anda oturum açmış olan oynatıcı için doldurulur.

Sıralamalar
VISIBLE Arkadaş listesi şu anda oyun tarafından görülebilir.
REQUEST_REQUIRED Geliştiricinin arkadaş listesine erişimi yok, ancak Android API'sini çağırarak rıza mesajı gösterebilir.
UNAVAILABLE Arkadaş listesi şu anda bu kullanıcı için kullanılamıyor ve erişim isteğinde bulunulamaz. Çünkü kullanıcı kalıcı olarak reddettiğinden veya arkadaşlar özelliği kendisi tarafından kullanılamamaktadır. Bu durumdayken arkadaş listesine erişim isteme girişimleriniz başarısız olur.

PlayerExperienceInfo

Oyuncunun deneyimiyle ilgili birinci taraf/3. 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 sabit games#playerExperienceInfo dizesidir.
currentExperiencePoints

string (int64 format)

Oyuncunun mevcut deneyim puanı sayısı.
lastLevelUpTimestampMillis

string (int64 format)

Unix döneminden (UTC) bu yana oyuncuya seviye atlatıldığından milisaniye cinsinden zaman damgası.
currentLevel

object (PlayerLevel)

Oynatıcının mevcut seviyesi.
nextLevel

object (PlayerLevel)

Oyuncunun bir sonraki seviyesi. Geçerli seviye maksimum seviyeyse bu seviye ile aynı olmalıdır.

PlayerLevel

Bir kullanıcının seviyesiyle ilgili birinci taraf/3. 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 sabit games#playerLevel 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 ilişki yoktur.
FRIEND Oyuncu ve istek sahibi arkadaş.

Yöntemler

get

 Belirtilen kimliğe sahip Oynatıcı kaynağını alır.

getMultipleApplicationPlayerIds

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

getScopedPlayerIds

 Kimliği doğrulanmış mevcut kullanıcının kapsamlı oynatıcı tanımlayıcılarını alır.

list

 Kimliği doğrulanmış olan kullanıcı için oynatıcı koleksiyonunu alın.