Google Play Game Services

Google Play oyun hizmeti, geliştiricilerin sosyal skor tabloları, başarılar, oyun durumu, Google ile oturum açma ve diğer özelliklerle oyunları geliştirmesine 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 isteği gönderirken aşağıdaki bilgileri kullanın.

Keşif dokümanı

Keşif Belgesi, REST API'lerini tanımlamaya ve kullanmaya yönelik, makine tarafından okunabilir bir spesifikasyondur. İstemci kitaplıkları, IDE eklentileri ve Google API'leriyle etkileşimde bulunan başka 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 hizmet, birden fazla hizmet uç noktasına sahip olabilir. Bu hizmet, aşağıdaki hizmet uç noktasına sahiptir ve aşağıdaki tüm URI'ler bu hizmet uç noktasıyla ilişkilidir:

  • https://games.googleapis.com

REST Kaynağı: achievementDefinitions

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

REST Kaynağı: başarılar

Yöntemler
increment POST /games/v1/achievements/{achievementId}/increment
Geçerli olarak doğrulanmış oynatıcı için verilen kimlikle başarının adımlarını artırır.
list GET /games/v1/players/{playerId}/achievements
Şu anda kimliği doğrulanmış durumda olan oynatıcı için uygulamanızın tüm başarılarıyla ilgili ilerleme durumunu listeler.
reveal POST /games/v1/achievements/{achievementId}/reveal
Belirtilen kimliğe sahip başarının durumunu, kimliği doğrulanmış durumda olan oynatıcı için REVEALED olarak ayarlar.
setStepsAtLeast POST /games/v1/achievements/{achievementId}/setStepsAtLeast
Şu anda kimliği doğrulanmış oyuncunun bir başarının kilidini açmaya yönelik adımlarını ayarlar.
unlock POST /games/v1/achievements/{achievementId}/unlock
Şu anda kimliği doğrulanmış durumda olan oyuncu için bu başarının kilidini açar.
updateMultiple POST /games/v1/achievements/updateMultiple
Şu anda kimliği doğrulanmış oyuncu için birden çok başarı güncellenir.

REST Kaynağı: uygulamalar

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ış 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 kendisine verilen oynatıcının kimliğini döndürür.

REST Kaynağı: etkinlikler

Yöntemler
listByPlayer GET /games/v1/events
Şu anda kimliği doğrulanmış kullanıcı için bu uygulamadaki etkinliklerde mevcut ilerleme durumunu gösteren bir liste döndürür.
listDefinitions GET /games/v1/eventDefinitions
Bu uygulamadaki etkinlik tanımlarının bir listesini döndürür.
record POST /games/v1/events
Bu uygulamanın şu anda kimliği doğrulanmış kullanıcısı için etkinliklerin gerçekleşme sayısında yapılan bir dizi değişikliği kaydeder.

REST Kaynağı: skor tabloları

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ğrı yapan uygulamanın meta oyun yapılandırma verilerini döndürür.
listCategoriesByPlayer GET /games/v1/players/{playerId}/categories/{collection}
playerId'a karşılık gelen oynatıcı için kategori başına toplu oynatma verilerini listeleyin.

REST Kaynağı: oyuncular

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ğrı yapan uygulamayla aynı geliştirici tarafından istekte bulunulan tüm oyunlarda geçerli olarak kimliği doğrulanmış oyuncunun uygulama oynatıcı kimliklerini alın.
getScopedPlayerIds GET /games/v1/players/me/scopedIds
Şu anda kimliği doğrulanmış kullanıcı için kapsamlı oynatıcı tanımlayıcılarını alır.
list GET /games/v1/players/me/players/{collection}
Şu anda kimliği doğrulanmış kullanıcı için oynatıcı koleksiyonunu alın.

REST Kaynağı: geri çağırma

Yöntemler
linkPersona POST /games/v1/recall:linkPersona
Sağlanan geri çağırma oturumu kimliğinde kodlanan PGS Player ana hesabını bir oyun içi hesapla ilişkilendirin
resetPersona POST /games/v1/recall:resetPersona
Belirtilen karakteri herhangi bir oyuncuya bağlayan (profilli veya profili olmayan) tüm Recall jetonlarını silin.
retrieveTokens GET /games/v1/recall/tokens/{sessionId}
Sağlanan geri çağırma oturumu kimliğine kodlanan PGS Player ana parasıyla 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 ana hesabını ve "persona" ya da jeton değeriyle tanımlanan bir oyun içi hesabı bağlayan bir Recall jetonunu silin.

REST Kaynağı: düzeltmeler

Yöntemler
check GET /games/v1/revisions/check
Oyun istemcisinin güncel olup olmadığını kontrol eder.

REST Kaynağı: puanlar

Yöntemler
get GET /games/v1/players/{playerId}/leaderboards/{leaderboardId}/scores/{timeSpan}
Kimliği doğrulanmış oyuncu için skor tablolarında rekorlar kırın ve isteğe bağlı olarak sıralamada yer alın.
list GET /games/v1/leaderboards/{leaderboardId}/scores/{collection}
Skor tablolarında üstten başlayarak skorları listeler.
listWindow GET /games/v1/leaderboards/{leaderboardId}/window/{collection}
Bir oyuncunun skoruyla ilgili (ve dahil) skor tablosunda skorları 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 bir listesini alır.

REST Kaynağı: istatistikler

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