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ścią jest zawsze stały ciąg 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 użyty po pierwszym zalogowaniu 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ł później zmianie, oraz tylko w przypadku klientów obsługujących ponowne mapowanie identyfikatorów graczy.
profileSettings

object (ProfileSettings)

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

object

Reprezentacja obiektu poszczególnych składników nazwy odtwarzacza. 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 wrażeniach użytkownika w Grach Play.
title

string

Tytuł gracza jest nagradzany za wykonanie jego aktywności w grze.
friendStatus

enum (FriendStatus)

Status znajomego danego gracza w odniesieniu do osoby wysyłającej prośbę. Ta zasada nie jest skonfigurowana, jeśli gracz nie udostępnia grze listy znajomych.
gamePlayerId

string

Unikalny identyfikator odtwarzacza przypisany do poszczególnych aplikacji.

ProfileSettings

Ustawienia profilu

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

string

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

boolean

Określa, czy profil gracza jest widoczny dla obecnie zalogowanego gracza.
friendsListVisibility

enum (FriendsListVisibility)

FriendsListVisibility

Określa, czy lista znajomych gracza jest widoczna dla tej gry, czy można jej poprosić o dostęp. To pole jest wypełnione tylko w przypadku aktualnie zalogowanego gracza.

Wartości w polu enum
VISIBLE Lista znajomych jest obecnie widoczna dla gry.
REQUEST_REQUIRED Deweloper nie ma dostępu do listy znajomych, ale może wywołać interfejs API Androida, aby wyświetlić okno z prośbą o zgodę na przetwarzanie danych osobowych.
UNAVAILABLE Lista znajomych jest obecnie niedostępna dla tego użytkownika i nie można poprosić o dostęp, ponieważ użytkownik odmówił go na stałe lub nie ma dostępu do funkcji znajomych. W takim przypadku wszelkie próby poproszenia o dostęp do listy znajomych zakończą się niepowodzeniem.

PlayerExperienceInfo

własne metadane dotyczące działania odtwarzacza,

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

string

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

string (int64 format)

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

string (int64 format)

Sygnatura czasowa awansowania gracza na nowy poziom wyrażona w milisekundach od początku czasu uniksowego (UTC).
currentLevel

object (PlayerLevel)

Bieżący poziom gracza.
nextLevel

object (PlayerLevel)

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

PlayerLevel

wewnętrzne metadane dotyczące poziomu użytkownika.

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

string

Jednoznacznie identyfikuje typ tego zasobu. Wartością jest zawsze stały ciąg 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

Definiują przyjaźnie między graczami.

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

Metody

get

 Pobiera zasób odtwarzacza o podanym identyfikatorze.

getMultipleApplicationPlayerIds

 Pobierz identyfikatory graczy dla obecnie uwierzytelnionego gracza we wszystkich żądanych grach tego samego programisty co aplikacja wywołująca.

getScopedPlayerIds

 Pobiera identyfikatory odtwarzaczy o ograniczonym zakresie dla obecnie uwierzytelnionego użytkownika.

list

 Pobieranie kolekcji odtwarzaczy dla obecnie uwierzytelnionego użytkownika.