Method: metagame.listCategoriesByPlayer

Liste des données de jeu agrégées par catégorie pour le joueur correspondant à playerId.

Requête HTTP

GET https://games.googleapis.com/games/v1/players/{playerId}/categories/{collection}

Paramètres de chemin

Paramètres
playerId

string

Un ID de joueur. La valeur me peut être utilisée à la place de l'ID du joueur authentifié.

collection

enum (Collection)

Ensemble de catégories pour lesquelles des données seront renvoyées.

Paramètres de requête

Paramètres
language

string

Langue privilégiée pour les chaînes renvoyées par cette méthode.

maxResults

integer

Nombre maximal de ressources de catégorie à afficher dans la réponse, utilisé pour la pagination. Pour toute réponse, le nombre réel de ressources de catégorie renvoyées peut être inférieur à la valeur maxResults spécifiée.

pageToken

string

Jeton affiché 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

Réponse d'un tiers listant les catégories de métagame.

Si la requête aboutit, le corps de la réponse contient des données qui ont la structure suivante :

Représentation JSON
{
  "kind": string,
  "nextPageToken": string,
  "items": [
    {
      object (MetagameCategory)
    }
  ]
}
Champs
kind

string

Identifie de manière unique le type de cette ressource. La valeur est toujours la chaîne fixe games#categoryListResponse.

nextPageToken

string

Jeton correspondant à la page de résultats suivante.

items[]

object (MetagameCategory)

Liste des catégories avec des données d'utilisation.

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.

Collection

Définit les catégories pour lesquelles les données seront renvoyées.

Enums
ALL Récupérez les données de toutes les catégories. Il s'agit de la valeur par défaut.

MetagameCategory

Données liées à des catégories de jeux spécifiques.

Représentation JSON
{
  "kind": string,
  "category": string,
  "experiencePoints": string
}
Champs
kind

string

Identifie de manière unique le type de cette ressource. La valeur est toujours la chaîne fixe games#category.

category

string

Nom de la catégorie.

experiencePoints

string (int64 format)

Points d'expérience gagnés dans cette catégorie.