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ştirmelerine olanak tanır.

Hizmet: game.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 istekleri oluştururken 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 belgesi 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 bir 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'lar 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
Geçerli olarak kimlik doğrulaması yapılmış oynatıcı için uygulamanızın tüm başarılarıyla ilgili ilerleme durumunu listeler.
reveal POST /games/v1/achievements/{achievementId}/reveal
Geçerli olarak kimliği doğrulanmış oynatıcı için, belirtilen 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çmaya yönelik adımlarını 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ış oynatıcı için birden çok başarıyı günceller.

REST Kaynağı: uygulamalar

Yöntemler
get GET /games/v1/applications/{applicationId}
Uygulamanın belirtilen kimliğe sahip 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
Şu anda kimliği doğrulanmış kullanıcının uygulamanızı oynattığı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 etkinliklerdeki mevcut ilerlemeyi 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 kaç kez oluştuğunda yapılan bir grup 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 getirir.
list GET /games/v1/leaderboards
Uygulamanızla ilgili tüm leaderboard meta verilerini listeler.

REST Kaynağı: meta oyun

Yöntemler
getMetagameConfig GET /games/v1/metagameConfig
Çağrı yapan uygulamaya ait 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 toplanan 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 istenen tüm oyunlarda kimliği doğrulanmış durumda 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ğine 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 profilsiz) 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 hesabı 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 ana hesabını ve "persona" ya da jeton değeriyle tanımlanan oyun içi hesabı birbirine 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}
Şu anda kimliği doğrulanmış oyuncu için skor tablolarında yüksek puanlar ve isteğe bağlı olarak sıralamalar elde edin.
list GET /games/v1/leaderboards/{leaderboardId}/scores/{collection}
Skor tablolarında üstten başlayarak skorları listeler.
listWindow GET /games/v1/leaderboards/{leaderboardId}/window/{collection}
Skor tablosunda bir oyuncunun skoruna yakın (ve dahil) skorları listeler.
submit POST /games/v1/leaderboards/{leaderboardId}/scores
Belirtilen skor tablosuna bir puan 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
Uygulamanız tarafından oynatıcı kimliğine karşılık gelen oynatıcı için oluşturulan anlık görüntülerin 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.