Scores: reset
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
يتطلّب تفويضًا
سيعيد ضبط النتائج للوحة الصدارة باستخدام رقم التعريف المحدّد للمشغّل الذي تمت مصادقته حاليًا. لا يمكن الوصول إلى هذه الطريقة إلا لحسابات المختبِرين في القائمة البيضاء لتطبيقك.
الطلب
طلب HTTP
POST https://www.googleapis.com/games/v1management/leaderboards/leaderboardId/scores/reset
المعلمات
اسم المعلَمة |
القيمة |
الوصف |
مَعلمات المسار |
leaderboardId |
string |
رقم تعريف لوحة الصدارة.
|
التفويض
يتطلب هذا الطلب تفويضًا بالنطاق التالي (مزيد من المعلومات عن المصادقة والترخيص).
النطاق |
https://www.googleapis.com/auth/games |
نص الطلب
لا توفِّر نصًّا للطلب باستخدام هذه الطريقة.
الرد
في حال نجاح هذه الطريقة، سيتم عرض نص استجابة بالبنية التالية:
{
"kind": "gamesManagement#playerScoreResetResponse",
"definitionId": string,
"resetScoreTimeSpans": [
string
]
}
اسم الموقع |
القيمة |
الوصف |
ملاحظات |
kind |
string |
تُحدِّد نوع هذا المورد بشكلٍ فريد. وتكون القيمة دائمًا هي السلسلة الثابتة gamesManagement#playerScoreResetResponse . |
|
resetScoreTimeSpans[] |
list |
الفترات الزمنية للنتيجة المعدَّلة. القيم المحتملة هي: - "
ALL_TIME " - النتيجة هي النتيجة طوال الوقت. - "
WEEKLY " - النتيجة هي نتيجة أسبوعية. - "
DAILY " - النتيجة هي نتيجة يومية. |
|
definitionId |
string |
رقم تعريف لوحة الصدارة التي تم تعديل حالة اللاعب لها. |
|
يخضع كل من المحتوى وعيّنات التعليمات البرمجية في هذه الصفحة للتراخيص الموضحّة في ترخيص استخدام المحتوى. إنّ 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,["# Scores: reset\n\n**Requires [authorization](#auth)**\n\nResets scores for the leaderboard with the given ID for the currently authenticated player. This method is only accessible to whitelisted tester accounts for your application.\n\nRequest\n-------\n\n### HTTP request\n\n```\nPOST https://www.googleapis.com/games/v1management/leaderboards/leaderboardId/scores/reset\n```\n\n### Parameters\n\n| Parameter name | Value | Description |\n|-----------------|----------|----------------------------|\n| **Path parameters** |||\n| `leaderboardId` | `string` | The ID of the leaderboard. |\n\n### Authorization\n\nThis request requires authorization with the following scope ([read more about authentication and authorization](/accounts/docs/OAuth2)).\n\n| Scope |\n|-----------------------------------------|\n| `https://www.googleapis.com/auth/games` |\n\n### Request body\n\nDo not supply a request body with this method.\n\nResponse\n--------\n\nIf successful, this method returns a response body with the following structure:\n\n```text\n{\n \"kind\": \"gamesManagement#playerScoreResetResponse\",\n \"definitionId\": string,\n \"resetScoreTimeSpans\": [\n string\n ]\n}\n```\n\n| Property name | Value | Description | Notes |\n|-------------------------|----------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------|\n| `kind` | `string` | Uniquely identifies the type of this resource. Value is always the fixed string `gamesManagement#playerScoreResetResponse`. | |\n| `resetScoreTimeSpans[]` | `list` | The time spans of the updated score. Possible values are: - \"`ALL_TIME`\" - The score is an all-time score. - \"`WEEKLY`\" - The score is a weekly score. - \"`DAILY`\" - The score is a daily score. | |\n| `definitionId` | `string` | The ID of an leaderboard for which player state has been updated. | |"]]