Wymaga autoryzacji
Pobierz listę graczy ukrytych w danej aplikacji. Ta metoda jest dostępna tylko na kontach użytkowników konsoli programisty.
Żądanie
Żądanie HTTP
GET https://www.googleapis.com/games/v1management/applications/applicationId/players/hidden
Parametry
Nazwa parametru | Wartość | Opis |
---|---|---|
Parametry ścieżki | ||
applicationId |
string |
Identyfikator aplikacji z Konsoli Google Play. |
Opcjonalne parametry zapytania | ||
maxResults |
integer |
Maksymalna liczba zasobów odtwarzacza do zwrócenia w odpowiedzi, używanych na potrzeby stronicowania. W przypadku każdej odpowiedzi rzeczywista liczba zwróconych zasobów odtwarzacza może być mniejsza od określonej wartości maxResults .
Akceptowane wartości to od 1 do 15 włącznie.
|
pageToken |
string |
Token zwrócony przez poprzednie żądanie. |
Autoryzacja
To żądanie wymaga autoryzacji w ramach tego zakresu (więcej informacji o uwierzytelnianiu i autoryzacji).
Zakres |
---|
https://www.googleapis.com/auth/games |
Treść żądania
Nie podawaj treści żądania przy użyciu tej metody.
Odpowiedź
Jeśli operacja się uda, metoda zwróci odpowiedź o następującej strukturze:
{ "kind": "gamesManagement#hiddenPlayerList", "nextPageToken": string, "items": [ { "kind": "gamesManagement#hiddenPlayer", "player": { "kind": "gamesManagement#player", "playerId": string, "displayName": string, "avatarImageUrl": string, "lastPlayedWith": { "timeMillis": long, "autoMatched": boolean }, "name": { "familyName": string, "givenName": string }, "experienceInfo": { "currentExperiencePoints": long, "lastLevelUpTimestampMillis": long, "currentLevel": { "level": integer, "minExperiencePoints": long, "maxExperiencePoints": long }, "nextLevel": { "level": integer, "minExperiencePoints": long, "maxExperiencePoints": long } }, "title": string }, "hiddenTimeMillis": long } ] }
Nazwa usługi | Wartość | Opis | Uwagi |
---|---|---|---|
kind |
string |
Jednoznacznie identyfikuje typ tego zasobu. Wartością jest zawsze stały ciąg znaków gamesManagement#hiddenPlayerList . |
|
nextPageToken |
string |
Token podziału na strony dla następnej strony wyników. | |
items[] |
list |
Gracze. | |
items[].kind |
string |
Jednoznacznie identyfikuje typ tego zasobu. Wartością jest zawsze stały ciąg znaków gamesManagement#hiddenPlayer . |
|
items[].player |
nested object |
Informacje o odtwarzaczu. | |
items[].player.kind |
string |
Jednoznacznie identyfikuje typ tego zasobu. Wartością jest zawsze stały ciąg znaków gamesManagement#player . |
|
items[].player.playerId |
string |
Identyfikator odtwarzacza. | |
items[].player.displayName |
string |
Nazwa wyświetlana dla odtwarzacza. | |
items[].player.avatarImageUrl |
string |
Podstawowy adres URL obrazu reprezentującego odtwarzacz. | |
items[].player.lastPlayedWith |
nested object |
Szczegółowe informacje o tym, kiedy ten gracz ostatnio grał w grę wieloosobową z obecnie uwierzytelnionym graczem. Pole wypełnione dla członków kolekcji PLAYED_WITH graczy. | |
items[].player.lastPlayedWith.timeMillis |
long |
Czas ostatniego grania przez gracza w grę (w milisekundach od początku epoki, według czasu UTC). | |
items[].player.lastPlayedWith.autoMatched |
boolean |
Prawda, jeśli odtwarzacz został automatycznie dopasowany do obecnie uwierzytelnionego użytkownika. | |
items[].player.name |
object |
Reprezentacja obiektu poszczególnych składników nazwy odtwarzacza. W przypadku niektórych graczy te pola mogą być niedostępne. | |
items[].player.name.familyName |
string |
Nazwisko tego gracza. W niektórych miejscach jest to tzw. nazwisko. | |
items[].player.name.givenName |
string |
Nazwa tego gracza. W niektórych miejscach jest to tzw. imię. | |
items[].player.experienceInfo |
nested object |
Obiekt reprezentujący informacje o wrażeniach użytkownika w Grach Play. | |
items[].player.experienceInfo.currentExperiencePoints |
long |
Bieżąca liczba punktów doświadczenia gracza. | |
items[].player.experienceInfo.lastLevelUpTimestampMillis |
long |
Sygnatura czasowa awansowania gracza na nowy poziom wyrażona w milisekundach od początku czasu uniksowego (UTC). | |
items[].player.experienceInfo.currentLevel |
nested object |
Bieżący poziom gracza. | |
items[].player.experienceInfo.currentLevel.level |
integer |
Poziom użytkownika. | |
items[].player.experienceInfo.currentLevel.minExperiencePoints |
long |
Minimalna liczba punktów doświadczenia na tym poziomie. | |
items[].player.experienceInfo.currentLevel.maxExperiencePoints |
long |
Maksymalna liczba punktów doświadczenia na tym poziomie. | |
items[].player.experienceInfo.nextLevel |
nested object |
Następny poziom gracza. Jeśli obecny poziom jest poziomem maksymalnym, powinien być taki sam jak obecny. | |
items[].player.experienceInfo.nextLevel.level |
integer |
Poziom użytkownika. | |
items[].player.experienceInfo.nextLevel.minExperiencePoints |
long |
Minimalna liczba punktów doświadczenia na tym poziomie. | |
items[].player.experienceInfo.nextLevel.maxExperiencePoints |
long |
Maksymalna liczba punktów doświadczenia na tym poziomie. | |
items[].player.title |
string |
Tytuł gracza jest nagradzany za wykonanie jego aktywności w grze. |