Method: metagame.listCategoriesByPlayer

Elenca i dati di riproduzione aggregati per categoria per il player corrispondente a playerId.

Richiesta HTTP

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

Parametri del percorso

Parametri
playerId

string

Un ID giocatore. È possibile utilizzare il valore me al posto dell'ID del player autenticato.

collection

enum (Collection)

La raccolta di categorie per le quali verranno restituiti i dati.

Parametri di ricerca

Parametri
language

string

La lingua preferita da utilizzare per le stringhe restituite da questo metodo.

maxResults

integer

Il numero massimo di risorse di categoria da restituire nella risposta, utilizzato per il paging. Per qualsiasi risposta, il numero effettivo di risorse di categoria restituite potrebbe essere inferiore al valore maxResults specificato.

pageToken

string

Il token restituito dalla richiesta precedente.

Corpo della richiesta

Il corpo della richiesta deve essere vuoto.

Corpo della risposta

Una risposta di categorie di metagame per un elenco di terze parti.

In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:

Rappresentazione JSON
{
  "kind": string,
  "nextPageToken": string,
  "items": [
    {
      object (MetagameCategory)
    }
  ]
}
Campi
kind

string

Identifica in modo univoco il tipo di questa risorsa. Il valore è sempre la stringa fissa games#categoryListResponse.

nextPageToken

string

Token corrispondente alla pagina dei risultati successiva.

items[]

object (MetagameCategory)

L'elenco di categorie con dati sull'utilizzo.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

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

Per ulteriori informazioni, consulta la Panoramica di OAuth 2.0.

Raccolta

Definisce le categorie per le quali verranno restituiti i dati.

Enum
ALL Recupera i dati per tutte le categorie. Questa è l'impostazione predefinita.

MetagameCategory

Dati relativi a singole categorie di giochi.

Rappresentazione JSON
{
  "kind": string,
  "category": string,
  "experiencePoints": string
}
Campi
kind

string

Identifica in modo univoco il tipo di questa risorsa. Il valore è sempre la stringa fissa games#category.

category

string

Il nome della categoria.

experiencePoints

string (int64 format)

I punti esperienza guadagnati in questa categoria.