blob: ab054bdb5f4e049f456f53d4dcda4c5a7ed2700b [file] [log] [blame]
Craig Citro065b5302014-08-14 00:47:23 -07001<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.
110 "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.
111 "durationMillis": "A String", # The duration associated with this snapshot, in millis.
112 "uniqueName": "A String", # The unique name provided when the snapshot was created.
113 "type": "A String", # The type of this snapshot.
114 # Possible values are:
115 # - "SAVE_GAME" - A snapshot representing a save game.
116 "id": "A String", # The ID of the snapshot.
117 }</pre>
118</div>
119
120<div class="method">
121 <code class="details" id="list">list(playerId, language=None, pageToken=None, maxResults=None)</code>
122 <pre>Retrieves a list of snapshots created by your application for the player corresponding to the player ID.
123
124Args:
125 playerId: string, A player ID. A value of me may be used in place of the authenticated player's ID. (required)
126 language: string, The preferred language to use for strings returned by this method.
127 pageToken: string, The token returned by the previous request.
128 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.
129
130Returns:
131 An object of the form:
132
133 { # This is a JSON template for a list of snapshot objects.
134 "nextPageToken": "A String", # Token corresponding to the next page of results. If there are no more results, the token is omitted.
135 "items": [ # The snapshots.
136 { # This is a JSON template for an snapshot object.
137 "kind": "games#snapshot", # Uniquely identifies the type of this resource. Value is always the fixed string games#snapshot.
138 "description": "A String", # The description of this snapshot.
139 "title": "A String", # The title of this snapshot.
140 "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.
141 "url": "A String", # The URL of the image. This URL may be invalidated at any time and should not be cached.
142 "width": 42, # The width of the image.
143 "kind": "games#snapshotImage", # Uniquely identifies the type of this resource. Value is always the fixed string games#snapshotImage.
144 "mime_type": "A String", # The MIME type of the image.
145 "height": 42, # The height of the image.
146 },
147 "lastModifiedMillis": "A String", # The timestamp (in millis since Unix epoch) of the last modification to this snapshot.
148 "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.
149 "durationMillis": "A String", # The duration associated with this snapshot, in millis.
150 "uniqueName": "A String", # The unique name provided when the snapshot was created.
151 "type": "A String", # The type of this snapshot.
152 # Possible values are:
153 # - "SAVE_GAME" - A snapshot representing a save game.
154 "id": "A String", # The ID of the snapshot.
155 },
156 ],
157 "kind": "games#snapshotListResponse", # Uniquely identifies the type of this resource. Value is always the fixed string games#snapshotListResponse.
158 }</pre>
159</div>
160
161<div class="method">
162 <code class="details" id="list_next">list_next(previous_request, previous_response)</code>
163 <pre>Retrieves the next page of results.
164
165Args:
166 previous_request: The request for the previous page. (required)
167 previous_response: The response from the request for the previous page. (required)
168
169Returns:
170 A request object that you can call 'execute()' on to request the next
171 page. Returns None if there are no more items in the collection.
172 </pre>
173</div>
174
175</body></html>