REST Resource: players

Zasób: Player

Zasób odtwarzacza.

Zapis 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
}
Pola
kind

string

Jednoznacznie identyfikuje typ tego zasobu. Wartość jest zawsze stałym ciągiem znaków games#player
playerId

string

Identyfikator odtwarzacza.
displayName

string

Nazwa wyświetlana dla odtwarzacza.
avatarImageUrl

string

Podstawowy adres URL obrazu reprezentującego odtwarzacz.
bannerUrlPortrait

string

Adres URL obrazu banera odtwarzacza w trybie pionowym.
bannerUrlLandscape

string

Adres URL obrazu banera odtwarzacza w trybie poziomym.
originalPlayerId

string

Identyfikator gracza, który został użyty do pierwszego zalogowania się w danej grze. Pole jest wypełniane tylko w przypadku wywołań Player.get w przypadku odtwarzacza, który wysłał żądanie, tylko wtedy, gdy identyfikator odtwarzacza uległ zmianie, i tylko w przypadku klientów, które obsługują mapowanie identyfikatorów graczy.
profileSettings

object (ProfileSettings)

Ustawienia profilu gracza. Określa, czy profil gracza jest widoczny dla innych graczy.
name

object

Obiektowa reprezentacja poszczególnych komponentów nazwy gracza. W przypadku niektórych graczy te pola mogą być niedostępne.
name.familyName

string

Nazwisko tego gracza. W niektórych miejscach jest to tzw. nazwisko.
name.givenName

string

Nazwa tego gracza. W niektórych miejscach jest to tzw. imię.
experienceInfo

object (PlayerExperienceInfo)

Obiekt reprezentujący informacje o grach w Play dla gracza.
title

string

Tytuł gracza jest nagradzany za aktywność w grze.
friendStatus

enum (FriendStatus)

Status znajomego danego gracza względem osoby wysyłającej prośbę. To ustawienie jest nieskonfigurowana, jeśli gracz nie udostępnia tej grze listy znajomych.
gamePlayerId

string

Unikalny identyfikator odtwarzacza dla poszczególnych aplikacji.

ProfileSettings

Ustawienia profilu

Zapis JSON 
{
  "kind": string,
  "profileVisible": boolean,
  "friendsListVisibility": enum (FriendsListVisibility)
}
Pola
kind

string

Jednoznacznie identyfikuje typ tego zasobu. Wartość jest zawsze stałym ciągiem znaków games#profileSettings.
profileVisible

boolean

Czy profil gracza jest widoczny dla gracza, który jest w tej chwili zalogowany.
friendsListVisibility

enum (FriendsListVisibility)

FriendsListVisibility

Czy lista znajomych gracza jest widoczna w tej grze i czy może być ona widoczna w tej grze. Pole jest wypełnione tylko w przypadku aktualnie zalogowanego odtwarzacza.

Wartości w polu enum
VISIBLE Lista znajomych jest obecnie widoczna w grze.
REQUEST_REQUIRED Deweloper nie ma dostępu do listy znajomych, ale może wywołać interfejs Android API, aby wyświetlić okno z prośbą o zgodę.
UNAVAILABLE Ten użytkownik nie ma obecnie dostępu do listy znajomych. W tej chwili nie można poprosić o dostęp z powodu odmowy dostępu na stałe lub funkcji znajomych. W takiej sytuacji wszelkie próby wysłania prośby o dostęp do listy znajomych zakończą się niepowodzeniem.

PlayerExperienceInfo

Metadane własne lub innych firm dotyczące wrażeń gracza.

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

string

Jednoznacznie identyfikuje typ tego zasobu. Wartość jest zawsze stałym ciągiem znaków games#playerExperienceInfo.
currentExperiencePoints

string (int64 format)

Bieżąca liczba punktów doświadczenia dla gracza.
lastLevelUpTimestampMillis

string (int64 format)

Sygnatura czasowa przejścia gracza na wyższy poziom (w milisekundach od początku uniksowego czasu UTC).
currentLevel

object (PlayerLevel)

Bieżący poziom odtwarzacza.
nextLevel

object (PlayerLevel)

Następny poziom gracza. Jeśli bieżący poziom jest poziomem maksymalnym, powinien być taki sam jak poziom obecny.

PlayerLevel

Metadane własne lub innych firm dotyczące poziomu użytkownika.

Zapis JSON 
{
  "kind": string,
  "level": integer,
  "minExperiencePoints": string,
  "maxExperiencePoints": string
}
Pola
kind

string

Jednoznacznie identyfikuje typ tego zasobu. Wartość jest zawsze stałym ciągiem znaków games#playerLevel.
level

integer

Poziom użytkownika.
minExperiencePoints

string (int64 format)

Minimalna liczba punktów doświadczenia na tym poziomie.
maxExperiencePoints

string (int64 format)

Maksymalna liczba punktów doświadczenia na tym poziomie.

FriendStatus

Definiuje relacje przyjaźni między graczami.

Wartości w polu enum
NO_RELATIONSHIP Nie ma między nimi żadnych relacji.
FRIEND Gracz i osoba wysyłająca prośbę są znajomymi.

Metody

get

 Pobiera zasób Player o podanym identyfikatorze.

getMultipleApplicationPlayerIds

 Pobierz identyfikatory obecnie uwierzytelnionego odtwarzacza we wszystkich grach tego samego dewelopera co aplikacja wywołująca.

getScopedPlayerIds

 Pobiera identyfikatory odtwarzacza w zakresie dla obecnie uwierzytelnionego użytkownika.

list

 Pobierz kolekcję graczy dla aktualnie uwierzytelnionego użytkownika.