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.

אוסף

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

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

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