Google Play Games Services API

Usługa gier Google Play umożliwia deweloperom wzbogacanie gier o społecznościowe tabele wyników, osiągnięcia, stan gry, logowanie się za pomocą Google i inne funkcje.

Usługa: games.googleapis.com

Zalecamy wywołanie tej usługi przy użyciu dostarczonych przez Google bibliotek klienta. Jeśli aplikacja musi wywoływać tę usługę przy użyciu własnych bibliotek, podczas tworzenia żądań interfejsu API należy używać poniższych informacji.

Dokument opisujący

Dokument opisujący to czytelna dla komputera specyfikacja opisująca interfejsy API REST i sposób ich używania. Służy do tworzenia bibliotek klienta, wtyczek IDE i innych narzędzi, które współdziałają z interfejsami API Google. Jedna usługa może udostępniać wiele dokumentów opisujących. Ta usługa dostarcza następujący dokument opisujący interfejs API:

Punkt końcowy usługi

Punkt końcowy usługi to podstawowy adres URL, który określa adres sieciowy usługi interfejsu API. Jedna usługa może mieć wiele punktów końcowych. Ta usługa ma następujący punkt końcowy i wszystkie poniższe identyfikatory URI odnoszą się do niego:

  • https://games.googleapis.com

Zasób REST: accesstokens

Metody
generatePlayGroupingApiToken POST /games/v1/accesstokens/generatePlayGroupingApiToken
Generuje token interfejsu Play Grouping API dla użytkownika PGS zidentyfikowanego na podstawie dołączonych danych logowania.
generateRecallPlayGroupingApiToken POST /games/v1/accesstokens/generateRecallPlayGroupingApiToken
Generuje token interfejsu Play Grouping API dla użytkownika usług gier Play zidentyfikowanego przez identyfikator sesji Recall podany w żądaniu.

Zasób REST: achievementDefinitions

Metody
list GET /games/v1/achievements
Zawiera listę wszystkich definicji osiągnięć w Twojej aplikacji.

Zasób REST: achievements

Metody
increment POST /games/v1/achievements/{achievementId}/increment
Zwiększa liczbę kroków w przypadku osiągnięcia o podanym identyfikatorze dla aktualnie uwierzytelnionego gracza.
list GET /games/v1/players/{playerId}/achievements
Wyświetla postępy we wszystkich osiągnięciach aplikacji w przypadku aktualnie uwierzytelnionego gracza.
reveal POST /games/v1/achievements/{achievementId}/reveal
Ustawia stan osiągnięcia o podanym identyfikatorze na REVEALED dla aktualnie uwierzytelnionego gracza.
setStepsAtLeast POST /games/v1/achievements/{achievementId}/setStepsAtLeast
Ustawia liczbę kroków, które musi wykonać aktualnie uwierzytelniony gracz, aby odblokować osiągnięcie.
unlock POST /games/v1/achievements/{achievementId}/unlock
Odblokowuje to osiągnięcie dla aktualnie uwierzytelnionego gracza.
updateMultiple POST /games/v1/achievements/updateMultiple
Aktualizuje wiele osiągnięć aktualnie uwierzytelnionego gracza.

Zasób REST: applications

Metody
get GET /games/v1/applications/{applicationId}
Pobiera metadane aplikacji o podanym identyfikatorze.
getEndPoint POST /games/v1/applications/getEndPoint
Zwraca adres URL dla wybranego typu punktu końcowego.
played POST /games/v1/applications/played
Informuje, że aktualnie uwierzytelniony użytkownik korzysta z Twojej aplikacji.
verify GET /games/v1/applications/{applicationId}/verify
Sprawdza, czy token uwierzytelniania podany w tym żądaniu jest przeznaczony dla aplikacji o określonym identyfikatorze, i zwraca identyfikator gracza, dla którego został przyznany.

Zasób REST: events

Metody
listByPlayer GET /games/v1/events
Zwraca listę pokazującą aktualny postęp w zdarzeniach w tej aplikacji w przypadku aktualnie uwierzytelnionego użytkownika.
listDefinitions GET /games/v1/eventDefinitions
Zwraca listę definicji zdarzeń w tej aplikacji.
record POST /games/v1/events
Rejestruje partię zmian w liczbie wystąpień zdarzeń w przypadku aktualnie uwierzytelnionego użytkownika tej aplikacji.

Zasób REST: leaderboards

