Google Play Games Services API

Google Play Games Hizmeti, geliştiricilerin oyunları sosyal skor tabloları, başarılar, oyun durumu ve Google ile oturum açma gibi özelliklerle zenginleştirmesine olanak tanır.

Hizmet: games.googleapis.com

Bu hizmeti çağırmak için Google'ın sağladığı istemci kitaplıklarını kullanmanızı öneririz. Uygulamanızın bu hizmeti çağırmak için kendi kitaplıklarınızı kullanması gerekiyorsa API isteklerini yaparken aşağıdaki bilgileri kullanın.

Keşif belgesi

Keşif Belgesi, REST API'leri açıklamak ve kullanmak için makine tarafından okunabilir bir tanımlamadır. Google API'leriyle etkileşimde bulunan istemci kitaplıkları, IDE eklentileri ve diğer araçları oluşturmak için kullanılır. Bir hizmet birden fazla keşif belgesi sağlayabilir. Bu hizmet, aşağıdaki keşif belgesini sağlar:

Hizmet uç noktası

Hizmet uç noktası, bir API hizmetinin ağ adresini belirten ana URL'dir. Bir hizmetin birden fazla hizmet uç noktası olabilir. Bu hizmet aşağıdaki hizmet uç noktasını kullanır ve aşağıdaki tüm URI'ler bu hizmet uç noktasıyla ilgilidir:

  • https://games.googleapis.com

REST Kaynağı: accesstokens

Yöntemler
generatePlayGroupingApiToken POST /games/v1/accesstokens/generatePlayGroupingApiToken
Ekli kimlik bilgisiyle tanımlanan PGS kullanıcısı için Play Grouping API jetonu oluşturur.
generateRecallPlayGroupingApiToken POST /games/v1/accesstokens/generateRecallPlayGroupingApiToken
İstekle sağlanan Recall oturum kimliğiyle tanımlanan PGS kullanıcısı için Play Grouping API jetonu oluşturur.

REST Kaynağı: achievementDefinitions

Yöntemler
list GET /games/v1/achievements
Uygulamanızla ilgili tüm başarı tanımlarını listeler.

REST Kaynağı: achievements

Yöntemler
increment POST /games/v1/achievements/{achievementId}/increment
Şu anda kimliği doğrulanmış oyuncu için, belirtilen kimliğe sahip başarının adımlarını artırır.
list GET /games/v1/players/{playerId}/achievements
Şu anda kimliği doğrulanmış oyuncu için uygulamanızın tüm başarılarındaki ilerleme durumunu listeler.
reveal POST /games/v1/achievements/{achievementId}/reveal
Şu anda kimliği doğrulanmış oyuncu için, verilen kimliğe sahip başarının durumunu REVEALED olarak ayarlar.
setStepsAtLeast POST /games/v1/achievements/{achievementId}/setStepsAtLeast
Şu anda kimliği doğrulanmış oyuncunun bir başarının kilidini açmak için attığı adımları ayarlar.
unlock POST /games/v1/achievements/{achievementId}/unlock
Şu anda kimliği doğrulanmış oyuncu için bu başarının kilidini açar.
updateMultiple POST /games/v1/achievements/updateMultiple
Şu anda kimliği doğrulanmış oyuncunun birden fazla başarısını günceller.

REST Kaynağı: applications

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 varış noktası türü için bir URL döndürür.
played POST /games/v1/applications/played
Şu anda kimliği doğrulanmış kullanıcının uygulamanızı oynadığını belirtin.
verify GET /games/v1/applications/{applicationId}/verify
Bu istekle birlikte sağlanan yetkilendirme jetonunun, belirtilen kimliğe sahip uygulama için olduğunu doğrular ve jetonun verildiği oyuncunun kimliğini döndürür.

REST Kaynağı: events

Yöntemler
listByPlayer GET /games/v1/events
Kimliği doğrulanan geçerli kullanıcı için bu uygulamadaki etkinliklerdeki mevcut ilerleme durumunu 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ğrulanan geçerli kullanıcısı için etkinliklerin gerçekleşme sayısında yapılan bir grup değişikliği kaydeder.

