Gitiles
Code Review Sign In
gerrit-public.fairphone.software / platform / external / python / google-api-python-client / df43dbf720f1534c68f740acc68b40dc10189472 / . / docs / dyn / games_v1.snapshots.html
blob: 0d4a3468497615281fb664e2394ce02afa895a91 [file] [log] [blame]
Craig Citro065b5302014-08-14 00:47:23 -0700[diff] [blame]1<html><body>
2<style>
3
4body, h1, h2, h3, div, span, p, pre, a {
5 margin: 0;
6 padding: 0;
7 border: 0;
8 font-weight: inherit;
9 font-style: inherit;
10 font-size: 100%;
11 font-family: inherit;
12 vertical-align: baseline;
13}
14
15body {
16 font-size: 13px;
17 padding: 1em;
18}
19
20h1 {
21 font-size: 26px;
22 margin-bottom: 1em;
23}
24
25h2 {
26 font-size: 24px;
27 margin-bottom: 1em;
28}
29
30h3 {
31 font-size: 20px;
32 margin-bottom: 1em;
33 margin-top: 1em;
34}
35
36pre, code {
37 line-height: 1.5;
38 font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace;
39}
40
41pre {
42 margin-top: 0.5em;
43}
44
45h1, h2, h3, p {
46 font-family: Arial, sans serif;
47}
48
49h1, h2, h3 {
50 border-bottom: solid #CCC 1px;
51}
52
53.toc_element {
54 margin-top: 0.5em;
55}
56
57.firstline {
58 margin-left: 2 em;
59}
60
61.method {
62 margin-top: 1em;
63 border: solid 1px #CCC;
64 padding: 1em;
65 background: #EEE;
66}
67
68.details {
69 font-weight: bold;
70 font-size: 14px;
71}
72
73</style>
74
75<h1><a href="games_v1.html">Google Play Game Services API</a> . <a href="games_v1.snapshots.html">snapshots</a></h1>
76<h2>Instance Methods</h2>
77<p class="toc_element">
78 <code><a href="#get">get(snapshotId, language=None)</a></code></p>
79<p class="firstline">Retrieves the metadata for a given snapshot ID.</p>
80<p class="toc_element">
81 <code><a href="#list">list(playerId, language=None, pageToken=None, maxResults=None)</a></code></p>
82<p class="firstline">Retrieves a list of snapshots created by your application for the player corresponding to the player ID.</p>
83<p class="toc_element">
84 <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
85<p class="firstline">Retrieves the next page of results.</p>
86<h3>Method Details</h3>
87<div class="method">
88 <code class="details" id="get">get(snapshotId, language=None)</code>
89 <pre>Retrieves the metadata for a given snapshot ID.
90
91Args:
92 snapshotId: string, The ID of the snapshot. (required)
93 language: string, The preferred language to use for strings returned by this method.
94
95Returns:
96 An object of the form:
97
98 { # This is a JSON template for an snapshot object.
99 "kind": "games#snapshot", # Uniquely identifies the type of this resource. Value is always the fixed string games#snapshot.
100 "description": "A String", # The description of this snapshot.
101 "title": "A String", # The title of this snapshot.
102 "coverImage": { # This is a JSON template for an image of a snapshot. # The cover image of this snapshot. May be absent if there is no image.
103 "url": "A String", # The URL of the image. This URL may be invalidated at any time and should not be cached.
104 "width": 42, # The width of the image.
105 "kind": "games#snapshotImage", # Uniquely identifies the type of this resource. Value is always the fixed string games#snapshotImage.
106 "mime_type": "A String", # The MIME type of the image.
107 "height": 42, # The height of the image.
108 },
109 "lastModifiedMillis": "A String", # The timestamp (in millis since Unix epoch) of the last modification to this snapshot.
Craig Citroe633be12015-03-02 13:40:36 -0800[diff] [blame]110 "progressValue": "A String", # The progress value (64-bit integer set by developer) associated with this snapshot.
Craig Citro065b5302014-08-14 00:47:23 -0700[diff] [blame]111 "driveId": "A String", # The ID of the file underlying this snapshot in the Drive API. Only present if the snapshot is a view on a Drive file and the file is owned by the caller.
112 "durationMillis": "A String", # The duration associated with this snapshot, in millis.
113 "uniqueName": "A String", # The unique name provided when the snapshot was created.
114 "type": "A String", # The type of this snapshot.
115 # Possible values are:
116 # - "SAVE_GAME" - A snapshot representing a save game.
117 "id": "A String", # The ID of the snapshot.
118 }</pre>
119</div>
120
121<div class="method">
122 <code class="details" id="list">list(playerId, language=None, pageToken=None, maxResults=None)</code>
123 <pre>Retrieves a list of snapshots created by your application for the player corresponding to the player ID.
124
125Args:
126 playerId: string, A player ID. A value of me may be used in place of the authenticated player's ID. (required)
127 language: string, The preferred language to use for strings returned by this method.
128 pageToken: string, The token returned by the previous request.
129 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.
130
131Returns:
132 An object of the form:
133
134 { # This is a JSON template for a list of snapshot objects.
135 "nextPageToken": "A String", # Token corresponding to the next page of results. If there are no more results, the token is omitted.
136 "items": [ # The snapshots.
137 { # This is a JSON template for an snapshot object.
138 "kind": "games#snapshot", # Uniquely identifies the type of this resource. Value is always the fixed string games#snapshot.
139 "description": "A String", # The description of this snapshot.
140 "title": "A String", # The title of this snapshot.
141 "coverImage": { # This is a JSON template for an image of a snapshot. # The cover image of this snapshot. May be absent if there is no image.
142 "url": "A String", # The URL of the image. This URL may be invalidated at any time and should not be cached.
143 "width": 42, # The width of the image.
144 "kind": "games#snapshotImage", # Uniquely identifies the type of this resource. Value is always the fixed string games#snapshotImage.
145 "mime_type": "A String", # The MIME type of the image.
146 "height": 42, # The height of the image.
147 },
148 "lastModifiedMillis": "A String", # The timestamp (in millis since Unix epoch) of the last modification to this snapshot.
Craig Citroe633be12015-03-02 13:40:36 -0800[diff] [blame]149 "progressValue": "A String", # The progress value (64-bit integer set by developer) associated with this snapshot.
Craig Citro065b5302014-08-14 00:47:23 -0700[diff] [blame]150 "driveId": "A String", # The ID of the file underlying this snapshot in the Drive API. Only present if the snapshot is a view on a Drive file and the file is owned by the caller.
151 "durationMillis": "A String", # The duration associated with this snapshot, in millis.
152 "uniqueName": "A String", # The unique name provided when the snapshot was created.
153 "type": "A String", # The type of this snapshot.
154 # Possible values are:
155 # - "SAVE_GAME" - A snapshot representing a save game.
156 "id": "A String", # The ID of the snapshot.
157 },
158 ],
159 "kind": "games#snapshotListResponse", # Uniquely identifies the type of this resource. Value is always the fixed string games#snapshotListResponse.
160 }</pre>
161</div>
162
163<div class="method">
164 <code class="details" id="list_next">list_next(previous_request, previous_response)</code>
165 <pre>Retrieves the next page of results.
166
167Args:
168 previous_request: The request for the previous page. (required)
169 previous_response: The response from the request for the previous page. (required)
170
171Returns:
172 A request object that you can call 'execute()' on to request the next
173 page. Returns None if there are no more items in the collection.
174 </pre>
175</div>
176
177</body></html>