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 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","easyToUnderstand","thumb-up"],["ساعَدني المحتوى في حلّ مشكلتي.","solvedMyProblem","thumb-up"],["غير ذلك","otherUp","thumb-up"]],[["لا يحتوي على المعلومات التي أحتاج إليها.","missingTheInformationINeed","thumb-down"],["الخطوات معقدة للغاية / كثيرة جدًا.","tooComplicatedTooManySteps","thumb-down"],["المحتوى قديم.","outOfDate","thumb-down"],["ثمة مشكلة في الترجمة.","translationIssue","thumb-down"],["مشكلة في العيّنات / التعليمات البرمجية","samplesCodeIssue","thumb-down"],["غير ذلك","otherDown","thumb-down"]],["تاريخ التعديل الأخير: 2025-07-27 (حسب التوقيت العالمي المتفَّق عليه)"],[],[],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)."]]