Method: scores.submitMultiple

يرسل نتائج متعددة إلى قوائم الصدارة.

طلب HTTP

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

معامِلات طلب البحث

المعلمات
language

string

اللغة المفضلة المراد استخدامها للسلاسل التي يتم عرضها بهذه الطريقة.

نص الطلب

يحتوي نص الطلب على مثال PlayerScoreSubmissionList.

نص الاستجابة

قائمة بحالات إرسال الدرجات

إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:

تمثيل JSON
{
  "kind": string,
  "submittedScores": [
    {
      object (SubmitLeaderboardScoreResponse)
    }
  ]
}
الحقول
kind

string

تُحدِّد نوع هذا المورد بشكلٍ فريد. وتكون القيمة دائمًا هي السلسلة الثابتة games#playerScoreListResponse.

submittedScores[]

object (SubmitLeaderboardScoreResponse)

حالات عمليات إرسال الدرجات.

نطاقات الأذونات

يتطلب هذا الإعداد أحد نطاقات OAuth التالية:

  • https://www.googleapis.com/auth/games
  • https://www.googleapis.com/auth/games_lite

لمزيد من المعلومات، يُرجى الاطِّلاع على نظرة عامة على OAuth 2.0.

PlayerScoreSubmissionList

قائمة بطلبات إرسال الدرجات

تمثيل JSON
{
  "kind": string,
  "scores": [
    {
      object (ScoreSubmission)
    }
  ]
}
الحقول
kind

string

تُحدِّد نوع هذا المورد بشكلٍ فريد. وتكون القيمة دائمًا هي السلسلة الثابتة games#playerScoreSubmissionList.

scores[]

object (ScoreSubmission)

يتم إرسال النتيجة.

ScoreSubmission

طلب لإرسال نتيجة إلى قوائم الصدارة

تمثيل JSON
{
  "kind": string,
  "leaderboardId": string,
  "score": string,
  "scoreTag": string,
  "signature": string
}
الحقول
kind

string

تُحدِّد نوع هذا المورد بشكلٍ فريد. وتكون القيمة دائمًا هي السلسلة الثابتة games#scoreSubmission.

leaderboardId

string

لوحة الصدارة التي يتم إرسال هذه النتيجة إليها.

score

string (int64 format)

يتم إرسال النتيجة الجديدة.

scoreTag

string

معلومات إضافية حول هذه النتيجة لن تحتوي القيم على أكثر من 64 حرفًا آمنًا لمعرّف الموارد المنتظم (URI) كما هو موضّح في الفقرة 2.3 من RFC 3986.

signature

string

ستحتوي قيم التوقيع على أحرف آمنة لمعرّف الموارد المنتظم (URI) كما هو موضّح في الفقرة 2.3 من RFC 3986.