Scores: reset
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
승인 필요
현재 인증된 플레이어의 지정된 ID로 리더보드 점수를 재설정합니다. 이 메서드는 애플리케이션의 허용 목록에 있는 테스터 계정만 액세스할 수 있습니다.
요청
HTTP 요청
POST https://www.googleapis.com/games/v1management/leaderboards/leaderboardId/scores/reset
매개변수
매개변수 이름 |
값 |
설명 |
경로 매개변수 |
leaderboardId |
string |
리더보드의 ID입니다.
|
승인
이 요청에는 다음 범위의 승인이 필요합니다 (인증 및 승인 자세히 알아보기).
범위 |
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 |
플레이어 상태가 업데이트된 리더보드의 ID입니다. |
|
이 페이지에 나와 있는 콘텐츠와 코드 샘플에는 콘텐츠 라이선스에서 설명하는 라이선스가 적용됩니다. 자바 및 OpenJDK는 Oracle 및 Oracle 계열사의 상표 또는 등록 상표입니다.
최종 업데이트: 2025-07-27(UTC)
[[["이해하기 쉬움","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(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. | |"]]