- طلب HTTP
- مَعلمات المسار
- معامِلات طلب البحث
- نص الطلب
- نص الاستجابة
- نطاقات التفويض
- التجميع
- MetagameCategory
- جرِّبه الآن
يجب إدراج بيانات التشغيل المجمّعة حسب الفئة للمشغّل playerId
.
طلب HTTP
GET https://games.googleapis.com/games/v1/players/{playerId}/categories/{collection}
مَعلمات المسار
المعلمات | |
---|---|
playerId |
رقم تعريف اللاعب يجب استخدام قيمة |
collection |
مجموعة الفئات التي سيتم عرض البيانات لها. |
معامِلات طلب البحث
المعلمات | |
---|---|
language |
اللغة المفضلة المراد استخدامها للسلاسل التي يتم عرضها بهذه الطريقة. |
maxResults |
الحد الأقصى لعدد موارد الفئة التي سيتم عرضها في الرد، ويتم استخدامه للترقيم. بالنسبة إلى أي استجابة، قد يكون العدد الفعلي لموارد الفئة التي يتم عرضها أقل من القيمة المحدّدة في سمة |
pageToken |
الرمز المميّز الذي تم عرضه من خلال الطلب السابق |
نص الطلب
يجب أن يكون نص الطلب فارغًا.
نص الاستجابة
ردّ فئات الألعاب الوصفية ضمن قائمة تابعة لجهات خارجية
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
تمثيل JSON |
---|
{
"kind": string,
"nextPageToken": string,
"items": [
{
object ( |
الحقول | |
---|---|
kind |
تُحدِّد هذه السمة نوع هذا المورد بشكلٍ فريد. تكون القيمة دائمًا السلسلة الثابتة |
nextPageToken |
الرمز المميّز المقابل لصفحة النتائج التالية. |
items[] |
قائمة الفئات التي تتضمن بيانات استخدام. |
نطاقات الأذونات
يتطلب أحد نطاقات OAuth التالية:
https://www.googleapis.com/auth/games
https://www.googleapis.com/auth/games_lite
لمزيد من المعلومات، يُرجى الاطِّلاع على نظرة عامة على OAuth 2.0.
مجموعة
تحدِّد الفئات التي ستتمّ إعادة عرض بياناتها.
عمليات التعداد | |
---|---|
ALL |
استرِد البيانات الخاصة بجميع الفئات. هذا هو الخيار التلقائي. |
MetagameCategory
البيانات المرتبطة بفئات ألعاب فردية
تمثيل JSON |
---|
{ "kind": string, "category": string, "experiencePoints": string } |
الحقول | |
---|---|
kind |
تُحدِّد هذه السمة نوع هذا المورد بشكلٍ فريد. تكون القيمة دائمًا السلسلة الثابتة |
category |
اسم الفئة. |
experiencePoints |
نقاط الخبرة المكتسَبة في هذه الفئة |