Method: metagame.listCategoriesByPlayer

הצגת רשימה של נתוני הפעלה שנצברו לפי קטגוריה עבור השחקן המתאים ל-playerId.

בקשת HTTP

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

פרמטרים של נתיב

פרמטרים
playerId

string

מזהה שחקן. ניתן להשתמש בערך me במקום מזהה הנגן המאומת.
collection

enum (Collection)

אוסף הקטגוריות שעבורן יוחזרו הנתונים.

פרמטרים של שאילתה

פרמטרים
language

string

השפה המועדפת לשימוש במחרוזות שמוחזרות בשיטה הזו.
maxResults

integer

המספר המקסימלי של משאבי קטגוריה שיוחזרו בתגובה, משמשים לדפים. עבור כל תגובה, המספר בפועל של משאבי קטגוריה שיוחזר עשוי להיות נמוך מהערך שצוין ב-maxResults.
pageToken

string

האסימון שהוחזר על ידי הבקשה הקודמת.

גוף הבקשה

גוף הבקשה חייב להיות ריק.

גוף התגובה

תגובה של רשימת קטגוריות מטא-משחקים של צד שלישי.

אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכלול נתונים במבנה הבא:

ייצוג JSON 
{
  "kind": string,
  "nextPageToken": string,
  "items": [
    {
      object (MetagameCategory)
    }
  ]
}
שדות
kind

string

מזהה באופן ייחודי את סוג המשאב הזה. הערך הוא תמיד המחרוזת הקבועה games#categoryListResponse.
nextPageToken

string

אסימון שתואם לדף הבא של התוצאות.
items[]

object (MetagameCategory)

רשימת הקטגוריות עם נתוני שימוש.

היקפי הרשאות

כדי להשתמש בתכונה הזו יש צורך באחד מההיקפים הבאים של OAuth:

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

למידע נוסף, עיין בסקירה הכללית על OAuth 2.0.

איסוף

הגדרת קטגוריות שעבורן יוחזרו נתונים.

טיפוסים בני מנייה (enums)
ALL אחזור נתונים לכל הקטגוריות. (זוהי ברירת המחדל)

MetagameCategory

נתונים שקשורים לקטגוריות ספציפיות של משחקים.

ייצוג JSON 
{
  "kind": string,
  "category": string,
  "experiencePoints": string
}
שדות
kind

string

מזהה באופן ייחודי את סוג המשאב הזה. הערך הוא תמיד המחרוזת הקבועה games#category.
category

string

שם הקטגוריה.
experiencePoints

string (int64 format)

נקודות ניסיון מצטבר בקטגוריה הזו.