Liste der Spieler abrufen, die in der angegebenen App ausgeblendet sind Diese Methode ist nur für Nutzerkonten Ihrer Developer Console verfügbar.
Anfragen
HTTP-Anfrage
GET https://www.googleapis.com/games/v1management/applications/applicationId/players/hidden
Parameter
Parametername | Wert | Beschreibung |
---|---|---|
Pfadparameter | ||
applicationId |
string |
Die App-ID aus der Google Play Console. |
Optionale Abfrageparameter | ||
maxResults |
integer |
Die maximale Anzahl von Player-Ressourcen, die in der Antwort zurückgegeben werden sollen; wird für die Seitenordnung verwendet. Bei jeder Antwort kann die tatsächliche Anzahl der zurückgegebenen Spielerressourcen kleiner als die angegebene maxResults sein.
Zulässige Werte sind 1 bis 15 (einschließlich).
|
pageToken |
string |
Das von der vorherigen Anfrage zurückgegebene Token. |
Autorisierung
Für diese Anfrage ist eine Autorisierung in folgendem Bereich erforderlich. Weitere Informationen zur Authentifizierung und Autorisierung
Umfang |
---|
https://www.googleapis.com/auth/games |
Anfragetext
Mit dieser Methode keinen Anfragetext bereitstellen.
Antwort
Bei Erfolg gibt diese Methode einen Antworttext mit der folgenden Struktur zurück:
{ "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 } ] }
Name der Eigenschaft | Wert | Beschreibung | Hinweise |
---|---|---|---|
kind |
string |
Identifiziert eindeutig den Typ dieser Ressource. Der Wert ist immer der feste String gamesManagement#hiddenPlayerList . |
|
nextPageToken |
string |
Das Paginierungstoken für die nächste Ergebnisseite. | |
items[] |
list |
Die Spieler. | |
items[].kind |
string |
Identifiziert eindeutig den Typ dieser Ressource. Der Wert ist immer der feste String gamesManagement#hiddenPlayer . |
|
items[].player |
nested object |
Die Spielerinformationen. | |
items[].player.kind |
string |
Identifiziert eindeutig den Typ dieser Ressource. Der Wert ist immer der feste String gamesManagement#player . |
|
items[].player.playerId |
string |
ID des Spielers | |
items[].player.displayName |
string |
Der Name, der für den Player angezeigt werden soll. | |
items[].player.avatarImageUrl |
string |
Die Basis-URL für das Bild, das den Player repräsentiert. | |
items[].player.lastPlayedWith |
nested object |
Details zum letzten Mal, als dieser Spieler mit dem derzeit authentifizierten Spieler ein Mehrspielerspiel gespielt hat Wird für PLAYED_WITH Mitglieder der Spielersammlung ausgefüllt. | |
items[].player.lastPlayedWith.timeMillis |
long |
Das letzte Mal, dass der Spieler das Spiel gespielt hat, in Millisekunden seit der Epoche in UTC. | |
items[].player.lastPlayedWith.autoMatched |
boolean |
„True“, wenn der Spieler automatisch dem derzeit authentifizierten Nutzer zugeordnet wurde. | |
items[].player.name |
object |
Objektdarstellung der einzelnen Komponenten des Spielernamens Bei einigen Spielern sind diese Felder möglicherweise nicht vorhanden. | |
items[].player.name.familyName |
string |
Familienname dieses Spielers An einigen Stellen wird das auch als Nachname bezeichnet. | |
items[].player.name.givenName |
string |
Name dieses Spielers In manchen Ländern wird er auch als Vorname bezeichnet. | |
items[].player.experienceInfo |
nested object |
Ein Objekt zur Darstellung von Play-Spiel-Informationen für den Spieler. | |
items[].player.experienceInfo.currentExperiencePoints |
long |
Die aktuelle Anzahl der Erfahrungspunkte für den Spieler. | |
items[].player.experienceInfo.lastLevelUpTimestampMillis |
long |
Der Zeitstempel, zu dem der Spieler das nächste Level erreicht hat, in Millis seit der Unix-Epoche UTC. | |
items[].player.experienceInfo.currentLevel |
nested object |
Das aktuelle Level des Spielers. | |
items[].player.experienceInfo.currentLevel.level |
integer |
Die Ebene für den Nutzer. | |
items[].player.experienceInfo.currentLevel.minExperiencePoints |
long |
Die minimale Erfahrungspunkte für dieses Level. | |
items[].player.experienceInfo.currentLevel.maxExperiencePoints |
long |
Die maximalen Erfahrungspunkte für dieses Level. | |
items[].player.experienceInfo.nextLevel |
nested object |
Das nächste Level des Spielers. Wenn die aktuelle Pegel die höchste Stufe ist, sollte diese mit der aktuellen Pegel übereinstimmen. | |
items[].player.experienceInfo.nextLevel.level |
integer |
Die Ebene für den Nutzer. | |
items[].player.experienceInfo.nextLevel.minExperiencePoints |
long |
Die minimale Erfahrungspunkte für dieses Level. | |
items[].player.experienceInfo.nextLevel.maxExperiencePoints |
long |
Die maximalen Erfahrungspunkte für dieses Level. | |
items[].player.title |
string |
Der Titel des Spielers wurde für seine Spieleaktivitäten belohnt. |