Gitiles
Code Review Sign In
gerrit-public.fairphone.software / platform / external / python / google-api-python-client / 36e41bc9e5f0c6e6d5920ae4a5c9802ca63554e2 / . / docs / dyn / games_v1.applications.html
blob: f0bb357b7dd4b05718e4e42f2ac549f369929377 [file] [log] [blame]
John Asmuth614db982014-04-24 15:46:26 -0400[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.applications.html">applications</a></h1>
76<h2>Instance Methods</h2>
77<p class="toc_element">
78 <code><a href="#get">get(applicationId, language=None, platformType=None)</a></code></p>
79<p class="firstline">Retrieves the metadata of the application with the given ID. If the requested application is not available for the specified platformType, the returned response will not include any instance data.</p>
80<p class="toc_element">
81 <code><a href="#played">played()</a></code></p>
82<p class="firstline">Indicate that the the currently authenticated user is playing your application.</p>
Jon Wayne Parrott36e41bc2016-02-19 16:02:29 -0800[diff] [blame^]83<p class="toc_element">
84 <code><a href="#verify">verify(applicationId)</a></code></p>
85<p class="firstline">Verifies the auth token provided with this request is for the application with the specified ID, and returns the ID of the player it was granted for.</p>
John Asmuth614db982014-04-24 15:46:26 -0400[diff] [blame]86<h3>Method Details</h3>
87<div class="method">
88 <code class="details" id="get">get(applicationId, language=None, platformType=None)</code>
89 <pre>Retrieves the metadata of the application with the given ID. If the requested application is not available for the specified platformType, the returned response will not include any instance data.
90
91Args:
Craig Citroe633be12015-03-02 13:40:36 -0800[diff] [blame]92 applicationId: string, The application ID from the Google Play developer console. (required)
John Asmuth614db982014-04-24 15:46:26 -0400[diff] [blame]93 language: string, The preferred language to use for strings returned by this method.
94 platformType: string, Restrict application details returned to the specific platform.
95 Allowed values
96 ANDROID - Retrieve applications that can be played on Android.
97 IOS - Retrieve applications that can be played on iOS.
98 WEB_APP - Retrieve applications that can be played on desktop web.
99
100Returns:
101 An object of the form:
102
103 { # This is a JSON template for the Application resource.
104 "category": { # This is a JSON template for an application category object. # The category of the application.
105 "kind": "games#applicationCategory", # Uniquely identifies the type of this resource. Value is always the fixed string games#applicationCategory.
106 "primary": "A String", # The primary category.
107 "secondary": "A String", # The secondary category.
108 },
109 "kind": "games#application", # Uniquely identifies the type of this resource. Value is always the fixed string games#application.
110 "description": "A String", # The description of the application.
111 "author": "A String", # The author of the application.
112 "lastUpdatedTimestamp": "A String", # The last updated timestamp of the application.
Craig Citro0e5b9bf2014-10-15 10:26:14 -0700[diff] [blame]113 "themeColor": "A String", # A hint to the client UI for what color to use as an app-themed color. The color is given as an RGB triplet (e.g. "E0E0E0").
John Asmuth614db982014-04-24 15:46:26 -0400[diff] [blame]114 "name": "A String", # The name of the application.
115 "instances": [ # The instances of the application.
116 { # This is a JSON template for the Instance resource.
117 "kind": "games#instance", # Uniquely identifies the type of this resource. Value is always the fixed string games#instance.
118 "acquisitionUri": "A String", # URI which shows where a user can acquire this instance.
119 "name": "A String", # Localized display name.
120 "turnBasedPlay": True or False, # Flag to show if this game instance supports turn based play.
121 "webInstance": { # This is a JSON template for the Web details resource. # Platform dependent details for Web.
122 "kind": "games#instanceWebDetails", # Uniquely identifies the type of this resource. Value is always the fixed string games#instanceWebDetails.
123 "launchUrl": "A String", # Launch URL for the game.
124 "preferred": True or False, # Indicates that this instance is the default for new installations.
125 },
126 "androidInstance": { # This is a JSON template for the Android instance details resource. # Platform dependent details for Android.
127 "kind": "games#instanceAndroidDetails", # Uniquely identifies the type of this resource. Value is always the fixed string games#instanceAndroidDetails.
128 "enablePiracyCheck": True or False, # Flag indicating whether the anti-piracy check is enabled.
129 "packageName": "A String", # Android package name which maps to Google Play URL.
130 "preferred": True or False, # Indicates that this instance is the default for new installations.
131 },
132 "iosInstance": { # This is a JSON template for the iOS details resource. # Platform dependent details for iOS.
133 "kind": "games#instanceIosDetails", # Uniquely identifies the type of this resource. Value is always the fixed string games#instanceIosDetails.
134 "supportIphone": True or False, # Flag to indicate if this instance supports iPhone.
135 "preferredForIpad": True or False, # Indicates that this instance is the default for new installations on iPad devices.
136 "itunesAppId": "A String", # iTunes App ID.
137 "bundleIdentifier": "A String", # Bundle identifier.
138 "supportIpad": True or False, # Flag to indicate if this instance supports iPad.
139 "preferredForIphone": True or False, # Indicates that this instance is the default for new installations on iPhone devices.
140 },
141 "platformType": "A String", # The platform type.
142 # Possible values are:
143 # - "ANDROID" - Instance is for Android.
144 # - "IOS" - Instance is for iOS
145 # - "WEB_APP" - Instance is for Web App.
146 "realtimePlay": True or False, # Flag to show if this game instance supports realtime play.
147 },
148 ],
149 "achievement_count": 42, # The number of achievements visible to the currently authenticated player.
150 "leaderboard_count": 42, # The number of leaderboards visible to the currently authenticated player.
John Asmuth614db982014-04-24 15:46:26 -0400[diff] [blame]151 "assets": [ # The assets of the application.
152 { # This is a JSON template for an image asset object.
153 "url": "A String", # The URL of the asset.
154 "width": 42, # The width of the asset.
155 "kind": "games#imageAsset", # Uniquely identifies the type of this resource. Value is always the fixed string games#imageAsset.
156 "name": "A String", # The name of the asset.
157 "height": 42, # The height of the asset.
158 },
159 ],
Craig Citro065b5302014-08-14 00:47:23 -0700[diff] [blame]160 "id": "A String", # The ID of the application.
161 "enabledFeatures": [ # A list of features that have been enabled for the application.
162 # Possible values are:
163 # - "SNAPSHOTS" - Snapshots has been enabled
164 "A String",
165 ],
John Asmuth614db982014-04-24 15:46:26 -0400[diff] [blame]166 }</pre>
167</div>
168
169<div class="method">
170 <code class="details" id="played">played()</code>
171 <pre>Indicate that the the currently authenticated user is playing your application.
172
173Args:
174</pre>
175</div>
176
Jon Wayne Parrott36e41bc2016-02-19 16:02:29 -0800[diff] [blame^]177<div class="method">
178 <code class="details" id="verify">verify(applicationId)</code>
179 <pre>Verifies the auth token provided with this request is for the application with the specified ID, and returns the ID of the player it was granted for.
180
181Args:
182 applicationId: string, The application ID from the Google Play developer console. (required)
183
184Returns:
185 An object of the form:
186
187 { # This is a JSON template for a third party application verification response resource.
188 "player_id": "A String", # The ID of the player that was issued the auth token used in this request.
189 "kind": "games#applicationVerifyResponse", # Uniquely identifies the type of this resource. Value is always the fixed string games#applicationVerifyResponse.
190 }</pre>
191</div>
192
John Asmuth614db982014-04-24 15:46:26 -0400[diff] [blame]193</body></html>