Method: snapshots.list

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

בקשת HTTP

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

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

פרמטרים
playerId

string

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

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

פרמטרים
language

string

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

maxResults

integer

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

pageToken

string

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

גוף הבקשה

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

גוף התגובה

תגובה שמציגה תמונת מצב של רשימה של צד שלישי.

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

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

string

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

nextPageToken

string

אסימון שתואם לדף הבא של התוצאות. אם אין תוצאות נוספות, האסימון יושמט.

items[]

object (Snapshot)

תמונות המצב.

היקפי הרשאות

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

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

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