Google Play Games Services API

Il servizio Google Play Giochi consente agli sviluppatori di migliorare i giochi con classifiche social, obiettivi, stato del gioco, accesso con Google e altro ancora.

Servizio: games.googleapis.com

Per chiamare questo servizio, ti consigliamo di utilizzare le librerie client fornite da Google. Se la tua applicazione deve utilizzare le tue librerie per chiamare questo servizio, utilizza le seguenti informazioni quando effettui le richieste API.

Documento di rilevamento

Un documento di rilevamento è una specifica leggibile da una macchina per descrivere e utilizzare le API REST. Viene utilizzato per creare librerie client, plug-in IDE e altri strumenti che interagiscono con le API di Google. Un servizio può fornire più documenti di rilevamento. Questo servizio fornisce il seguente documento di rilevamento:

Endpoint di servizio

Un endpoint di servizio è un URL di base che specifica l'indirizzo di rete di un servizio API. Un servizio potrebbe avere più endpoint di servizio. Questo servizio ha il seguente endpoint di servizio e tutti gli URI riportati di seguito sono relativi a questo endpoint di servizio:

  • https://games.googleapis.com

Risorsa REST: accesstokens

Metodi
generatePlayGroupingApiToken POST /games/v1/accesstokens/generatePlayGroupingApiToken
Genera un token API Play Grouping per l'utente PGS identificato dalla credenziale allegata.
generateRecallPlayGroupingApiToken POST /games/v1/accesstokens/generateRecallPlayGroupingApiToken
Genera un token API Play Grouping per l'utente PGS identificato dall'ID sessione di richiamo fornito nella richiesta.

Risorsa REST: achievementDefinitions

Metodi
list GET /games/v1/achievements
Elenca tutte le definizioni degli obiettivi per la tua applicazione.

Risorsa REST: achievements

Metodi
increment POST /games/v1/achievements/{achievementId}/increment
Incrementa i passaggi dell'obiettivo con l'ID specificato per il giocatore attualmente autenticato.
list GET /games/v1/players/{playerId}/achievements
Elenca i progressi di tutti gli obiettivi della tua applicazione per il giocatore autenticato in quel momento.
reveal POST /games/v1/achievements/{achievementId}/reveal
Imposta lo stato dell'obiettivo con l'ID specificato su REVEALED per il giocatore attualmente autenticato.
setStepsAtLeast POST /games/v1/achievements/{achievementId}/setStepsAtLeast
Imposta i passaggi per il giocatore attualmente autenticato per sbloccare un obiettivo.
unlock POST /games/v1/achievements/{achievementId}/unlock
Sblocca questo obiettivo per il giocatore autenticato in quel momento.
updateMultiple POST /games/v1/achievements/updateMultiple
Aggiorna più obiettivi per il giocatore autenticato in quel momento.

Risorsa REST: applications

Metodi
get GET /games/v1/applications/{applicationId}
Recupera i metadati dell'applicazione con l'ID specificato.
getEndPoint POST /games/v1/applications/getEndPoint
Restituisce un URL per il tipo di punto di arrivo richiesto.
played POST /games/v1/applications/played
Indica che l'utente attualmente autenticato sta giocando alla tua applicazione.
verify GET /games/v1/applications/{applicationId}/verify
Verifica che il token di autenticazione fornito con questa richiesta sia per l'applicazione con l'ID specificato e restituisce l'ID del giocatore per cui è stato concesso.

Risorsa REST: events

Metodi
listByPlayer GET /games/v1/events
Restituisce un elenco che mostra lo stato di avanzamento attuale degli eventi in questa applicazione per l'utente autenticato corrente.
listDefinitions GET /games/v1/eventDefinitions
Restituisce un elenco delle definizioni degli eventi in questa applicazione.
record POST /games/v1/events
Registra un batch di modifiche al numero di volte in cui si sono verificati eventi per l'utente autenticato corrente di questa applicazione.

Risorsa REST: leaderboards

Metodi
get GET /games/v1/leaderboards/{leaderboardId}
Recupera i metadati della classifica con l'ID specificato.
list GET /games/v1/leaderboards
Elenca tutti i metadati della classifica per la tua applicazione.

