Google Play Game Services

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

REST Kaynağı: accesstokens

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.

REST Kaynağı: achievementDefinitions

Yöntemler
list
GET /games/v1/achievements Uygulamanız için tüm başarı tanımlarını listeler.

REST Kaynağı: başarılar

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.

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 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.

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ız için tüm skor tablosu meta verilerini listeler.

REST Kaynağı: metagame

Yöntemler
getMetagameConfig
GET /games/v1/metagameConfig Çağrı uygulamasının meta oyun yapılandırma verilerini döndürün.
listCategoriesByPlayer
GET /games/v1/players/{playerId}/categories/{collection} playerId öğesine karşılık gelen oyuncu için kategori başına toplanan oynatma verilerini listele:

REST Kaynağı: players

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.

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} 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.

REST Kaynağı: anlık görüntüler

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.