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 אחזור רשימה של שחקנים שהם חברים של המשתמש בסדר אלפביתי.