Google Play Game Services

Usługa gier w Google Play umożliwia deweloperom ulepszanie gier dzięki m.in. tablicom wyników, osiągnięciom, stanie gry i logowaniu się przez Google.

Usługa: Games.googleapis.com

Do wywoływania tej usługi zalecamy użycie dostarczonych przez Google bibliotek klienta. Jeśli do wywoływania tej usługi aplikacja musi używać Twoich własnych bibliotek, podczas tworzenia żądań do interfejsu API użyj podanych niżej informacji.

Dokument opisujący

Dokument opisujący to czytelna dla komputera specyfikacja opisująca interfejsy API REST i korzystające z nich. 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 dostarczać 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 są względne wobec tego punktu końcowego:

  • https://games.googleapis.com

Zasób REST: accesstokens

Metody
generatePlayGroupingApiToken
(POST /games/v1/accesstokens/generatePlayGroupingApiToken) Generuje token interfejsu Play Grouping API dla użytkownika usług gier Play, który został zidentyfikowany za pomocą załączonych danych logowania.
generateRecallPlayGroupingApiToken
(POST /games/v1/accesstokens/generateRecallPlayGroupingApiToken) Generuje token interfejsu Play Grouping API dla użytkownika usług gier Play, który został zidentyfikowany na podstawie identyfikatora sesji wycofywania podanego w żądaniu.

Zasób REST: achievementDefinitions

Metody
list
(GET /games/v1/achievements) Zawiera wszystkie definicje osiągnięć w przypadku Twojej aplikacji.

Zasób REST: osiągnięcia

Metody
increment
(POST /games/v1/achievements/{achievementId}/increment) Zwiększa liczbę kroków osiągnięcia o podany identyfikator aktualnie uwierzytelnionego gracza.
list
(GET /games/v1/players/{playerId}/achievements) Wyświetla postęp wszystkich osiągnięć Twojej aplikacji dla aktualnie uwierzytelnionego gracza.
reveal
(POST /games/v1/achievements/{achievementId}/reveal) Ustawia stan osiągnięcia o podanym identyfikatorze na REVEALED dla obecnie uwierzytelnionego gracza.
setStepsAtLeast
(POST /games/v1/achievements/{achievementId}/setStepsAtLeast) Określa kroki, jakie musi wykonać aktualnie uwierzytelniony gracz, by odblokować osiągnięcie.
unlock
(POST /games/v1/achievements/{achievementId}/unlock) Odblokowuje to osiągnięcie dla obecnie uwierzytelnionego gracza.
updateMultiple
(POST /games/v1/achievements/updateMultiple) Aktualizuje wiele osiągnięć dla obecnie 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 żądanego typu punktu końcowego.
played
(POST /games/v1/applications/played) Wskaż, że obecnie uwierzytelniony użytkownik odtwarza Twoją aplikację.
verify
(GET /games/v1/applications/{applicationId}/verify) Sprawdza, czy token uwierzytelniania dostarczony z tym żądaniem jest przeznaczony dla aplikacji o podanym identyfikatorze i zwraca identyfikator odtwarzacza, dla którego został przyznany.

Zasób REST: events

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

Zasób REST: tabele wyników

Metody
get
(GET /games/v1/leaderboards/{leaderboardId}) Pobiera metadane tabeli wyników o podanym identyfikatorze.
list
(GET /games/v1/leaderboards) Zawiera wszystkie metadane tabeli wyników dotyczące 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 zbiorcze dotyczące odtwarzania według kategorii dla gracza odpowiadającego grze playerId.

Zasób REST: players

Metody
get
(GET /games/v1/players/{playerId}) Pobiera zasób odtwarzacza o podanym identyfikatorze.
getMultipleApplicationPlayerIds
(GET /games/v1/players/me/multipleApplicationPlayerIds) Pobierz identyfikatory graczy dla obecnie uwierzytelnionego gracza we wszystkich żądanych grach tego samego programisty co aplikacja wywołująca.
getScopedPlayerIds
(GET /games/v1/players/me/scopedIds) Pobiera identyfikatory odtwarzaczy o ograniczonym zakresie dla obecnie uwierzytelnionego użytkownika.
list
(GET /games/v1/players/me/players/{collection}) Pobieranie kolekcji odtwarzaczy dla obecnie uwierzytelnionego użytkownika.

Zasób REST: recall

Metody
gamesPlayerTokens
(GET /games/v1/recall/gamesPlayerTokens/{sessionId}) Pobierz tokeny wycofywania ze wszystkich żądanych gier powiązanych z Odtwarzaczem gier Play zakodowanym w podanym identyfikatorze sesji wycofania.
lastTokenFromAllDeveloperGames
(GET /games/v1/recall/developerGamesLastPlayerToken/{sessionId}) Pobierz ostatni token wycofywania ze wszystkich gier dla deweloperów powiązanych z Odtwarzaczem gier Play zakodowany w podanym identyfikatorze sesji wycofania.
linkPersona
(POST /games/v1/recall:linkPersona) Powiąż podmiot zabezpieczeń graczy zakodowany w podanym identyfikatorze sesji wycofania z kontem w grze
resetPersona
(POST /games/v1/recall:resetPersona) Usuń wszystkie tokeny wycofywania, które łączą dany profil z dowolnym graczem (z profilem lub bez).
retrieveTokens
(GET /games/v1/recall/tokens/{sessionId}) Pobierz wszystkie tokeny wycofywania powiązane z odtwarzaczem PGS zakodowane w podanym identyfikatorze sesji wycofywania.
unlinkPersona
(POST /games/v1/recall:unlinkPersona) Usuń token wycofywania, który łączy podmiot zabezpieczeń gracza w usługach gier Play określony przez sesję wycofywania z kontem w grze określonym przez „persona” lub według wartości 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}) Uzyskuj wysokie wyniki (i opcjonalnie) w tabelach wyników aktualnie uwierzytelnionego gracza.
list
(GET /games/v1/leaderboards/{leaderboardId}/scores/{collection}) Wyniki są wyświetlane w tabeli wyników, zaczynając od góry.
listWindow
(GET /games/v1/leaderboards/{leaderboardId}/window/{collection}) Informacje o wynikach w tabeli wyników powiązane z wynikami gracza.
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: zrzuty

Metody
get
(GET /games/v1/snapshots/{snapshotId}) Pobiera metadane dla podanego identyfikatora zrzutu.
list
(GET /games/v1/players/{playerId}/snapshots) Pobiera listę utworzonych przez aplikację zrzutów dla odtwarzacza odpowiadającego identyfikatorowi odtwarzacza.

Zasób REST: stats

Metody
get
(GET /games/v1/stats) Zwraca statystyki zaangażowania i wydatków w tej aplikacji dotyczące obecnie uwierzytelnionego użytkownika.