Debian Codegraph @

docs/dyn/games_v1.players.html

raw
1 <html><body>
2 <style>
3
4 body, 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
15 body {
16 font-size: 13px;
17 padding: 1em;
18 }
19
20 h1 {
21 font-size: 26px;
22 margin-bottom: 1em;
23 }
24
25 h2 {
26 font-size: 24px;
27 margin-bottom: 1em;
28 }
29
30 h3 {
31 font-size: 20px;
32 margin-bottom: 1em;
33 margin-top: 1em;
34 }
35
36 pre, code {
37 line-height: 1.5;
38 font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace;
39 }
40
41 pre {
42 margin-top: 0.5em;
43 }
44
45 h1, h2, h3, p {
46 font-family: Arial, sans serif;
47 }
48
49 h1, 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 Games Services API</a> . <a href="games_v1.players.html">players</a></h1>
76 <h2>Instance Methods</h2>
77 <p class="toc_element">
78 <code><a href="#close">close()</a></code></p>
79 <p class="firstline">Close httplib2 connections.</p>
80 <p class="toc_element">
81 <code><a href="#get">get(playerId, language=None, playerIdConsistencyToken=None, x__xgafv=None)</a></code></p>
82 <p class="firstline">Retrieves the Player resource with the given ID. To retrieve the player for the currently authenticated user, set `playerId` to `me`.</p>
83 <p class="toc_element">
84 <code><a href="#getMultipleApplicationPlayerIds">getMultipleApplicationPlayerIds(applicationIds=None, x__xgafv=None)</a></code></p>
85 <p class="firstline">Get the application player ids for the currently authenticated player across all requested games by the same developer as the calling application. This will only return ids for players that actually have an id (scoped or otherwise) with that game.</p>
86 <p class="toc_element">
87 <code><a href="#getScopedPlayerIds">getScopedPlayerIds(x__xgafv=None)</a></code></p>
88 <p class="firstline">Retrieves scoped player identifiers for currently authenticated user.</p>
89 <p class="toc_element">
90 <code><a href="#list">list(collection, language=None, maxResults=None, pageToken=None, x__xgafv=None)</a></code></p>
91 <p class="firstline">Get the collection of players for the currently authenticated user.</p>
92 <p class="toc_element">
93 <code><a href="#list_next">list_next()</a></code></p>
94 <p class="firstline">Retrieves the next page of results.</p>
95 <h3>Method Details</h3>
96 <div class="method">
97 <code class="details" id="close">close()</code>
98 <pre>Close httplib2 connections.</pre>
99 </div>
100
101 <div class="method">
102 <code class="details" id="get">get(playerId, language=None, playerIdConsistencyToken=None, x__xgafv=None)</code>
103 <pre>Retrieves the Player resource with the given ID. To retrieve the player for the currently authenticated user, set `playerId` to `me`.
104
105 Args:
106 playerId: string, A player ID. A value of `me` may be used in place of the authenticated player&#x27;s ID. (required)
107 language: string, The preferred language to use for strings returned by this method.
108 playerIdConsistencyToken: string, Consistency token of the player id. The call returns a &#x27;not found&#x27; result when the token is present and invalid. Empty value is ignored. See also GlobalPlayerIdConsistencyTokenProto
109 x__xgafv: string, V1 error format.
110 Allowed values
111 1 - v1 error format
112 2 - v2 error format
113
114 Returns:
115 An object of the form:
116
117 { # A Player resource.
118 &quot;avatarImageUrl&quot;: &quot;A String&quot;, # The base URL for the image that represents the player.
119 &quot;bannerUrlLandscape&quot;: &quot;A String&quot;, # The url to the landscape mode player banner image.
120 &quot;bannerUrlPortrait&quot;: &quot;A String&quot;, # The url to the portrait mode player banner image.
121 &quot;displayName&quot;: &quot;A String&quot;, # The name to display for the player.
122 &quot;experienceInfo&quot;: { # 1P/3P metadata about the player&#x27;s experience. # An object to represent Play Game experience information for the player.
123 &quot;currentExperiencePoints&quot;: &quot;A String&quot;, # The current number of experience points for the player.
124 &quot;currentLevel&quot;: { # 1P/3P metadata about a user&#x27;s level. # The current level of the player.
125 &quot;kind&quot;: &quot;A String&quot;, # Uniquely identifies the type of this resource. Value is always the fixed string `games#playerLevel`.
126 &quot;level&quot;: 42, # The level for the user.
127 &quot;maxExperiencePoints&quot;: &quot;A String&quot;, # The maximum experience points for this level.
128 &quot;minExperiencePoints&quot;: &quot;A String&quot;, # The minimum experience points for this level.
129 },
130 &quot;kind&quot;: &quot;A String&quot;, # Uniquely identifies the type of this resource. Value is always the fixed string `games#playerExperienceInfo`.
131 &quot;lastLevelUpTimestampMillis&quot;: &quot;A String&quot;, # The timestamp when the player was leveled up, in millis since Unix epoch UTC.
132 &quot;nextLevel&quot;: { # 1P/3P metadata about a user&#x27;s level. # The next level of the player. If the current level is the maximum level, this should be same as the current level.
133 &quot;kind&quot;: &quot;A String&quot;, # Uniquely identifies the type of this resource. Value is always the fixed string `games#playerLevel`.
134 &quot;level&quot;: 42, # The level for the user.
135 &quot;maxExperiencePoints&quot;: &quot;A String&quot;, # The maximum experience points for this level.
136 &quot;minExperiencePoints&quot;: &quot;A String&quot;, # The minimum experience points for this level.
137 },
138 },
139 &quot;friendStatus&quot;: &quot;A String&quot;, # The friend status of the given player, relative to the requester. This is unset if the player is not sharing their friends list with the game.
140 &quot;gamePlayerId&quot;: &quot;A String&quot;, # Per-application unique player identifier.
141 &quot;kind&quot;: &quot;A String&quot;, # Uniquely identifies the type of this resource. Value is always the fixed string `games#player`
142 &quot;name&quot;: { # A representation of the individual components of the name.
143 &quot;familyName&quot;: &quot;A String&quot;, # The family name of this player. In some places, this is known as the last name.
144 &quot;givenName&quot;: &quot;A String&quot;, # The given name of this player. In some places, this is known as the first name.
145 },
146 &quot;originalPlayerId&quot;: &quot;A String&quot;, # The player ID that was used for this player the first time they signed into the game in question. This is only populated for calls to player.get for the requesting player, only if the player ID has subsequently changed, and only to clients that support remapping player IDs.
147 &quot;playerId&quot;: &quot;A String&quot;, # The ID of the player.
148 &quot;profileSettings&quot;: { # Profile settings # The player&#x27;s profile settings. Controls whether or not the player&#x27;s profile is visible to other players.
149 &quot;friendsListVisibility&quot;: &quot;A String&quot;,
150 &quot;kind&quot;: &quot;A String&quot;, # Uniquely identifies the type of this resource. Value is always the fixed string `games#profileSettings`.
151 &quot;profileVisible&quot;: True or False, # Whether the player&#x27;s profile is visible to the currently signed in player.
152 },
153 &quot;title&quot;: &quot;A String&quot;, # The player&#x27;s title rewarded for their game activities.
154 }</pre>
155 </div>
156
157 <div class="method">
158 <code class="details" id="getMultipleApplicationPlayerIds">getMultipleApplicationPlayerIds(applicationIds=None, x__xgafv=None)</code>
159 <pre>Get the application player ids for the currently authenticated player across all requested games by the same developer as the calling application. This will only return ids for players that actually have an id (scoped or otherwise) with that game.
160
161 Args:
162 applicationIds: string, Required. The application IDs from the Google Play developer console for the games to return scoped ids for. (repeated)
163 x__xgafv: string, V1 error format.
164 Allowed values
165 1 - v1 error format
166 2 - v2 error format
167
168 Returns:
169 An object of the form:
170
171 { # Response message for GetMultipleApplicationPlayerIds rpc.
172 &quot;playerIds&quot;: [ # Output only. The requested applications along with the scoped ids for tha player, if that player has an id for the application. If not, the application is not included in the response.
173 { # Primary scoped player identifier for an application.
174 &quot;applicationId&quot;: &quot;A String&quot;, # The application that this player identifier is for.
175 &quot;playerId&quot;: &quot;A String&quot;, # The player identifier for the application.
176 },
177 ],
178 }</pre>
179 </div>
180
181 <div class="method">
182 <code class="details" id="getScopedPlayerIds">getScopedPlayerIds(x__xgafv=None)</code>
183 <pre>Retrieves scoped player identifiers for currently authenticated user.
184
185 Args:
186 x__xgafv: string, V1 error format.
187 Allowed values
188 1 - v1 error format
189 2 - v2 error format
190
191 Returns:
192 An object of the form:
193
194 { # Scoped player identifiers.
195 &quot;developerPlayerKey&quot;: &quot;A String&quot;, # Identifier of the player across all games of the given developer. Every player has the same developer_player_key in all games of one developer. Developer player key changes for the game if the game is transferred to another developer. Note that game_player_id will stay unchanged.
196 &quot;gamePlayerId&quot;: &quot;A String&quot;, # Game-scoped player identifier. This is the same id that is returned in GetPlayer game_player_id field.
197 }</pre>
198 </div>
199
200 <div class="method">
201 <code class="details" id="list">list(collection, language=None, maxResults=None, pageToken=None, x__xgafv=None)</code>
202 <pre>Get the collection of players for the currently authenticated user.
203
204 Args:
205 collection: string, Collection of players being retrieved (required)
206 Allowed values
207 CONNECTED - Retrieve a list of players that are also playing this game in reverse chronological order.
208 VISIBLE - Retrieve a list of players in the user&#x27;s social graph that are visible to this game.
209 FRIENDS_ALL - Retrieve a list of players who are friends of the user in alphabetical order.
210 language: string, The preferred language to use for strings returned by this method.
211 maxResults: integer, The maximum number of player resources to return in the response, used for paging. For any response, the actual number of player resources returned may be less than the specified `maxResults`.
212 pageToken: string, The token returned by the previous request.
213 x__xgafv: string, V1 error format.
214 Allowed values
215 1 - v1 error format
216 2 - v2 error format
217
218 Returns:
219 An object of the form:
220
221 { # A third party player list response.
222 &quot;items&quot;: [ # The players.
223 { # A Player resource.
224 &quot;avatarImageUrl&quot;: &quot;A String&quot;, # The base URL for the image that represents the player.
225 &quot;bannerUrlLandscape&quot;: &quot;A String&quot;, # The url to the landscape mode player banner image.
226 &quot;bannerUrlPortrait&quot;: &quot;A String&quot;, # The url to the portrait mode player banner image.
227 &quot;displayName&quot;: &quot;A String&quot;, # The name to display for the player.
228 &quot;experienceInfo&quot;: { # 1P/3P metadata about the player&#x27;s experience. # An object to represent Play Game experience information for the player.
229 &quot;currentExperiencePoints&quot;: &quot;A String&quot;, # The current number of experience points for the player.
230 &quot;currentLevel&quot;: { # 1P/3P metadata about a user&#x27;s level. # The current level of the player.
231 &quot;kind&quot;: &quot;A String&quot;, # Uniquely identifies the type of this resource. Value is always the fixed string `games#playerLevel`.
232 &quot;level&quot;: 42, # The level for the user.
233 &quot;maxExperiencePoints&quot;: &quot;A String&quot;, # The maximum experience points for this level.
234 &quot;minExperiencePoints&quot;: &quot;A String&quot;, # The minimum experience points for this level.
235 },
236 &quot;kind&quot;: &quot;A String&quot;, # Uniquely identifies the type of this resource. Value is always the fixed string `games#playerExperienceInfo`.
237 &quot;lastLevelUpTimestampMillis&quot;: &quot;A String&quot;, # The timestamp when the player was leveled up, in millis since Unix epoch UTC.
238 &quot;nextLevel&quot;: { # 1P/3P metadata about a user&#x27;s level. # The next level of the player. If the current level is the maximum level, this should be same as the current level.
239 &quot;kind&quot;: &quot;A String&quot;, # Uniquely identifies the type of this resource. Value is always the fixed string `games#playerLevel`.
240 &quot;level&quot;: 42, # The level for the user.
241 &quot;maxExperiencePoints&quot;: &quot;A String&quot;, # The maximum experience points for this level.
242 &quot;minExperiencePoints&quot;: &quot;A String&quot;, # The minimum experience points for this level.
243 },
244 },
245 &quot;friendStatus&quot;: &quot;A String&quot;, # The friend status of the given player, relative to the requester. This is unset if the player is not sharing their friends list with the game.
246 &quot;gamePlayerId&quot;: &quot;A String&quot;, # Per-application unique player identifier.
247 &quot;kind&quot;: &quot;A String&quot;, # Uniquely identifies the type of this resource. Value is always the fixed string `games#player`
248 &quot;name&quot;: { # A representation of the individual components of the name.
249 &quot;familyName&quot;: &quot;A String&quot;, # The family name of this player. In some places, this is known as the last name.
250 &quot;givenName&quot;: &quot;A String&quot;, # The given name of this player. In some places, this is known as the first name.
251 },
252 &quot;originalPlayerId&quot;: &quot;A String&quot;, # The player ID that was used for this player the first time they signed into the game in question. This is only populated for calls to player.get for the requesting player, only if the player ID has subsequently changed, and only to clients that support remapping player IDs.
253 &quot;playerId&quot;: &quot;A String&quot;, # The ID of the player.
254 &quot;profileSettings&quot;: { # Profile settings # The player&#x27;s profile settings. Controls whether or not the player&#x27;s profile is visible to other players.
255 &quot;friendsListVisibility&quot;: &quot;A String&quot;,
256 &quot;kind&quot;: &quot;A String&quot;, # Uniquely identifies the type of this resource. Value is always the fixed string `games#profileSettings`.
257 &quot;profileVisible&quot;: True or False, # Whether the player&#x27;s profile is visible to the currently signed in player.
258 },
259 &quot;title&quot;: &quot;A String&quot;, # The player&#x27;s title rewarded for their game activities.
260 },
261 ],
262 &quot;kind&quot;: &quot;A String&quot;, # Uniquely identifies the type of this resource. Value is always the fixed string `games#playerListResponse`.
263 &quot;nextPageToken&quot;: &quot;A String&quot;, # Token corresponding to the next page of results.
264 }</pre>
265 </div>
266
267 <div class="method">
268 <code class="details" id="list_next">list_next()</code>
269 <pre>Retrieves the next page of results.
270
271 Args:
272 previous_request: The request for the previous page. (required)
273 previous_response: The response from the request for the previous page. (required)
274
275 Returns:
276 A request object that you can call &#x27;execute()&#x27; on to request the next
277 page. Returns None if there are no more items in the collection.
278 </pre>
279 </div>
280
281 </body></html>