Method: recall.retrieveTokens
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
يمكنك استرداد جميع الرموز المميّزة لتذكُّر بيانات الألعاب المرتبطة بمشغّل "خدمات ألعاب Play" المشفر في رقم تعريف جلسة الاستدعاء المقدَّم. لا تتوفّر واجهة برمجة التطبيقات إلا للمستخدمين الذين لديهم ملف شخصي نشِط في "مشغّل ألعاب Play".
طلب HTTP
GET https://games.googleapis.com/games/v1/recall/tokens/{sessionId}
مَعلمات المسار
| المعلمات |
sessionId |
string
مطلوب. سلسلة معتمة ينشئها الخادم ترمّز جميع المعلومات اللازمة لتحديد مشغّل "خدمات ألعاب Play" / مستخدم Google وتطبيقها
|
نص الطلب
يجب أن يكون نص الطلب فارغًا.
نص الاستجابة
الاستجابة لطلب استرداد البيانات.
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
| الحقول |
tokens[] |
object (RecallToken)
مطلوب. الرموز المميّزة لتذكُّر بيانات الألعاب المرتبطة بالجهة الرئيسية المطلوبة لمشغّل "خدمات ألعاب Play"
|
نطاقات الأذونات
يجب توفير نطاق 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.retrieveTokens\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n - [JSON representation](#body.RetrievePlayerTokensResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nRetrieve all Recall tokens associated with the PGS Player encoded in the provided recall session id. The API is only available for users that have active PGS Player profile.\n\n### HTTP request\n\n`GET https://games.googleapis.com/games/v1/recall/tokens/{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### Request body\n\nThe request body must be empty.\n\n### Response body\n\nResponse for the recall.retrieveTokens RPC\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|------------------------------------------------------------------------------------|\n| ``` { \"tokens\": [ { object (/games/services/web/api/rest/v1/RecallToken) } ] } ``` |\n\n| Fields ||\n|------------|----------------------------------------------------------------------------------------------------------------------------------------------------|\n| `tokens[]` | `object (`[RecallToken](/games/services/web/api/rest/v1/RecallToken)`)` Required. Recall tokens associated with the requested PGS Player principal |\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)."]]