Risorsa REST: metagame

Metodi
getMetagameConfig GET /games/v1/metagameConfig
Restituisce i dati di configurazione del metagame per l'applicazione chiamante.
listCategoriesByPlayer GET /games/v1/players/{playerId}/categories/{collection}
Elenca i dati di gioco aggregati per categoria per il giocatore corrispondente a playerId.

Risorsa REST: playerGameEvents

Metodi
batchRecordEvents POST /games/v1/players/{playerId}/gameEvents:batchRecordEvents
Registra un batch di eventi di gioco per un giocatore specifico.

Risorsa REST: players

Metodi
get GET /games/v1/players/{playerId}
Recupera la risorsa Player con l'ID specificato.
getMultipleApplicationPlayerIds GET /games/v1/players/me/multipleApplicationPlayerIds
Recupera gli ID giocatore dell'applicazione per il giocatore autenticato al momento in tutti i giochi richiesti dallo stesso sviluppatore dell'applicazione chiamante.
getScopedPlayerIds GET /games/v1/players/me/scopedIds
Recupera gli identificatori del giocatore con ambito per l'utente attualmente autenticato.
list GET /games/v1/players/me/players/{collection}
Recupera la raccolta di giocatori per l'utente autenticato corrente.

Risorsa REST: recall

Metodi
gamesPlayerTokens GET /games/v1/recall/gamesPlayerTokens/{sessionId}
Recupera i token di richiamo da tutti i giochi richiesti associati al giocatore PGS codificato nell'ID sessione di richiamo fornito.
lastTokenFromAllDeveloperGames GET /games/v1/recall/developerGamesLastPlayerToken/{sessionId}
Recupera l'ultimo token di richiamo da tutti i giochi dello sviluppatore associati al giocatore PGS codificato nell'ID sessione di richiamo fornito.
linkPersona POST /games/v1/recall:linkPersona
Associa l'entità giocatore dei servizi per i giochi di Play codificata nell'ID sessione di ritiro fornito a un account in-game
resetPersona POST /games/v1/recall:resetPersona
Elimina tutti i token Recall che collegano la persona data a qualsiasi giocatore (con o senza profilo).
retrieveTokens GET /games/v1/recall/tokens/{sessionId}
Recupera tutti i token di richiamo associati al giocatore PGS codificato nell'ID sessione di richiamo fornito.
unlinkPersona POST /games/v1/recall:unlinkPersona
Elimina un token di richiamo che collega l'entità PGS Player identificata dalla sessione Recall e un account di gioco identificato dalla "persona" o dal valore del token.

Risorsa REST: revisions

Metodi
check GET /games/v1/revisions/check
Controlla se il client di giochi non è aggiornato.

Risorsa REST: scores

Metodi
get GET /games/v1/players/{playerId}/leaderboards/{leaderboardId}/scores/{timeSpan}
Ottieni i punteggi più alti e, facoltativamente, le classifiche per il giocatore autenticato in quel momento.
list GET /games/v1/leaderboards/{leaderboardId}/scores/{collection}
Elenca i punteggi in una classifica, a partire dal primo.
listWindow GET /games/v1/leaderboards/{leaderboardId}/window/{collection}
Elenca i punteggi in una classifica intorno al punteggio di un giocatore (incluso).
submit POST /games/v1/leaderboards/{leaderboardId}/scores
Invia un punteggio alla classifica specificata.
submitMultiple POST /games/v1/leaderboards/scores
Invia più punteggi alle classifiche.

Risorsa REST: snapshot

Metodi
get GET /games/v1/snapshots/{snapshotId}
Recupera i metadati per un determinato ID snapshot.
list GET /games/v1/players/{playerId}/snapshots
Recupera un elenco di snapshot creati dalla tua applicazione per il giocatore corrispondente all'ID giocatore.

Risorsa REST: stats

Metodi
get GET /games/v1/stats
Restituisce le statistiche sul coinvolgimento e sulla spesa in questa applicazione per l'utente autenticato corrente.