Method: scores.get

Obtenez les meilleurs scores et éventuellement des classements dans les classements pour le joueur actuellement authentifié. Pour une période spécifique, leaderboardId peut être défini sur ALL afin de récupérer les données de tous les classements sur une période donnée. REMARQUE: Vous ne pouvez pas demander 'TOUS' les classements et 'ALL' timeSpans' dans la même requête. Un seul paramètre peut être défini sur 'ALL'.

Requête HTTP

GET https://games.googleapis.com/games/v1/players/{playerId}/leaderboards/{leaderboardId}/scores/{timeSpan}

Paramètres de chemin

Paramètres
playerId

string

Un ID de joueur Vous pouvez utiliser la valeur me à la place de l'ID du joueur authentifié.
leaderboardId

string

Identifiant du classement. Peut être défini sur "ALL" pour récupérer les données de tous les classements pour cette application.
timeSpan

enum (ScoreTimeSpan)

La période pour les scores et les classements que vous demandez.

Paramètres de requête

Paramètres
language

string

Langue préférée à utiliser pour les chaînes renvoyées par cette méthode.
includeRankType

enum (IncludeRankType)

Types de rangs à afficher. Si le paramètre est omis, aucun rang n'est renvoyé.
maxResults

integer

Nombre maximal de scores de classement à renvoyer dans la réponse. Pour toute réponse, le nombre réel de scores de classement renvoyés peut être inférieur à la valeur maxResults spécifiée.
pageToken

string

Jeton renvoyé par la requête précédente.

Corps de la requête

Le corps de la requête doit être vide.

Corps de la réponse

Si la requête aboutit, le corps de la réponse contient une instance de GetLeaderboardScoresResponse.

Champs d'application des autorisations

Nécessite l'un des champs d'application OAuth suivants :

  • https://www.googleapis.com/auth/games
  • https://www.googleapis.com/auth/games_lite

Pour en savoir plus, consultez la présentation d'OAuth 2.0.

ScoreTimeSpan

Définit les périodes possibles pour un score.

Enums
ALL Obtenez les meilleurs scores pour toutes les périodes. Si vous utilisez cette option, les valeurs maxResults seront ignorées.
ALL_TIME Obtenez le meilleur score de tous les temps.
WEEKLY Listez les meilleurs scores du jour.
DAILY Lister les meilleurs scores de la semaine en cours

IncludeRankType

Valeurs possibles pour le type de classement.

Enums
ALL Récupérez tous les classements acceptés. Dans HTTP, cette valeur de paramètre peut également être spécifiée en tant que ALL.
PUBLIC récupérer les niveaux publics, si le joueur partage son activité de jeu publiquement ;
SOCIAL

(Obsolète) Récupérez le classement sur les réseaux sociaux.
FRIENDS Récupérez votre classement dans la collection d'amis.