Method: players.getMultipleApplicationPlayerIds
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
يمكنك الحصول على أرقام تعريف مشغّل التطبيق للّاعب الذي تمت مصادقته حاليًا في جميع الألعاب المطلوبة من قِبل المطوّر نفسه الذي يستخدمه تطبيق الاتصال. سيؤدي هذا الإجراء إلى عرض أرقام تعريف فقط للّاعبين الذين لديهم رقم تعريف (في نطاق معيّن أو غير ذلك) في هذه اللعبة.
طلب HTTP
GET https://games.googleapis.com/games/v1/players/me/multipleApplicationPlayerIds
معامِلات طلب البحث
المعلمات |
applicationIds[] |
string
مطلوب. أرقام تعريف التطبيقات من Google Play Console للألعاب التي تعرض معرّفات النطاق لها.
|
نص الطلب
يجب أن يكون نص الطلب فارغًا.
نص الاستجابة
رسالة استجابة للاعبين.getMultipleApplicationPlayerIds rpc.
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
الحقول |
playerIds[] |
object (ApplicationPlayerId )
النتائج فقط. التطبيقات المطلوبة إلى جانب المعرّفات ذات نطاق معيّن للمشغّل، إذا كان هذا المشغّل لديه رقم تعريف للتطبيق. إذا لم يكن الأمر كذلك، لن يتم تضمين التطبيق في الرد.
|
نطاقات الأذونات
يتطلب هذا الإعداد أحد نطاقات 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
معرّف المشغّل للتطبيق.
|
يخضع كل من المحتوى وعيّنات التعليمات البرمجية في هذه الصفحة للتراخيص الموضحّة في ترخيص استخدام المحتوى. إنّ Java وOpenJDK هما علامتان تجاريتان مسجَّلتان لشركة Oracle و/أو الشركات التابعة لها.
تاريخ التعديل الأخير: 2025-07-27 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","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 (حسب التوقيت العالمي المتفَّق عليه)"],[],[],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. |"]]