Method: scores.submit

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

طلب HTTP

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

مَعلمات المسار

المَعلمات
leaderboardId

string

رقم تعريف لوحة الصدارة.

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

المَعلمات
language

string

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

score

string (int64 format)

مطلوبة. النتيجة التي ترسلها يتم تجاهل النتيجة التي تم إرسالها إذا كانت أسوأ من النتيجة التي تم إرسالها سابقًا، حيث يعتمد الأسوأ على نظام الترتيب في لوحة الصدارة. ويعتمد معنى قيمة النتيجة على نوع تنسيق لوحة الصدارة. أمّا بالنسبة إلى النقطة الثابتة، فيمثّل الدرجة القيمة الأولية. وبالنسبة إلى الوقت، تمثل النتيجة الوقت المنقضي بالمللي ثانية. وبالنسبة إلى العملة، تمثل النتيجة قيمة بالوحدات الدقيقة.

scoreTag

string

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

نص الطلب

يجب أن يكون نص الطلب فارغًا.

نص الاستجابة

إذا كانت الاستجابة ناجحة، يحتوي نص الاستجابة على مثال SubmitLeaderboardScoreResponse.

نطاقات التفويض

يتطلب استخدام أحد نطاقات OAuth التالية:

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

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