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 يمكنك استرداد قائمة باللاعبين الذين هم أصدقاء للمستخدم بالترتيب الأبجدي.