Scores: submit

Koleksiyonlar ile düzeninizi koruyun İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.

Belirtilen skor tablosuna bir puan gönderir. Şimdi deneyin.

İstek

HTTP isteği

POST https://www.googleapis.com/games/v1/leaderboards/leaderboardId/scores

Parametreler

Parametre adı Değer Açıklama
Yol parametreleri
leaderboardId string Skor tablosunun kimliği.
Gerekli sorgu parametreleri
score long Gönderdiğiniz puan. Gönderilen puan daha önce gönderilen puandan daha kötüyse yok sayılır. Daha da kötüsü, skor tablosu sıralama ölçütüne bağlıdır. Puan değerinin anlamı leaderboard biçim türüne bağlıdır. Sabit nokta için puan, ham değeri temsil eder. Süre, puan milisaniye olarak geçen süreyi temsil eder. Para birimi için puan, mikro birimlerdeki bir değeri temsil eder.
İsteğe bağlı sorgu parametreleri
language string Bu yöntemle döndürülen dizeler için kullanılacak tercih edilen dil.
scoreTag string Gönderim puanı hakkında daha fazla bilgi. Değerler RFC 3986'nın 2.3 bölümünde tanımlandığı şekilde en fazla 64 URI güvenli karakter içermelidir.

Yetkilendirme

Bu istek, aşağıdaki kapsamla yetkilendirme gerektiriyor:

Kapsam
https://www.googleapis.com/auth/games

Daha fazla bilgi edinmek için kimlik doğrulama ve yetkilendirme sayfasını inceleyin.

İstek metni

Bu yöntemi içeren bir istek gövdesi sağlamayın.

Yanıt

Başarılı olursa bu yöntem aşağıdaki yapıya sahip bir yanıt gövdesi döndürür:

{
  "kind": "games#playerScoreResponse",
  "beatenScoreTimeSpans": [
    string
  ],
  "unbeatenScores": [
    {
      "kind": "games#playerScore",
      "timeSpan": string,
      "score": long,
      "formattedScore": string,
      "scoreTag": string
    }
  ],
  "formattedScore": string,
  "leaderboardId": string,
  "scoreTag": string
}
Mülk adı Değer Açıklama Notlar
kind string Bu kaynağın türünü benzersiz bir şekilde tanımlar. Değer her zaman games#playerScoreResponse sabit dizesidir.
beatenScoreTimeSpans[] list Gönderilen puanın söz konusu zaman aralığındaki mevcut puandan daha iyi olduğu süre.
Olası değerler:
  • "ALL_TIME": Puan, tüm zamanlara ait bir puandır.
  • "WEEKLY": Puan, haftalık puandır.
  • "DAILY" - Günlük puan.
unbeatenScores[] list Geçmeyen zaman aralıklarındaki puanlar. Örneğin, gönderilen puan oyuncunun DAILY puanından daha iyi ancak WEEKLY veya ALL_TIME zaman aralığındaki oyuncu puanlarından daha iyi olmayabilir.
unbeatenScores[].kind string Bu kaynağın türünü benzersiz bir şekilde tanımlar. Değer her zaman games#playerScore sabit dizesidir.
unbeatenScores[].timeSpan string Bu oyuncu puanının zaman aralığı.
Olası değerler:
  • "ALL_TIME": Puan, tüm zamanlara ait bir puandır.
  • "WEEKLY": Puan, haftalık puandır.
  • "DAILY" - Günlük puan.


Kabul edilen değerler şunlardır:
  • "ALL_TIME"
  • "DAILY"
  • "WEEKLY"
unbeatenScores[].score long Bu oyuncu puanının sayısal değeri.
unbeatenScores[].formattedScore string Bu oyuncu puanının biçimlendirilmiş puanı.
unbeatenScores[].scoreTag string Bu skor hakkında daha fazla bilgi. Değerler RFC 3986'nın 2.3 bölümünde tanımlandığı şekilde en fazla 64 URI güvenli karakter içerir.
formattedScore string Gönderilen puanın biçimlendirilmiş değeri.
leaderboardId string Bu skorun gönderildiği skor tablosu kimliği.
scoreTag string Bu skor hakkında daha fazla bilgi. Değerler RFC 3986'nın 2.3 bölümünde tanımlandığı şekilde en fazla 64 URI güvenli karakter içerir.

Deneyin.

Bu yöntemi canlı verilerde çağırmak ve yanıtı görmek için aşağıdaki API Gezgini'ni kullanın.