Method: accesstokens.generateRecallPlayGroupingApiToken
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
إنشاء رمز مميّز لواجهة برمجة التطبيقات Play Grouping API لمستخدم "خدمات ألعاب Play" المحدَّد من خلال رقم تعريف جلسة Recall المقدَّم في الطلب
طلب HTTP
POST https://games.googleapis.com/games/v1/accesstokens/generateRecallPlayGroupingApiToken
معامِلات طلب البحث
| المعلمات |
packageName |
string
مطلوب. اسم حزمة التطبيق لإنشاء الرمز المميّز لها (مثل com.example.mygame).
|
persona |
string
مطلوب. شخصية يجب ربطها بالرمز المميز. الشخصية هي معرّف ثابت للمستخدم يوفره المطور. يجب أن يتم إنشاؤه بشكل حاسم (على سبيل المثال، كتجزئة باتجاه واحد) من رقم تعريف حساب المستخدم ورقم تعريف الملف الشخصي للمستخدم (إذا كان التطبيق يتضمن هذا المفهوم)، وفقًا لنظام هوية المستخدم لدى المطوِّر.
|
recallSessionId |
string
مطلوب. سلسلة معتمة ينشئها الخادم ترمّز جميع المعلومات اللازمة لتحديد مشغّل "خدمات ألعاب Play" / مستخدم Google وتطبيقها يمكنك الاطّلاع على https://developer.android.com/games/pgs/recall/recall-setup للتعرّف على كيفية الدمج مع ميزة Recall والحصول على معرّف الجلسة.
|
نص الطلب
يجب أن يكون نص الطلب فارغًا.
نص الاستجابة
الاستجابة لـ accesstokens.generateRecallPlayGroupingApiToken RPC.
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
| الحقول |
token |
object (PlayGroupingApiToken)
رمز مميّز للوصول إلى واجهة برمجة التطبيقات Play Grouping API
|
نطاقات الأذونات
يجب توفير نطاق 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: accesstokens.generateRecallPlayGroupingApiToken\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.GenerateRecallPlayGroupingApiTokenResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nGenerates a Play Grouping API token for the PGS user identified by the Recall session ID provided in the request.\n\n### HTTP request\n\n`POST https://games.googleapis.com/games/v1/accesstokens/generateRecallPlayGroupingApiToken`\n\n### Query parameters\n\n| Parameters ||\n|-------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `packageName` | `string` Required. App package name to generate the token for (e.g. com.example.mygame). |\n| `persona` | `string` Required. Persona to associate with the token. Persona is a developer-provided stable identifier of the user. Must be deterministically generated (e.g. as a one-way hash) from the user account ID and user profile ID (if the app has the concept), according to the developer's own user identity system. |\n| `recallSessionId` | `string` Required. Opaque server-generated string that encodes all the necessary information to identify the PGS player / Google user and application. See \u003chttps://developer.android.com/games/pgs/recall/recall-setup\u003e on how to integrate with Recall and get session ID. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nResponse for the accesstokens.generateRecallPlayGroupingApiToken RPC.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|----------------------------------------------------------------------------------------|\n| ``` { \"token\": { object (/games/services/web/api/rest/v1/PlayGroupingApiToken) } } ``` |\n\n| Fields ||\n|---------|--------------------------------------------------------------------------------------------------------------------------------------|\n| `token` | `object (`[PlayGroupingApiToken](/games/services/web/api/rest/v1/PlayGroupingApiToken)`)` Token for accessing the Play Grouping API. |\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)."]]
