Method: metagame.listCategoriesByPlayer

Répertorier les 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 Vous pouvez utiliser la valeur me à 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 préférée à utiliser pour les chaînes renvoyées par cette méthode.

maxResults

integer

Nombre maximal de ressources de catégorie à renvoyer 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 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

Réponse de catégories de métajeux par un tiers.

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 contenant 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 des données seront renvoyées.

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

MetagameCategory

Données liées à des catégories de jeux individuelles.

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.