REST Resource: players

Referensi: Pemain

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 oleh pemutar.
avatarImageUrl

string

URL dasar untuk gambar yang mewakili pemutar.
bannerUrlPortrait

string

URL untuk gambar banner pemutar mode potret.
bannerUrlLandscape

string

URL untuk gambar banner pemutar mode lanskap.
originalPlayerId

string

ID pemain yang digunakan untuk pemain ini saat pertama kali login ke game yang dimaksud. Kolom ini hanya diisi untuk panggilan ke player.get untuk pemutar yang meminta, hanya jika ID pemain telah diubah, 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 komponen individual dari nama pemain. Untuk beberapa pemain, kolom ini mungkin tidak ada.
name.familyName

string

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

string

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

object (PlayerExperienceInfo)

Objek untuk mewakili informasi pengalaman Play Game bagi pemain.
title

string

Judul pemain yang diberikan reward karena aktivitas game mereka.
friendStatus

enum (FriendStatus)

Status teman dari pemain tertentu, relatif terhadap pemohon. Setelan ini tidak disetel jika pemain tidak berbagi 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 sedang 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 untuk saat ini, baik karena pengguna telah menolak secara permanen atau fitur teman tidak tersedia untuk mereka. Dalam situasi ini, setiap upaya untuk meminta akses ke daftar teman tidak akan berhasil.

PlayerExperienceInfo

Metadata pihak pertama/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 epoch Unix 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/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 antar-pemain.

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

Metode

get

 Mengambil resource Pemain dengan ID yang diberikan.

getMultipleApplicationPlayerIds

 Mendapatkan 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

 Mendapatkan koleksi pemain untuk pengguna yang saat ini sudah diautentikasi.