Method: players.getMultipleApplicationPlayerIds
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Receba os IDs de jogadores do aplicativo para o jogador autenticado em todos os jogos solicitados pelo mesmo desenvolvedor do aplicativo de chamada. Isso vai retornar apenas os IDs dos jogadores que realmente têm um ID (com escopo ou não) com esse jogo.
Solicitação HTTP
GET https://games.googleapis.com/games/v1/players/me/multipleApplicationPlayerIds
Parâmetros de consulta
Parâmetros |
applicationIds[] |
string
Obrigatório. Os IDs de aplicativos do console para desenvolvedores do Google Play para que os jogos retornem IDs de escopo.
|
Corpo da solicitação
O corpo da solicitação precisa estar vazio.
Corpo da resposta
Mensagem de resposta para o rpc players.getMultipleApplicationPlayerIds.
Se bem-sucedido, o corpo da resposta incluirá dados com a estrutura a seguir:
Campos |
playerIds[] |
object (ApplicationPlayerId )
Apenas saída. Os aplicativos solicitados e os IDs de escopo do player, se ele tiver um ID para o aplicativo. Caso contrário, o aplicativo não será incluído na resposta.
|
Escopos de autorização
Requer um dos seguintes escopos do OAuth:
https://www.googleapis.com/auth/games
https://www.googleapis.com/auth/games_lite
Para mais informações, consulte a Visão geral do OAuth 2.0.
ApplicationPlayerId
Identificador de player de escopo principal para um aplicativo.
Representação JSON |
{
"applicationId": string,
"playerId": string
} |
Campos |
applicationId |
string
O aplicativo para o qual este identificador de jogador é destinado.
|
playerId |
string
O identificador do jogador para o app.
|
O conteúdo e os exemplos de código nesta página estão sujeitos às licenças descritas na Licença de conteúdo. Java e OpenJDK são marcas registradas da Oracle e/ou suas afiliadas.
Última atualização 2025-07-27 UTC.
[null,null,["Última atualização 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. |"]]