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.
דוגמאות התוכן והקוד שבדף הזה כפופות לרישיונות המפורטים בקטע רישיון לתוכן. Java ו-OpenJDK הם סימנים מסחריים או סימנים מסחריים רשומים של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2025-07-27 (שעון UTC).
[null,null,["עדכון אחרון: 2025-07-27 (שעון UTC)."],[],[],null,["# Method: snapshots.list\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n - [JSON representation](#body.ListSnapshotsResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nRetrieves a list of snapshots created by your application for the player corresponding to the player ID.\n\n### HTTP request\n\n`GET https://games.googleapis.com/games/v1/players/{playerId}/snapshots`\n\n### Path parameters\n\n| Parameters ||\n|------------|----------------------------------------------------------------------------------------------|\n| `playerId` | `string` A player ID. A value of `me` may be used in place of the authenticated player's ID. |\n\n### Query parameters\n\n| Parameters ||\n|--------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `language` | `string` The preferred language to use for strings returned by this method. |\n| `maxResults` | `integer` The maximum number of snapshot resources to return in the response, used for paging. For any response, the actual number of snapshot resources returned may be less than the specified `maxResults`. |\n| `pageToken` | `string` The token returned by the previous request. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nA third party list snapshots response.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|-----------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"kind\": string, \"nextPageToken\": string, \"items\": [ { object (/games/services/web/api/rest/v1/snapshots#Snapshot) } ] } ``` |\n\n| Fields ||\n|-----------------|------------------------------------------------------------------------------------------------------------------------|\n| `kind` | `string` Uniquely identifies the type of this resource. Value is always the fixed string `games#snapshotListResponse`. |\n| `nextPageToken` | `string` Token corresponding to the next page of results. If there are no more results, the token is omitted. |\n| `items[]` | `object (`[Snapshot](/games/services/web/api/rest/v1/snapshots#Snapshot)`)` The snapshots. |\n\n### Authorization scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://www.googleapis.com/auth/drive.appdata`\n- `\n https://www.googleapis.com/auth/games`\n- `\n https://www.googleapis.com/auth/games_lite`\n\nFor more information, see the [OAuth 2.0 Overview](https://developers.google.com/identity/protocols/OAuth2)."]]