Metody
get GET /games/v1/leaderboards/{leaderboardId}
Pobiera metadane tablicy wyników o podanym identyfikatorze.
list GET /games/v1/leaderboards
Wyświetla wszystkie metadane tablicy wyników aplikacji.

Zasób REST: metagame

Metody
getMetagameConfig GET /games/v1/metagameConfig
Zwraca dane konfiguracji metagry dla aplikacji wywołującej.
listCategoriesByPlayer GET /games/v1/players/{playerId}/categories/{collection}
Wyświetl dane odtwarzania zagregowane według kategorii dla odtwarzacza odpowiadającego wartości playerId.

Zasób REST: playerGameEvents

Metody
batchRecordEvents POST /games/v1/players/{playerId}/gameEvents:batchRecordEvents
Rejestruje pakiet zdarzeń w grze dotyczących konkretnego gracza.

Zasób REST: players

Metody
get GET /games/v1/players/{playerId}
Pobiera zasób Player o podanym identyfikatorze.
getMultipleApplicationPlayerIds GET /games/v1/players/me/multipleApplicationPlayerIds
Pobierz identyfikatory gracza w aplikacji dla aktualnie uwierzytelnionego gracza we wszystkich grach tego samego dewelopera co aplikacja wywołująca.
getScopedPlayerIds GET /games/v1/players/me/scopedIds
Pobiera identyfikatory gracza w określonym zakresie dla aktualnie uwierzytelnionego użytkownika.
list GET /games/v1/players/me/players/{collection}
Pobierz kolekcję graczy dla aktualnie uwierzytelnionego użytkownika.

Zasób REST: recall

Metody
gamesPlayerTokens GET /games/v1/recall/gamesPlayerTokens/{sessionId}
Pobiera tokeny Recall ze wszystkich żądanych gier powiązanych z graczem PGS zakodowanym w podanym identyfikatorze sesji Recall.
lastTokenFromAllDeveloperGames GET /games/v1/recall/developerGamesLastPlayerToken/{sessionId}
Pobierz ostatni token do pobrania danych ze wszystkich gier dewelopera powiązanych z graczem w usługach gier Play zakodowanym w podanym identyfikatorze sesji wycofania.
linkPersona POST /games/v1/recall:linkPersona
Powiąż podmiot zabezpieczeń gracza w usługach gier Google Play zakodowany w podanym identyfikatorze sesji wycofania z kontem w grze.
resetPersona POST /games/v1/recall:resetPersona
Usuń wszystkie tokeny wycofywania, które łączą daną personę z dowolnym graczem (z profilem lub bez niego).
retrieveTokens GET /games/v1/recall/tokens/{sessionId}
Pobiera wszystkie tokeny Recall powiązane z graczem w usługach gier Play zakodowanym w podanym identyfikatorze sesji Recall.
unlinkPersona POST /games/v1/recall:unlinkPersona
Usuń token do pobrania danych łączący podmiot gracza usług gier Play zidentyfikowany przez sesję pobierania danych i konto w grze zidentyfikowane przez „personę” lub wartość tokena.

Zasób REST: revisions

Metody
check GET /games/v1/revisions/check
Sprawdza, czy klient gier jest nieaktualny.

Zasób REST: scores

Metody
get GET /games/v1/players/{playerId}/leaderboards/{leaderboardId}/scores/{timeSpan}
Pobieranie najlepszych wyników i opcjonalnie pozycji w tabelach wyników dla aktualnie uwierzytelnionego gracza.
list GET /games/v1/leaderboards/{leaderboardId}/scores/{collection}
Wyświetla wyniki w tabeli wyników, zaczynając od najlepszego.
listWindow GET /games/v1/leaderboards/{leaderboardId}/window/{collection}
Wyświetla wyniki w tabeli wyników w pobliżu wyniku gracza (włącznie z nim).
submit POST /games/v1/leaderboards/{leaderboardId}/scores
Przesyła wynik do określonej tabeli wyników.
submitMultiple POST /games/v1/leaderboards/scores
Przesyła wiele wyników do tabel wyników.

Zasób REST: snapshots

Metody
get GET /games/v1/snapshots/{snapshotId}
Pobiera metadane dla danego identyfikatora migawki.
list GET /games/v1/players/{playerId}/snapshots
Pobiera listę migawek utworzonych przez aplikację dla gracza odpowiadającego identyfikatorowi gracza.

Zasób REST: stats

Metody
get GET /games/v1/stats
Zwraca statystyki zaangażowania i wydatków w tej aplikacji w przypadku aktualnie uwierzytelnionego użytkownika.