- בקשת 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.
אוסף
הגדרת הקטגוריות שעבורן הנתונים יוחזרו.
טיפוסים בני מנייה (enum) | |
---|---|
ALL |
אחזור נתונים לכל הקטגוריות. (זוהי ברירת המחדל) |
MetagameCategory
נתונים שקשורים לקטגוריות ספציפיות של משחקים.
ייצוג JSON |
---|
{ "kind": string, "category": string, "experiencePoints": string } |
שדות | |
---|---|
kind |
מזהה באופן ייחודי את סוג המשאב הזה. הערך הוא תמיד המחרוזת הקבועה |
category |
שם הקטגוריה. |
experiencePoints |
נקודות ניסיון שצברת בקטגוריה הזו. |