REST Kaynağı: leaderboards

Yöntemler
get GET /games/v1/leaderboards/{leaderboardId}
Belirtilen kimliğe sahip skor tablosunun meta verilerini alır.
list GET /games/v1/leaderboards
Uygulamanızla ilgili tüm skor tablosu meta verilerini listeler.

REST Kaynağı: metagame

Yöntemler
getMetagameConfig GET /games/v1/metagameConfig
Çağıran uygulama için metagame yapılandırma verilerini döndürür.
listCategoriesByPlayer GET /games/v1/players/{playerId}/categories/{collection}
playerId ile eşleşen oyuncu için kategoriye göre toplanan liste oynatma verilerini gösterir.

REST Kaynağı: playerGameEvents

Yöntemler
batchRecordEvents POST /games/v1/players/{playerId}/gameEvents:batchRecordEvents
Belirli bir oyuncu için bir grup oyuncu oyunu etkinliğini kaydeder.

REST Kaynağı: players

Yöntemler
get GET /games/v1/players/{playerId}
Belirtilen kimliğe sahip Player kaynağını alır.
getMultipleApplicationPlayerIds GET /games/v1/players/me/multipleApplicationPlayerIds
Çağıran uygulama ile aynı geliştiriciye ait, istenen tüm oyunlarda şu anda kimliği doğrulanmış oyuncunun uygulama oyuncu kimliklerini alın.
getScopedPlayerIds GET /games/v1/players/me/scopedIds
Şu anda kimliği doğrulanmış kullanıcı için kapsamlı oyuncu tanımlayıcılarını alır.
list GET /games/v1/players/me/players/{collection}
Kimliği doğrulanan geçerli kullanıcının oyuncu koleksiyonunu alın.

REST Kaynağı: recall

Yöntemler
gamesPlayerTokens GET /games/v1/recall/gamesPlayerTokens/{sessionId}
Sağlanan Recall oturum kimliğinde kodlanmış PGS oyuncusuyla ilişkili, istenen tüm oyunlardan Recall jetonlarını alın.
lastTokenFromAllDeveloperGames GET /games/v1/recall/developerGamesLastPlayerToken/{sessionId}
Belirtilen geri çağırma oturumu kimliğinde kodlanmış PGS oyuncusuyla ilişkili 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 oyuncu sorumlusunu oyun içi bir hesapla ilişkilendirin.
resetPersona POST /games/v1/recall:resetPersona
Belirli bir karakteri herhangi bir oyuncuya (profil olsun veya olmasın) bağlayan tüm Geri Çağırma jetonlarını silin.
retrieveTokens GET /games/v1/recall/tokens/{sessionId}
Belirtilen Recall oturum kimliğinde kodlanmış PGS Player 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 Player asıl öğesini ve "persona" veya jeton değeriyle tanımlanan bir oyun içi hesabı bağlayan bir Geri Çağırma jetonunu silin.

REST Kaynağı: revisions

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}
Şu anda kimliği doğrulanmış oyuncu için liderlik tablolarında yüksek puanlar ve isteğe bağlı olarak sıralamalar alın.
list GET /games/v1/leaderboards/{leaderboardId}/scores/{collection}
Skorları, en yüksekten başlayarak skor tablosunda listeler.
listWindow GET /games/v1/leaderboards/{leaderboardId}/window/{collection}
Bir oyuncunun puanı da dahil olmak üzere, oyuncunun puanı civarındaki skorları 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.

REST Kaynağı: snapshots

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
Uygulamanızın, oyuncu kimliğine karşılık gelen oyuncu için oluşturduğu anlık görüntülerin listesini alır.

REST Kaynağı: stats

Yöntemler
get GET /games/v1/stats
Kimliği doğrulanmış geçerli kullanıcı için bu uygulamadaki etkileşim ve harcama istatistiklerini döndürür.