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)

مكافآت الخبرة المكتسبة في هذه الفئة