- בקשת HTTP
- פרמטרים של נתיב
- פרמטרים של שאילתה
- גוף הבקשה
- גוף התשובה
- היקפי הרשאות
- איסוף
- MetagameCategory
- רוצים לנסות?
הצגת רשימה של נתוני הפעלה שנצברו לפי קטגוריה עבור השחקן המתאים ל-playerId
.
בקשת HTTP
GET https://games.googleapis.com/games/v1/players/{playerId}/categories/{collection}
פרמטרים של נתיב
פרמטרים | |
---|---|
playerId |
מזהה שחקן. ניתן להשתמש בערך |
collection |
אוסף הקטגוריות שעבורן יוחזרו הנתונים. |
פרמטרים של שאילתה
פרמטרים | |
---|---|
language |
השפה המועדפת לשימוש במחרוזות שמוחזרות בשיטה הזו. |
maxResults |
המספר המקסימלי של משאבי קטגוריה שיוחזרו בתגובה, משמשים לדפים. עבור כל תגובה, המספר בפועל של משאבי קטגוריה שיוחזר עשוי להיות נמוך מהערך שצוין ב- |
pageToken |
האסימון שהוחזר על ידי הבקשה הקודמת. |
גוף הבקשה
גוף הבקשה חייב להיות ריק.
גוף התגובה
תגובה של רשימת קטגוריות מטא-משחקים של צד שלישי.
אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכלול נתונים במבנה הבא:
ייצוג JSON |
---|
{
"kind": string,
"nextPageToken": string,
"items": [
{
object ( |
שדות | |
---|---|
kind |
מזהה באופן ייחודי את סוג המשאב הזה. הערך הוא תמיד המחרוזת הקבועה |
nextPageToken |
אסימון שתואם לדף הבא של התוצאות. |
items[] |
רשימת הקטגוריות עם נתוני שימוש. |
היקפי הרשאות
כדי להשתמש בתכונה הזו יש צורך באחד מההיקפים הבאים של 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 |
מזהה באופן ייחודי את סוג המשאב הזה. הערך הוא תמיד המחרוזת הקבועה |
category |
שם הקטגוריה. |
experiencePoints |
נקודות ניסיון מצטבר בקטגוריה הזו. |