REST Resource: players

Resource: Player

Resource Pemutar.

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 pemain.
displayName

string

Nama yang akan ditampilkan untuk pemain.
avatarImageUrl

string

URL dasar untuk gambar yang mewakili pemain.
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 login ke game yang dimaksud. Ini hanya diisi untuk panggilan ke player.get untuk pemain 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 terlihat oleh pemain lain atau tidak.
name

object

Representasi objek dari setiap komponen nama pemain. Untuk beberapa pemain, kolom ini mungkin tidak ada.
name.familyName

string

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

string

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

object (PlayerExperienceInfo)

Objek untuk merepresentasikan informasi pengalaman Play Game bagi pemain.
title

string

Gelar pemain yang diberikan sebagai reward atas aktivitas game mereka.
friendStatus

enum (FriendStatus)

Status teman pemain tertentu, relatif terhadap pemohon. Ini tidak ditetapkan jika pemain tidak membagikan daftar teman mereka 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. Nilainya 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 terlihat 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 Android API untuk menampilkan dialog izin.
UNAVAILABLE Daftar teman saat ini tidak tersedia untuk pengguna ini, dan Anda tidak dapat meminta akses saat ini, baik karena pengguna telah menolak secara permanen atau fitur teman tidak tersedia untuknya. Dalam status ini, setiap 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. Nilainya 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 milidetik sejak epoch Unix UTC.
currentLevel

object (PlayerLevel)

Level pemain saat ini.
nextLevel

object (PlayerLevel)

Level pemain berikutnya. Jika level saat ini adalah level maksimum, nilai 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. Nilainya 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 pertemanan antarpemain.

Enum
NO_RELATIONSHIP Tidak ada hubungan antara pemain.
FRIEND Pemain dan pemohon adalah teman.

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 cakupan untuk pengguna yang saat ini diautentikasi.

list

 Mendapatkan kumpulan pemain untuk pengguna yang saat ini diautentikasi.