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.

אוסף

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

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

MetagameCategory

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

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

string

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

string

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

string (int64 format)

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