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.