Google Play oyunlar hizmeti, geliştiricilerin sosyal skor tabloları, başarılar, oyun durumu, Google ile oturum açma vb. özelliklere sahip oyunları geliştirmelerine olanak tanır.
Hizmet: games.googleapis.com
Bu hizmeti çağırmak için Google tarafından sağlanan istemci kitaplıklarını kullanmanızı öneririz. Uygulamanızın bu hizmeti çağırmak için kendi kitaplıklarınızı kullanması gerekiyorsa API isteklerinde bulunurken aşağıdaki bilgileri kullanın.
Keşif dokümanı
Keşif Belgesi, REST API'lerini açıklamak ve tüketmek için makine tarafından okunabilen bir spesifikasyondur. İstemci kitaplıkları, IDE eklentileri ve Google API'leriyle etkileşimde bulunan diğer araçları oluşturmak için kullanılır. Bir hizmet, birden fazla keşif dokümanı sağlayabilir. Bu hizmet, aşağıdaki keşif dokümanını sağlar:
Hizmet uç noktası
Hizmet uç noktası, bir API hizmetinin ağ adresini belirten temel URL'dir. Bir hizmetin birden fazla hizmet uç noktası olabilir. Bu hizmet, aşağıdaki hizmet uç noktasına sahiptir ve aşağıdaki URI'lerin tümü bu hizmet uç noktasına bağlıdır:
https://games.googleapis.com
Yöntemler |
generatePlayGroupingApiToken |
POST /games/v1/accesstokens/generatePlayGroupingApiToken
Ekteki kimlik bilgisiyle tanımlanan PGS kullanıcısı için bir Play Grouping API jetonu oluşturur. |
generateRecallPlayGroupingApiToken |
POST /games/v1/accesstokens/generateRecallPlayGroupingApiToken
İstekte sağlanan Recall oturum kimliğiyle tanımlanan PGS kullanıcısı için bir Play Grouping API jetonu oluşturur. |
Yöntemler |
list |
GET /games/v1/achievements
Uygulamanız için tüm başarı tanımlarını listeler. |
Yöntemler |
increment |
POST /games/v1/achievements/{achievementId}/increment
Kimliği doğrulanmış olan oynatıcı için başarının adımlarını belirtilen kimlikle artırır. |
list |
GET /games/v1/players/{playerId}/achievements
Kimliği doğrulanmış olan oynatıcı için uygulamanızın tüm başarılarının ilerleme durumunu listeler. |
reveal |
POST /games/v1/achievements/{achievementId}/reveal
Kimliği doğrulanmış olan oynatıcı için belirtilen kimlikle başarının durumunu REVEALED olarak ayarlar. |
setStepsAtLeast |
POST /games/v1/achievements/{achievementId}/setStepsAtLeast
Kimliği doğrulanmış olan oyuncu için bir başarının kilidini açmak üzere uygulanacak adımları ayarlar. |
unlock |
POST /games/v1/achievements/{achievementId}/unlock
Kimliği doğrulanmış olan oyuncu için bu başarının kilidini açar. |
updateMultiple |
POST /games/v1/achievements/updateMultiple
Kimliği doğrulanmış olan oyuncu için birden çok başarıyı günceller. |
Yöntemler |
get |
GET /games/v1/applications/{applicationId}
Belirtilen kimliğe sahip uygulamanın meta verilerini alır. |
getEndPoint |
POST /games/v1/applications/getEndPoint
İstenen uç nokta türü için bir URL döndürür. |
played |
POST /games/v1/applications/played
Kimliği doğrulanmış olan kullanıcının uygulamanızı oynattığını belirtir. |
verify |
GET /games/v1/applications/{applicationId}/verify
Bu istekle sağlanan kimlik doğrulama jetonunun, belirtilen kimliğe sahip uygulama için olduğunu doğrular ve hangi oynatıcı için verildiğini döndürür. |
REST Kaynağı: events
Yöntemler |
listByPlayer |
GET /games/v1/events
Kimliği doğrulanmış kullanıcı için bu uygulamadaki etkinliklerin mevcut ilerlemesini gösteren bir liste döndürür. |
listDefinitions |
GET /games/v1/eventDefinitions
Bu uygulamadaki etkinlik tanımlarının listesini döndürür. |
record |
POST /games/v1/events
Bu uygulamanın kimliği doğrulanmış o anki kullanıcısı için etkinliklerin gerçekleşme sayısında yapılan değişiklikleri toplu olarak kaydeder. |
Yöntemler |
get |
GET /games/v1/leaderboards/{leaderboardId}
Belirtilen kimliğe sahip skor tablosunun meta verilerini alır. |
list |
GET /games/v1/leaderboards
Uygulamanız için tüm skor tablosu meta verilerini listeler. |
Yöntemler |
get |
GET /games/v1/players/{playerId}
Belirtilen kimliğe sahip Oynatıcı kaynağını alır. |
getMultipleApplicationPlayerIds |
GET /games/v1/players/me/multipleApplicationPlayerIds
Çağrı yapan uygulamayla aynı geliştirici tarafından istenen tüm oyunlarda kimliği doğrulanmış mevcut oynatıcının uygulama oynatıcı kimliklerini alın. |
getScopedPlayerIds |
GET /games/v1/players/me/scopedIds
Kimliği doğrulanmış mevcut kullanıcının kapsamlı oynatıcı tanımlayıcılarını alır. |
list |
GET /games/v1/players/me/players/{collection}
Kimliği doğrulanmış olan kullanıcı için oynatıcı koleksiyonunu alın. |
REST Kaynağı: recall
Yöntemler |
gamesPlayerTokens |
GET /games/v1/recall/gamesPlayerTokens/{sessionId}
Sağlanan geri çağırma oturum kimliğinde kodlanmış PGS oynatıcıyla ilişkili tüm istenen oyunlardan Recall jetonlarını alın. |
lastTokenFromAllDeveloperGames |
GET /games/v1/recall/developerGamesLastPlayerToken/{sessionId}
Sağlanan geri çağırma oturum kimliğinde kodlanmış PGS Oynatıcıyla ilişkilendirilmiş tüm geliştirici oyunlarından son Geri çağırma jetonunu alın. |
linkPersona |
POST /games/v1/recall:linkPersona
Sağlanan geri çağırma oturumu kimliğinde kodlanmış PGS oyuncusu ana hesabını bir oyun içi hesapla ilişkilendirme |
resetPersona |
POST /games/v1/recall:resetPersona
Belirli bir karakteri (profili olan veya olmayan) herhangi bir oyuncuya bağlayan tüm Geri Çağırma jetonlarını siler. |
retrieveTokens |
GET /games/v1/recall/tokens/{sessionId}
Sağlanan geri çağırma oturumu kimliğinde kodlanmış PGS Oynatıcı ile ilişkili tüm Recall jetonlarını alın. |
unlinkPersona |
POST /games/v1/recall:unlinkPersona
Geri çağırma oturumu tarafından tanımlanan PGS oyuncu ana hesabı ile "karakter" tarafından tanımlanan bir oyun içi hesabı bağlayan geri çağırma jetonunu silin. veya jeton değerine göre. |
Yöntemler |
check |
GET /games/v1/revisions/check
Oyun istemcisinin güncel olup olmadığını kontrol eder. |
REST Kaynağı: scores
Yöntemler |
get |
GET /games/v1/players/{playerId}/leaderboards/{leaderboardId}/scores/{timeSpan}
Kimliği doğrulanmış olan oyuncu için skor tablolarında rekorları ve isteğe bağlı olarak sıralamaları alın. |
list |
GET /games/v1/leaderboards/{leaderboardId}/scores/{collection}
Skorları, en üstten başlayarak skor tablosunda listelenir. |
listWindow |
GET /games/v1/leaderboards/{leaderboardId}/window/{collection}
Skorları, skoru çevreleyen (ve skoru içeren) bir skor tablosunda listeler. |
submit |
POST /games/v1/leaderboards/{leaderboardId}/scores
Belirtilen skor tablosuna bir skor gönderir. |
submitMultiple |
POST /games/v1/leaderboards/scores
Skor tablolarına birden fazla skor gönderir. |
Yöntemler |
get |
GET /games/v1/snapshots/{snapshotId}
Belirli bir anlık görüntü kimliğinin meta verilerini alır. |
list |
GET /games/v1/players/{playerId}/snapshots
Oynatıcı kimliğine karşılık gelen oynatıcı için uygulamanız tarafından oluşturulan anlık görüntülerin listesini alır. |
REST Kaynağı: stats
Yöntemler |
get |
GET /games/v1/stats
Kimliği doğrulanmış kullanıcı için bu uygulamadaki etkileşim ve harcama istatistiklerini döndürür. |