REST Resource: players

Resource: Player

Resource Pemain.

Representasi JSON 
{
  "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
}
Kolom
kind

string

Secara unik mengidentifikasi jenis resource ini. Nilai selalu berupa string tetap games#player
playerId

string

ID pemutar.
displayName

string

Nama yang akan ditampilkan untuk pemutar.
avatarImageUrl

string

URL dasar untuk gambar yang mewakili pemutar.
bannerUrlPortrait

string

URL ke gambar banner pemutar mode potret.
bannerUrlLandscape

string

URL ke gambar banner pemutar mode lanskap.
originalPlayerId

string

ID pemain yang digunakan untuk pemain ini saat pertama kali mereka login ke game yang dimaksud. Ini hanya diisi untuk panggilan ke player.get untuk pemutar yang meminta, hanya jika ID pemain kemudian berubah, dan hanya untuk klien yang mendukung pemetaan ulang ID pemain.
profileSettings

object (ProfileSettings)

Setelan profil pemain. Mengontrol apakah profil pemain dapat dilihat oleh pemain lain atau tidak.
name

object

Representasi objek dari masing-masing komponen nama pemain. Kolom ini mungkin tidak ada untuk beberapa pemain.
name.familyName

string

Nama keluarga pemain ini. Di beberapa tempat, ini dikenal sebagai nama belakang.
name.givenName

string

Nama depan pemain ini. Di beberapa tempat, ini dikenal sebagai nama depan.
experienceInfo

object (PlayerExperienceInfo)

Objek untuk merepresentasikan informasi pengalaman Play Game bagi pemain.
title

string

Judul pemain diberikan untuk aktivitas game mereka.
friendStatus

enum (FriendStatus)

Status teman dari pemain tertentu, relatif terhadap pemohon. Setelan ini tidak disetel jika pemain tidak membagikan daftar temannya dengan game.
gamePlayerId

string

ID pemain unik per aplikasi.

ProfileSettings

Setelan profil

Representasi JSON 
{
  "kind": string,
  "profileVisible": boolean,
  "friendsListVisibility": enum (FriendsListVisibility)
}
Kolom
kind

string

Secara unik mengidentifikasi jenis resource ini. Nilai selalu berupa string tetap games#profileSettings.
profileVisible

boolean

Apakah profil pemain dapat dilihat oleh pemain yang saat ini login.
friendsListVisibility

enum (FriendsListVisibility)

FriendsListVisibility

Apakah daftar teman pemain dapat dilihat oleh game ini, atau dapat diminta. Kolom ini hanya diisi untuk pemain yang saat ini login.

Enum
VISIBLE Daftar teman saat ini dapat dilihat oleh game.
REQUEST_REQUIRED Developer tidak memiliki akses ke daftar teman, tetapi dapat memanggil API Android untuk menampilkan dialog izin.
UNAVAILABLE Daftar teman tidak tersedia untuk pengguna ini, dan untuk saat ini Anda tidak dapat meminta akses, baik karena pengguna telah menolak secara permanen atau fitur teman tidak tersedia baginya. Dalam status ini, semua upaya untuk meminta akses ke daftar teman tidak akan berhasil.

PlayerExperienceInfo

Metadata pihak pertama/pihak ketiga tentang pengalaman pemain.

Representasi JSON 
{
  "kind": string,
  "currentExperiencePoints": string,
  "lastLevelUpTimestampMillis": string,
  "currentLevel": {
    object (PlayerLevel)
  },
  "nextLevel": {
    object (PlayerLevel)
  }
}
Kolom
kind

string

Secara unik mengidentifikasi jenis resource ini. Nilai selalu berupa string tetap games#playerExperienceInfo.
currentExperiencePoints

string (int64 format)

Jumlah poin pengalaman saat ini untuk pemain.
lastLevelUpTimestampMillis

string (int64 format)

Stempel waktu saat pemain naik level, dalam ribuan sejak Unix epoch UTC.
currentLevel

object (PlayerLevel)

Level pemain saat ini.
nextLevel

object (PlayerLevel)

Level pemain berikutnya. Jika level saat ini adalah level maksimum, ini harus sama dengan level saat ini.

PlayerLevel

Metadata pihak pertama/pihak ketiga tentang level pengguna.

Representasi JSON 
{
  "kind": string,
  "level": integer,
  "minExperiencePoints": string,
  "maxExperiencePoints": string
}
Kolom
kind

string

Secara unik mengidentifikasi jenis resource ini. Nilai selalu berupa string tetap games#playerLevel.
level

integer

Level untuk pengguna.
minExperiencePoints

string (int64 format)

Poin pengalaman minimum untuk level ini.
maxExperiencePoints

string (int64 format)

Poin pengalaman maksimum untuk level ini.

FriendStatus

Menentukan hubungan persahabatan di antara pemain.

Enum
NO_RELATIONSHIP Tidak ada hubungan di antara para pemain.
FRIEND Pemain dan pemohon berteman.

Metode

get

 Mengambil resource Pemain dengan ID yang diberikan.

getMultipleApplicationPlayerIds

 Dapatkan ID pemain aplikasi untuk pemain yang saat ini diautentikasi di semua game yang diminta oleh developer yang sama dengan aplikasi panggilan.

getScopedPlayerIds

 Mengambil ID pemain terbatas untuk pengguna yang saat ini diautentikasi.

list

 Dapatkan kumpulan pemain untuk pengguna yang saat ini diautentikasi.