Method: accesstokens.generatePlayGroupingApiToken
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
إنشاء رمز مميّز لواجهة برمجة التطبيقات Play Grouping API لمستخدم "خدمات ألعاب Play" المحدَّد من خلال بيانات الاعتماد المرفقة
طلب HTTP
POST https://games.googleapis.com/games/v1/accesstokens/generatePlayGroupingApiToken
معامِلات طلب البحث
| المعلمات |
packageName |
string
مطلوب. اسم حزمة التطبيق لإنشاء الرمز المميّز لها (مثل com.example.mygame).
|
persona |
string
مطلوب. شخصية يجب ربطها بالرمز المميز. الشخصية هي معرّف ثابت للمستخدم يوفره المطور. يجب أن يتم إنشاؤه بشكل حاسم (على سبيل المثال، كتجزئة باتجاه واحد) من رقم تعريف حساب المستخدم ورقم تعريف الملف الشخصي للمستخدم (إذا كان التطبيق يتضمن هذا المفهوم)، وفقًا لنظام هوية المستخدم لدى المطوِّر.
|
نص الطلب
يجب أن يكون نص الطلب فارغًا.
نص الاستجابة
الاستجابة لـ accesstokens.generatePlayGroupingApiToken RPC.
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
| الحقول |
token |
object (PlayGroupingApiToken)
رمز مميّز للوصول إلى واجهة برمجة التطبيقات Play Grouping API
|
نطاقات الأذونات
يتطلب هذا الإعداد أحد نطاقات OAuth التالية:
https://www.googleapis.com/auth/games
https://www.googleapis.com/auth/games_lite
لمزيد من المعلومات، يُرجى الاطِّلاع على نظرة عامة على 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.generatePlayGroupingApiToken\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.GeneratePlayGroupingApiTokenResponse.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 attached credential.\n\n### HTTP request\n\n`POST https://games.googleapis.com/games/v1/accesstokens/generatePlayGroupingApiToken`\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\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nResponse for the accesstokens.generatePlayGroupingApiToken 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 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)."]]
