Method: players.getMultipleApplicationPlayerIds
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
호출 애플리케이션과 동일한 개발자가 요청한 모든 게임에서 현재 인증된 플레이어의 애플리케이션 플레이어 ID를 가져옵니다. 그러면 해당 게임에 실제로 ID (범위 지정 여부와 관계없음)가 있는 플레이어의 ID만 반환됩니다.
HTTP 요청
GET https://games.googleapis.com/games/v1/players/me/multipleApplicationPlayerIds
쿼리 매개변수
매개변수 |
applicationIds[] |
string
필수 항목입니다. 게임에서 범위 ID를 반환할 Google Play Console의 애플리케이션 ID입니다.
|
응답 본문
players.getMultipleApplicationPlayerIds RPC의 응답 메시지입니다.
성공하면 응답 본문에 다음과 같은 구조의 데이터가 포함됩니다.
필드 |
playerIds[] |
object (ApplicationPlayerId )
출력 전용입니다. 요청된 애플리케이션과 해당 플레이어의 범위 지정된 ID(플레이어에 애플리케이션 ID가 있는 경우) 그렇지 않으면 애플리케이션이 응답에 포함되지 않습니다.
|
승인 범위
다음 OAuth 범위 중 하나가 필요합니다.
https://www.googleapis.com/auth/games
https://www.googleapis.com/auth/games_lite
자세한 내용은 OAuth 2.0 개요를 참고하세요.
ApplicationPlayerId
애플리케이션의 기본 범위 플레이어 식별자입니다.
JSON 표현 |
{
"applicationId": string,
"playerId": string
} |
필드 |
applicationId |
string
이 플레이어 식별자가 속한 애플리케이션입니다.
|
playerId |
string
애플리케이션의 플레이어 식별자입니다.
|
이 페이지에 나와 있는 콘텐츠와 코드 샘플에는 콘텐츠 라이선스에서 설명하는 라이선스가 적용됩니다. 자바 및 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.getMultipleApplicationPlayerIds\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.GetMultipleApplicationPlayerIdsResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [ApplicationPlayerId](#ApplicationPlayerId)\n - [JSON representation](#ApplicationPlayerId.SCHEMA_REPRESENTATION)\n- [Try it!](#try-it)\n\nGet the application player ids for the currently authenticated player across all requested games by the same developer as the calling application. This will only return ids for players that actually have an id (scoped or otherwise) with that game.\n\n### HTTP request\n\n`GET https://games.googleapis.com/games/v1/players/me/multipleApplicationPlayerIds`\n\n### Query parameters\n\n| Parameters ||\n|--------------------|-----------------------------------------------------------------------------------------------------------------------|\n| `applicationIds[]` | `string` Required. The application IDs from the Google Play developer console for the games to return scoped ids for. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nResponse message for players.getMultipleApplicationPlayerIds rpc.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|---------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"playerIds\": [ { object (/games/services/web/api/rest/v1/players/getMultipleApplicationPlayerIds#ApplicationPlayerId) } ] } ``` |\n\n| Fields ||\n|---------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `playerIds[]` | `object (`[ApplicationPlayerId](/games/services/web/api/rest/v1/players/getMultipleApplicationPlayerIds#ApplicationPlayerId)`)` Output only. The requested applications along with the scoped ids for tha player, if that player has an id for the application. If not, the application is not included in the response. |\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\nApplicationPlayerId\n-------------------\n\nPrimary scoped player identifier for an application.\n\n| JSON representation |\n|---------------------------------------------------------|\n| ``` { \"applicationId\": string, \"playerId\": string } ``` |\n\n| Fields ||\n|-----------------|--------------------------------------------------------------|\n| `applicationId` | `string` The application that this player identifier is for. |\n| `playerId` | `string` The player identifier for the application. |"]]