Method: players.getScopedPlayerIds
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
현재 인증된 사용자의 범위가 지정된 플레이어 식별자를 가져옵니다.
HTTP 요청
GET https://games.googleapis.com/games/v1/players/me/scopedIds
응답 본문
범위가 지정된 플레이어 식별자입니다.
성공하면 응답 본문에 다음과 같은 구조의 데이터가 포함됩니다.
| JSON 표현 |
{
"gamePlayerId": string,
"developerPlayerKey": string
} |
| 필드 |
gamePlayerId |
string
게임 범위 플레이어 식별자입니다. 이 ID는 players.get gamePlayerId 필드에서 반환되는 ID와 동일합니다.
|
developerPlayerKey |
string
지정된 개발자의 모든 게임에서 플레이어의 식별자입니다. 모든 플레이어는 한 개발자의 모든 게임에서 동일한 developerPlayerKey를 갖습니다. 게임이 다른 개발자에게 이전되면 게임의 개발자 플레이어 키가 변경됩니다. gamePlayerId는 변경되지 않습니다.
|
승인 범위
다음 OAuth 범위 중 하나가 필요합니다.
https://www.googleapis.com/auth/games
https://www.googleapis.com/auth/games_lite
자세한 내용은 OAuth 2.0 개요를 참고하세요.
이 페이지에 나와 있는 콘텐츠와 코드 샘플에는 콘텐츠 라이선스에서 설명하는 라이선스가 적용됩니다. 자바 및 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,["# Method: players.getScopedPlayerIds\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n - [JSON representation](#body.ScopedPlayerIds.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nRetrieves scoped player identifiers for currently authenticated user.\n\n### HTTP request\n\n`GET https://games.googleapis.com/games/v1/players/me/scopedIds`\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nScoped player identifiers.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|------------------------------------------------------------------|\n| ``` { \"gamePlayerId\": string, \"developerPlayerKey\": string } ``` |\n\n| Fields ||\n|----------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `gamePlayerId` | `string` Game-scoped player identifier. This is the same id that is returned in players.get gamePlayerId field. |\n| `developerPlayerKey` | `string` Identifier of the player across all games of the given developer. Every player has the same developerPlayerKey in all games of one developer. Developer player key changes for the game if the game is transferred to another developer. Note that gamePlayerId will stay unchanged. |\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)."]]
