Google Play Game Services

Usługa gier Google Play pozwala deweloperom ulepszać gry za pomocą społecznościowych tabel wyników, osiągnięć, stanu gry, funkcji logowania się przez Google i innych funkcji.

Usługa: game.googleapis.com

Aby wywołać tę usługę, zalecamy użycie dostarczonych przez Google bibliotek klienta. Jeśli do wywoływania tej usługi aplikacja musi używać 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 korzystanie 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 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 tego punktu końcowego:

  • https://games.googleapis.com

Zasób REST: achievementDefinitions

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

Zasób REST: osiągnięcia

Metody
increment POST /games/v1/achievements/{achievementId}/increment
Zwiększają kroki osiągnięcia o podany identyfikator dla obecnie uwierzytelnionego gracza.
list GET /games/v1/players/{playerId}/achievements
Zawiera listę postępów wszystkich osiągnięć aplikacji dla aktualnie uwierzytelnionego odtwarzacza.
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ć użytkownik aktualnie uwierzytelnionego gracza, aby zdobyć 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 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 żądanego typu punktu końcowego.
played POST /games/v1/applications/played
Wskaż, że aktualnie uwierzytelniony użytkownik odtwarza Twoją aplikację.
verify GET /games/v1/applications/{applicationId}/verify
Sprawdza, czy token uwierzytelniania dostarczony z tym żądaniem dotyczy aplikacji o określonym identyfikatorze i zwraca identyfikator odtwarzacza, dla którego został przyznany.

Zasób REST: events

Metody
listByPlayer GET /games/v1/events
Zwraca listę pokazującą bieżący postęp w zdarzeniach w tej aplikacji dla obecnie 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ń dla obecnie uwierzytelnionego użytkownika tej aplikacji.

Zasób REST: leaderboards

Metody
get GET /games/v1/leaderboards/{leaderboardId}
Pobiera metadane tabeli wyników o podanym identyfikatorze.
list GET /games/v1/leaderboards
Zawiera wszystkie metadane tabel 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}
Pokazuje zbiorcze dane o odtworzeniach według kategorii dla odtwarzacza odpowiadającego 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 aktualnie uwierzytelnionego odtwarzacza we wszystkich grach tego samego dewelopera co aplikacja wywołująca.
getScopedPlayerIds GET /games/v1/players/me/scopedIds
Pobiera identyfikatory odtwarzacza o zakresie na potrzeby obecnie uwierzytelnionego użytkownika.
list GET /games/v1/players/me/players/{collection}
Pobierz kolekcję graczy dla aktualnie uwierzytelnionego użytkownika.

Zasób REST: recall

Metody
linkPersona POST /games/v1/recall:linkPersona
Powiąż podmiot zabezpieczeń odtwarzacza w usługach gier Play zakodowany w podanym identyfikatorze sesji wycofania z kontem w grze
resetPersona POST /games/v1/recall:resetPersona
Usuń wszystkie tokeny wycofywania łączące daną profile klientów z dowolnym graczem (z profilem lub bez niego).
retrieveTokens GET /games/v1/recall/tokens/{sessionId}
Pobierz wszystkie tokeny wycofywania powiązane z podmiotem zabezpieczeń odtwarzacza PGS zakodowane w podanym identyfikatorze sesji wycofania.
unlinkPersona POST /games/v1/recall:unlinkPersona
Usuń token wycofywania łączący podmiot zabezpieczeń gracza w usługach gier Play, który jest identyfikowany przez sesję czułości z kontem w grze identyfikowanym przez profil lub wartość tokena.

Zasób REST: revisions

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

Zasób REST: score

Metody
get GET /games/v1/players/{playerId}/leaderboards/{leaderboardId}/scores/{timeSpan}
Otrzymuj najlepsze wyniki i opcjonalnie pozycję w tabeli wyników dla aktualnie uwierzytelnionego gracza.
list GET /games/v1/leaderboards/{leaderboardId}/scores/{collection}
Zawiera wyniki w tabeli wyników, zaczynając od góry.
listWindow GET /games/v1/leaderboards/{leaderboardId}/window/{collection}
Zawiera wyniki w tabeli wyników razem z wynikiem gracza.
submit POST /games/v1/leaderboards/{leaderboardId}/scores
Przesyła wynik do określonej tabeli wyników.
submitMultiple POST /games/v1/leaderboards/scores
Służy do przesyłania wielu wyników do tabeli wyników.

Zasób REST: zrzuty

Metody
get GET /games/v1/snapshots/{snapshotId}
Pobiera metadane z podanym identyfikatorem zrzutu.
list GET /games/v1/players/{playerId}/snapshots
Pobiera listę zrzutów utworzonych przez aplikację dla odtwarzacza odpowiadającego jego identyfikatorowi.

Zasób REST: stats

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