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.
- Zasób REST: accesstokens
- Zasób REST: osiągnięcia definicji (definicja)
- Zasób REST: osiągnięcia
- Zasób REST: aplikacje
- Zasób REST: zdarzenia
- Zasób REST: tabele wyników
- Zasób REST: metagame
- Zasób REST: player
- Zasób REST: wycofanie
- Zasób REST: versions
- Zasób REST: wyniki
- Zasób REST: zrzuty
- Zasób REST: statystyki
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. |