Method: stats.get
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
عرض إحصاءات التفاعل والإنفاق في هذا التطبيق للمستخدم الذي تمت مصادقته حاليًا.
طلب HTTP
GET https://games.googleapis.com/games/v1/stats
نص الطلب
يجب أن يكون نص الطلب فارغًا.
نص الاستجابة
مورد إحصاءات تابع لجهة خارجية
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
| تمثيل JSON |
{
"churn_probability": number,
"num_purchases": integer,
"spend_percentile": number,
"days_since_last_played": integer,
"num_sessions": integer,
"num_sessions_percentile": number,
"avg_session_length_minutes": number,
"spend_probability": number,
"high_spender_probability": number,
"total_spend_next_28_days": number,
"kind": string
} |
| الحقول |
churn_probability |
number
احتمالية عدم عودة اللاعب لتشغيل اللعبة في اليوم التالي. على سبيل المثال: 0، 0.1، 0.5، ...، 1.0. لا تتم تعبئة هذا الحقل إذا لم تتوفّر معلومات كافية.
|
num_purchases |
integer
عدد عمليات الشراء داخل التطبيق التي أجراها اللاعب في هذه اللعبة على سبيل المثال: 0، 1، 5، 10، ... . لا تتم تعبئة هذا الحقل إذا لم تتوفّر معلومات كافية.
|
spend_percentile |
number
النسبة المئوية التقريبية للإنفاق للاعب في هذه اللعبة على سبيل المثال: 0، 0.25، 0.5، 0.75. لا تتم تعبئة هذا الحقل إذا لم تتوفّر معلومات كافية.
|
days_since_last_played |
integer
عدد الأيام التي مرّت منذ آخر مرة لعب فيها اللاعب هذه اللعبة. على سبيل المثال: 0، 1، 5، 10، ... . لا تتم تعبئة هذا الحقل إذا لم تتوفّر معلومات كافية.
|
num_sessions |
integer
العدد التقريبي لجلسات اللاعب خلال آخر 28 يومًا، حيث تبدأ الجلسة عندما يكون اللاعب متصلاً بخدمات ألعاب Play وتنتهي عندما يكون غير متصل بالإنترنت. على سبيل المثال: 0، 1، 5، 10، ... . لا تتم تعبئة هذا الحقل إذا لم تتوفّر معلومات كافية.
|
num_sessions_percentile |
number
يشير ذلك إلى القيمة التقريبية للجلسات بالنسبة إلى اللاعب خلال آخر 30 يومًا، حيث تبدأ الجلسة عندما يكون اللاعب متصلاً بخدمات ألعاب Play وتنتهي عند عدم اتصاله بالإنترنت. على سبيل المثال: 0، 0.25، 0.5، 0.75. لا تتم تعبئة هذا الحقل إذا لم تتوفّر معلومات كافية.
|
avg_session_length_minutes |
number
متوسط مدة الجلسة بالدقائق للمشغّل على سبيل المثال: 1، 30، 60، ... . لا تتم تعبئة هذا الحقل إذا لم تتوفّر معلومات كافية.
|
spend_probability |
number
احتمالية أن ينفق اللاعب اللعبة خلال الأيام السبعة المقبلة. على سبيل المثال: 0، 0.25، 0.50، 0.75. لا تتم تعبئة هذا الحقل إذا لم تتوفّر معلومات كافية.
|
high_spender_probability |
number
احتمالية أن ينفق اللاعب مبلغ أكبر من الحدّ الأدنى من المال. على سبيل المثال: 0، 0.25، 0.50، 0.75. لا تتم تعبئة هذا الحقل إذا لم تتوفّر معلومات كافية.
|
total_spend_next_28_days |
number
المبلغ المتوقع الذي سينفقه اللاعب خلال الأيام الـ 28 المقبلة. على سبيل المثال: 1، 30، 60، ... . لا تتم تعبئة هذا الحقل إذا لم تتوفّر معلومات كافية.
|
kind |
string
تُحدِّد نوع هذا المورد بشكلٍ فريد. وتكون القيمة دائمًا هي السلسلة الثابتة games#statsResponse.
|
نطاقات الأذونات
يتطلب هذا الإعداد أحد نطاقات 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: stats.get\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n - [JSON representation](#body.PlayerStats.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nReturns engagement and spend statistics in this application for the currently authenticated user.\n\n### HTTP request\n\n`GET https://games.googleapis.com/games/v1/stats`\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nA third party stats resource.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"churn_probability\": number, \"num_purchases\": integer, \"spend_percentile\": number, \"days_since_last_played\": integer, \"num_sessions\": integer, \"num_sessions_percentile\": number, \"avg_session_length_minutes\": number, \"spend_probability\": number, \"high_spender_probability\": number, \"total_spend_next_28_days\": number, \"kind\": string } ``` |\n\n| Fields ||\n|------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `churn_probability` | `number` The probability of the player not returning to play the game in the next day. E.g., 0, 0.1, 0.5, ..., 1.0. Not populated if there is not enough information. |\n| `num_purchases` | `integer` Number of in-app purchases made by the player in this game. E.g., 0, 1, 5, 10, ... . Not populated if there is not enough information. |\n| `spend_percentile` | `number` The approximate spend percentile of the player in this game. E.g., 0, 0.25, 0.5, 0.75. Not populated if there is not enough information. |\n| `days_since_last_played` | `integer` Number of days since the player last played this game. E.g., 0, 1, 5, 10, ... . Not populated if there is not enough information. |\n| `num_sessions` | `integer` The approximate number of sessions of the player within the last 28 days, where a session begins when the player is connected to Play Games Services and ends when they are disconnected. E.g., 0, 1, 5, 10, ... . Not populated if there is not enough information. |\n| `num_sessions_percentile` | `number` The approximation of the sessions percentile of the player within the last 30 days, where a session begins when the player is connected to Play Games Services and ends when they are disconnected. E.g., 0, 0.25, 0.5, 0.75. Not populated if there is not enough information. |\n| `avg_session_length_minutes` | `number` Average session length in minutes of the player. E.g., 1, 30, 60, ... . Not populated if there is not enough information. |\n| `spend_probability` | `number` The probability of the player going to spend the game in the next seven days. E.g., 0, 0.25, 0.50, 0.75. Not populated if there is not enough information. |\n| `high_spender_probability` | `number` The probability of the player going to spend beyond a threshold amount of money. E.g., 0, 0.25, 0.50, 0.75. Not populated if there is not enough information. |\n| `total_spend_next_28_days` | `number` The predicted amount of money that the player going to spend in the next 28 days. E.g., 1, 30, 60, ... . Not populated if there is not enough information. |\n| `kind` | `string` Uniquely identifies the type of this resource. Value is always the fixed string `games#statsResponse`. |\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)."]]
