Method: players.list

يمكنك الحصول على مجموعة اللاعبين للمستخدم الذي تمت مصادقته حاليًا.

طلب HTTP

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

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

المَعلمات
collection

enum (Collection)

تم استرداد مجموعة من اللاعبين

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

المَعلمات
language

string

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

integer

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

string

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

نص الطلب

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

نص الاستجابة

ردّ على قائمة مشغّل الفيديو من جهة خارجية

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

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

string

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

string

رمز مميز يقابل الصفحة التالية من النتائج
items[]

object (Player)

اللاعبون.

نطاقات التفويض

يتطلب استخدام أحد نطاقات OAuth التالية:

  • https://www.googleapis.com/auth/games
  • https://www.googleapis.com/auth/games_lite

لمزيد من المعلومات، راجِع نظرة عامة على بروتوكول OAuth 2.0.

المجموعة

عمليات التعداد
CONNECTED

استرجع قائمة باللاعبين الذين يلعبون هذه اللعبة أيضًا بترتيب زمني عكسي.
VISIBLE

يمكنك استرداد قائمة باللاعبين المرئيين لهذه اللعبة في الرسم البياني الاجتماعي للمستخدم.
FRIENDS_ALL استرجع قائمة باللاعبين أصدقاء المستخدم بترتيب أبجدي.