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 (שעון UTC).
[null,null,["עדכון אחרון: 2025-07-27 (שעון UTC)."],[],[],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. | |"]]
