Method: scores.submitMultiple
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
يرسل نتائج متعددة إلى قوائم الصدارة.
طلب HTTP
POST https://games.googleapis.com/games/v1/leaderboards/scores
معامِلات طلب البحث
المعلمات |
language |
string
اللغة المفضلة المراد استخدامها للسلاسل التي يتم عرضها بهذه الطريقة.
|
نص الطلب
يحتوي نص الطلب على مثال PlayerScoreSubmissionList
.
نص الاستجابة
قائمة بحالات إرسال الدرجات
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
الحقول |
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
قائمة بطلبات إرسال الدرجات
الحقول |
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.
|
يخضع كل من المحتوى وعيّنات التعليمات البرمجية في هذه الصفحة للتراخيص الموضحّة في ترخيص استخدام المحتوى. إنّ Java وOpenJDK هما علامتان تجاريتان مسجَّلتان لشركة Oracle و/أو الشركات التابعة لها.
تاريخ التعديل الأخير: 2025-07-27 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","easyToUnderstand","thumb-up"],["ساعَدني المحتوى في حلّ مشكلتي.","solvedMyProblem","thumb-up"],["غير ذلك","otherUp","thumb-up"]],[["لا يحتوي على المعلومات التي أحتاج إليها.","missingTheInformationINeed","thumb-down"],["الخطوات معقدة للغاية / كثيرة جدًا.","tooComplicatedTooManySteps","thumb-down"],["المحتوى قديم.","outOfDate","thumb-down"],["ثمة مشكلة في الترجمة.","translationIssue","thumb-down"],["مشكلة في العيّنات / التعليمات البرمجية","samplesCodeIssue","thumb-down"],["غير ذلك","otherDown","thumb-down"]],["تاريخ التعديل الأخير: 2025-07-27 (حسب التوقيت العالمي المتفَّق عليه)"],[],[],null,["# Method: scores.submitMultiple\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n - [JSON representation](#body.SubmitMultipleLeaderboardScoresResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [PlayerScoreSubmissionList](#PlayerScoreSubmissionList)\n - [JSON representation](#PlayerScoreSubmissionList.SCHEMA_REPRESENTATION)\n- [ScoreSubmission](#ScoreSubmission)\n - [JSON representation](#ScoreSubmission.SCHEMA_REPRESENTATION)\n- [Try it!](#try-it)\n\nSubmits multiple scores to leaderboards.\n\n### HTTP request\n\n`POST https://games.googleapis.com/games/v1/leaderboards/scores`\n\n### Query parameters\n\n| Parameters ||\n|------------|-----------------------------------------------------------------------------|\n| `language` | `string` The preferred language to use for strings returned by this method. |\n\n### Request body\n\nThe request body contains an instance of [PlayerScoreSubmissionList](/games/services/web/api/rest/v1/scores/submitMultiple#PlayerScoreSubmissionList).\n\n### Response body\n\nA list of score submission statuses.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|--------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"kind\": string, \"submittedScores\": [ { object (/games/services/web/api/rest/v1/SubmitLeaderboardScoreResponse) } ] } ``` |\n\n| Fields ||\n|---------------------|-----------------------------------------------------------------------------------------------------------------------------------------------|\n| `kind` | `string` Uniquely identifies the type of this resource. Value is always the fixed string `games#playerScoreListResponse`. |\n| `submittedScores[]` | `object (`[SubmitLeaderboardScoreResponse](/games/services/web/api/rest/v1/SubmitLeaderboardScoreResponse)`)` The score submissions statuses. |\n\n### Authorization scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://www.googleapis.com/auth/games`\n- `\n https://www.googleapis.com/auth/games_lite`\n\nFor more information, see the [OAuth 2.0 Overview](https://developers.google.com/identity/protocols/OAuth2).\n\nPlayerScoreSubmissionList\n-------------------------\n\nA list of score submission requests.\n\n| JSON representation |\n|------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"kind\": string, \"scores\": [ { object (/games/services/web/api/rest/v1/scores/submitMultiple#ScoreSubmission) } ] } ``` |\n\n| Fields ||\n|------------|------------------------------------------------------------------------------------------------------------------------------|\n| `kind` | `string` Uniquely identifies the type of this resource. Value is always the fixed string `games#playerScoreSubmissionList`. |\n| `scores[]` | `object (`[ScoreSubmission](/games/services/web/api/rest/v1/scores/submitMultiple#ScoreSubmission)`)` The score submissions. |\n\nScoreSubmission\n---------------\n\nA request to submit a score to leaderboards.\n\n| JSON representation |\n|---------------------------------------------------------------------------------------------------------------|\n| ``` { \"kind\": string, \"leaderboardId\": string, \"score\": string, \"scoreTag\": string, \"signature\": string } ``` |\n\n| Fields ||\n|-----------------|--------------------------------------------------------------------------------------------------------------------------------------------------|\n| `kind` | `string` Uniquely identifies the type of this resource. Value is always the fixed string `games#scoreSubmission`. |\n| `leaderboardId` | `string` The leaderboard this score is being submitted to. |\n| `score` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` The new score being submitted. |\n| `scoreTag` | `string` Additional information about this score. Values will contain no more than 64 URI-safe characters as defined by section 2.3 of RFC 3986. |\n| `signature` | `string` Signature Values will contain URI-safe characters as defined by section 2.3 of RFC 3986. |"]]