Method: metagame.listCategoriesByPlayer

أدرِج بيانات التشغيل المجمّعة لكلّ فئة للمشغّل المتوافق مع "playerId".

طلب HTTP

GET https://games.googleapis.com/games/v1/players/{playerId}/categories/{collection}

مَعلمات المسار

المعلمات
playerId

string

رقم تعريف اللاعب يجب استخدام قيمة me بدلاً من رقم تعريف اللاعب الذي تمت مصادقته.

collection

enum (Collection)

مجموعة الفئات التي سيتم عرض البيانات لها.

معامِلات طلب البحث

المعلمات
language

string

اللغة المفضلة المراد استخدامها للسلاسل التي يتم عرضها بهذه الطريقة.

maxResults

integer

الحد الأقصى لعدد موارد الفئة التي سيتم عرضها في الرد، ويتم استخدامه للترقيم. بالنسبة إلى أي استجابة، قد يكون العدد الفعلي لموارد الفئة التي يتم عرضها أقل من القيمة المحدّدة في سمة maxResults.

pageToken

string

الرمز المميّز الذي تم عرضه من خلال الطلب السابق

نص الطلب

يجب أن يكون نص الطلب فارغًا.

نص الاستجابة

ردّ فئات الألعاب الوصفية ضمن قائمة تابعة لجهات خارجية

إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:

تمثيل JSON
{
  "kind": string,
  "nextPageToken": string,
  "items": [
    {
      object (MetagameCategory)
    }
  ]
}
الحقول
kind

string

تُحدِّد نوع هذا المورد بشكلٍ فريد. وتكون القيمة دائمًا هي السلسلة الثابتة games#categoryListResponse.

nextPageToken

string

الرمز المميّز المقابل لصفحة النتائج التالية.

items[]

object (MetagameCategory)

قائمة الفئات التي تتضمن بيانات استخدام.

نطاقات الأذونات

يتطلب هذا الإعداد أحد نطاقات 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

string

تُحدِّد نوع هذا المورد بشكلٍ فريد. وتكون القيمة دائمًا هي السلسلة الثابتة games#category.

category

string

اسم الفئة.

experiencePoints

string (int64 format)

"مكافآت الخبرة" التي تم الحصول عليها في هذه الفئة.