Method: recall.gamesPlayerTokens
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
يمكنك استرداد رموز Recall المميّزة من جميع الألعاب المطلوبة المرتبطة بمشغّل "خدمات ألعاب Play" المشفر في رقم تعريف جلسة الاستدعاء المقدَّم. لا تتوفّر واجهة برمجة التطبيقات إلا للمستخدمين الذين لديهم ملف شخصي نشط في "مشغّل ألعاب Play".
طلب HTTP
GET https://games.googleapis.com/games/v1/recall/gamesPlayerTokens/{sessionId}
مَعلمات المسار
| المعلمات |
sessionId |
string
مطلوب. سلسلة معتمة ينشئها الخادم ترمّز جميع المعلومات اللازمة لتحديد مشغّل "خدمات ألعاب Play" / مستخدم Google وتطبيقها
|
معامِلات طلب البحث
| المعلمات |
applicationIds[] |
string
مطلوب. أرقام تعريف التطبيقات من Google Play Console للألعاب التي تعرض معرّفات النطاق لها.
|
نص الطلب
يجب أن يكون نص الطلب فارغًا.
نص الاستجابة
قائمة ببيانات الرمز المميّز لتذكُّر بيانات الألعاب التي يتم عرضها من خلال استدعاء إجراء عن بُعد (RPC) لألعاب المحاكاة.gamesPlayerTokens
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
| الحقول |
gamePlayerTokens[] |
object (GamePlayerToken)
التطبيقات المطلوبة إلى جانب الرموز المميّزة لتذكُّر بيانات الألعاب للّاعب إذا لم يكن لدى اللاعب رموز لتذكُّر بيانات أحد التطبيقات، لن يتم تضمين هذا التطبيق في الردّ.
|
نطاقات الأذونات
يجب توفير نطاق OAuth التالي:
https://www.googleapis.com/auth/androidpublisher
لمزيد من المعلومات، يُرجى الاطِّلاع على نظرة عامة على OAuth 2.0.
يخضع كل من المحتوى وعيّنات التعليمات البرمجية في هذه الصفحة للتراخيص الموضحّة في ترخيص استخدام المحتوى. إنّ 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: recall.gamesPlayerTokens\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n - [JSON representation](#body.RetrieveGamesPlayerTokensResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nRetrieve the Recall tokens from all requested games that is associated with the PGS Player encoded in the provided recall session id. The API is only available for users that have an active PGS Player profile.\n\n### HTTP request\n\n`GET https://games.googleapis.com/games/v1/recall/gamesPlayerTokens/{sessionId}`\n\n### Path parameters\n\n| Parameters ||\n|-------------|--------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `sessionId` | `string` Required. Opaque server-generated string that encodes all the necessary information to identify the PGS player / Google user and application. |\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\nA list of recall token data returned from the recall.gamesPlayerTokens RPC\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|--------------------------------------------------------------------------------------------------|\n| ``` { \"gamePlayerTokens\": [ { object (/games/services/web/api/rest/v1/GamePlayerToken) } ] } ``` |\n\n| Fields ||\n|----------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `gamePlayerTokens[]` | `object (`[GamePlayerToken](/games/services/web/api/rest/v1/GamePlayerToken)`)` The requested applications along with the recall tokens for the player. If the player does not have recall tokens for an application, that application is not included in the response. |\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/androidpublisher`\n\nFor more information, see the [OAuth 2.0 Overview](https://developers.google.com/identity/protocols/OAuth2)."]]
