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.

איסוף

טיפוסים בני מנייה (enums)
CONNECTED

מאחזרים רשימה של שחקנים שמשחקים במשחק הזה גם בסדר כרונולוגי הפוך.
VISIBLE

אחזור רשימה של שחקנים בגרף החברתי של המשתמש שגלויים למשחק זה.
FRIENDS_ALL מאחזרים רשימה של שחקנים שהם חברים של המשתמש בסדר אלפביתי.