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</a> . <a href="games_v1.scores.html">scores</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, leaderboardId, timeSpan, includeRankType=None, language=None, maxResults=None, pageToken=None, x__xgafv=None)</a></code></p> 82<p class="firstline">Get high scores, and optionally ranks, in leaderboards for the currently authenticated player. For a specific time span, `leaderboardId` can be set to `ALL` to retrieve data for all leaderboards in a given time span. `NOTE: You cannot ask for 'ALL' leaderboards and 'ALL' timeSpans in the same request; only one parameter may be set to 'ALL'.</p> 83<p class="toc_element"> 84 <code><a href="#get_next">get_next(previous_request, previous_response)</a></code></p> 85<p class="firstline">Retrieves the next page of results.</p> 86<p class="toc_element"> 87 <code><a href="#list">list(leaderboardId, collection, timeSpan, language=None, maxResults=None, pageToken=None, x__xgafv=None)</a></code></p> 88<p class="firstline">Lists the scores in a leaderboard, starting from the top.</p> 89<p class="toc_element"> 90 <code><a href="#listWindow">listWindow(leaderboardId, collection, timeSpan, language=None, maxResults=None, pageToken=None, resultsAbove=None, returnTopIfAbsent=None, x__xgafv=None)</a></code></p> 91<p class="firstline">Lists the scores in a leaderboard around (and including) a player's score.</p> 92<p class="toc_element"> 93 <code><a href="#listWindow_next">listWindow_next(previous_request, previous_response)</a></code></p> 94<p class="firstline">Retrieves the next page of results.</p> 95<p class="toc_element"> 96 <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p> 97<p class="firstline">Retrieves the next page of results.</p> 98<p class="toc_element"> 99 <code><a href="#submit">submit(leaderboardId, score, language=None, scoreTag=None, x__xgafv=None)</a></code></p> 100<p class="firstline">Submits a score to the specified leaderboard.</p> 101<p class="toc_element"> 102 <code><a href="#submitMultiple">submitMultiple(body=None, language=None, x__xgafv=None)</a></code></p> 103<p class="firstline">Submits multiple scores to leaderboards.</p> 104<h3>Method Details</h3> 105<div class="method"> 106 <code class="details" id="close">close()</code> 107 <pre>Close httplib2 connections.</pre> 108</div> 109 110<div class="method"> 111 <code class="details" id="get">get(playerId, leaderboardId, timeSpan, includeRankType=None, language=None, maxResults=None, pageToken=None, x__xgafv=None)</code> 112 <pre>Get high scores, and optionally ranks, in leaderboards for the currently authenticated player. For a specific time span, `leaderboardId` can be set to `ALL` to retrieve data for all leaderboards in a given time span. `NOTE: You cannot ask for 'ALL' leaderboards and 'ALL' timeSpans in the same request; only one parameter may be set to 'ALL'. 113 114Args: 115 playerId: string, A player ID. A value of `me` may be used in place of the authenticated player's ID. (required) 116 leaderboardId: string, The ID of the leaderboard. Can be set to 'ALL' to retrieve data for all leaderboards for this application. (required) 117 timeSpan: string, The time span for the scores and ranks you're requesting. (required) 118 Allowed values 119 SCORE_TIME_SPAN_UNSPECIFIED - Default value. This value is unused. 120 ALL - Get the high scores for all time spans. If this is used, maxResults values will be ignored. 121 ALL_TIME - Get the all time high score. 122 WEEKLY - List the top scores for the current day. 123 DAILY - List the top scores for the current week. 124 includeRankType: string, The types of ranks to return. If the parameter is omitted, no ranks will be returned. 125 Allowed values 126 INCLUDE_RANK_TYPE_UNSPECIFIED - Default value. Should be unused. 127 ALL - Retrieve all supported ranks. In HTTP, this parameter value can also be specified as `ALL`. 128 PUBLIC - Retrieve public ranks, if the player is sharing their gameplay activity publicly. 129 SOCIAL - (Obsolete) Retrieve the social rank. 130 FRIENDS - Retrieve the rank on the friends collection. 131 language: string, The preferred language to use for strings returned by this method. 132 maxResults: integer, The maximum number of leaderboard scores to return in the response. For any response, the actual number of leaderboard scores returned may be less than the specified `maxResults`. 133 pageToken: string, The token returned by the previous request. 134 x__xgafv: string, V1 error format. 135 Allowed values 136 1 - v1 error format 137 2 - v2 error format 138 139Returns: 140 An object of the form: 141 142 { # A list of player leaderboard scores. 143 "items": [ # The leaderboard scores. 144 { # A player leaderboard score object. 145 "friendsRank": { # A score rank in a leaderboard. # The rank of the score in the friends collection for this leaderboard. 146 "formattedNumScores": "A String", # The number of scores in the leaderboard as a string. 147 "formattedRank": "A String", # The rank in the leaderboard as a string. 148 "kind": "A String", # Uniquely identifies the type of this resource. Value is always the fixed string `games#leaderboardScoreRank`. 149 "numScores": "A String", # The number of scores in the leaderboard. 150 "rank": "A String", # The rank in the leaderboard. 151 }, 152 "kind": "A String", # Uniquely identifies the type of this resource. Value is always the fixed string `games#playerLeaderboardScore`. 153 "leaderboard_id": "A String", # The ID of the leaderboard this score is in. 154 "publicRank": { # A score rank in a leaderboard. # The public rank of the score in this leaderboard. This object will not be present if the user is not sharing their scores publicly. 155 "formattedNumScores": "A String", # The number of scores in the leaderboard as a string. 156 "formattedRank": "A String", # The rank in the leaderboard as a string. 157 "kind": "A String", # Uniquely identifies the type of this resource. Value is always the fixed string `games#leaderboardScoreRank`. 158 "numScores": "A String", # The number of scores in the leaderboard. 159 "rank": "A String", # The rank in the leaderboard. 160 }, 161 "scoreString": "A String", # The formatted value of this score. 162 "scoreTag": "A String", # Additional information about the score. Values must contain no more than 64 URI-safe characters as defined by section 2.3 of RFC 3986. 163 "scoreValue": "A String", # The numerical value of this score. 164 "socialRank": { # A score rank in a leaderboard. # The social rank of the score in this leaderboard. 165 "formattedNumScores": "A String", # The number of scores in the leaderboard as a string. 166 "formattedRank": "A String", # The rank in the leaderboard as a string. 167 "kind": "A String", # Uniquely identifies the type of this resource. Value is always the fixed string `games#leaderboardScoreRank`. 168 "numScores": "A String", # The number of scores in the leaderboard. 169 "rank": "A String", # The rank in the leaderboard. 170 }, 171 "timeSpan": "A String", # The time span of this score. 172 "writeTimestamp": "A String", # The timestamp at which this score was recorded, in milliseconds since the epoch in UTC. 173 }, 174 ], 175 "kind": "A String", # Uniquely identifies the type of this resource. Value is always the fixed string `games#playerLeaderboardScoreListResponse`. 176 "nextPageToken": "A String", # The pagination token for the next page of results. 177 "player": { # A Player resource. # The Player resources for the owner of this score. 178 "avatarImageUrl": "A String", # The base URL for the image that represents the player. 179 "bannerUrlLandscape": "A String", # The url to the landscape mode player banner image. 180 "bannerUrlPortrait": "A String", # The url to the portrait mode player banner image. 181 "displayName": "A String", # The name to display for the player. 182 "experienceInfo": { # 1P/3P metadata about the player's experience. # An object to represent Play Game experience information for the player. 183 "currentExperiencePoints": "A String", # The current number of experience points for the player. 184 "currentLevel": { # 1P/3P metadata about a user's level. # The current level of the player. 185 "kind": "A String", # Uniquely identifies the type of this resource. Value is always the fixed string `games#playerLevel`. 186 "level": 42, # The level for the user. 187 "maxExperiencePoints": "A String", # The maximum experience points for this level. 188 "minExperiencePoints": "A String", # The minimum experience points for this level. 189 }, 190 "kind": "A String", # Uniquely identifies the type of this resource. Value is always the fixed string `games#playerExperienceInfo`. 191 "lastLevelUpTimestampMillis": "A String", # The timestamp when the player was leveled up, in millis since Unix epoch UTC. 192 "nextLevel": { # 1P/3P metadata about a user's level. # The next level of the player. If the current level is the maximum level, this should be same as the current level. 193 "kind": "A String", # Uniquely identifies the type of this resource. Value is always the fixed string `games#playerLevel`. 194 "level": 42, # The level for the user. 195 "maxExperiencePoints": "A String", # The maximum experience points for this level. 196 "minExperiencePoints": "A String", # The minimum experience points for this level. 197 }, 198 }, 199 "friendStatus": "A String", # 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. 200 "kind": "A String", # Uniquely identifies the type of this resource. Value is always the fixed string `games#player` 201 "name": { # A representation of the individual components of the name. 202 "familyName": "A String", # The family name of this player. In some places, this is known as the last name. 203 "givenName": "A String", # The given name of this player. In some places, this is known as the first name. 204 }, 205 "originalPlayerId": "A String", # 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. 206 "playerId": "A String", # The ID of the player. 207 "profileSettings": { # Profile settings # The player's profile settings. Controls whether or not the player's profile is visible to other players. 208 "friendsListVisibility": "A String", 209 "kind": "A String", # Uniquely identifies the type of this resource. Value is always the fixed string `games#profileSettings`. 210 "profileVisible": True or False, # Whether the player's profile is visible to the currently signed in player. 211 }, 212 "title": "A String", # The player's title rewarded for their game activities. 213 }, 214}</pre> 215</div> 216 217<div class="method"> 218 <code class="details" id="get_next">get_next(previous_request, previous_response)</code> 219 <pre>Retrieves the next page of results. 220 221Args: 222 previous_request: The request for the previous page. (required) 223 previous_response: The response from the request for the previous page. (required) 224 225Returns: 226 A request object that you can call 'execute()' on to request the next 227 page. Returns None if there are no more items in the collection. 228 </pre> 229</div> 230 231<div class="method"> 232 <code class="details" id="list">list(leaderboardId, collection, timeSpan, language=None, maxResults=None, pageToken=None, x__xgafv=None)</code> 233 <pre>Lists the scores in a leaderboard, starting from the top. 234 235Args: 236 leaderboardId: string, The ID of the leaderboard. (required) 237 collection: string, The collection of scores you're requesting. (required) 238 Allowed values 239 SCORE_COLLECTION_UNSPECIFIED - Default value. This value is unused. 240 PUBLIC - List all scores in the public leaderboard. 241 SOCIAL - (Obsolete) Legacy G+ social scores. 242 FRIENDS - List only scores of friends. 243 timeSpan: string, The time span for the scores and ranks you're requesting. (required) 244 Allowed values 245 SCORE_TIME_SPAN_UNSPECIFIED - Default value. This value is unused. 246 ALL_TIME - The score is an all-time score. 247 WEEKLY - The score is a weekly score. 248 DAILY - The score is a daily score. 249 language: string, The preferred language to use for strings returned by this method. 250 maxResults: integer, The maximum number of leaderboard scores to return in the response. For any response, the actual number of leaderboard scores returned may be less than the specified `maxResults`. 251 pageToken: string, The token returned by the previous request. 252 x__xgafv: string, V1 error format. 253 Allowed values 254 1 - v1 error format 255 2 - v2 error format 256 257Returns: 258 An object of the form: 259 260 { # A ListScores response. 261 "items": [ # The scores in the leaderboard. 262 { # The Leaderboard Entry resource. 263 "formattedScore": "A String", # The localized string for the numerical value of this score. 264 "formattedScoreRank": "A String", # The localized string for the rank of this score for this leaderboard. 265 "kind": "A String", # Uniquely identifies the type of this resource. Value is always the fixed string `games#leaderboardEntry`. 266 "player": { # A Player resource. # The player who holds this score. 267 "avatarImageUrl": "A String", # The base URL for the image that represents the player. 268 "bannerUrlLandscape": "A String", # The url to the landscape mode player banner image. 269 "bannerUrlPortrait": "A String", # The url to the portrait mode player banner image. 270 "displayName": "A String", # The name to display for the player. 271 "experienceInfo": { # 1P/3P metadata about the player's experience. # An object to represent Play Game experience information for the player. 272 "currentExperiencePoints": "A String", # The current number of experience points for the player. 273 "currentLevel": { # 1P/3P metadata about a user's level. # The current level of the player. 274 "kind": "A String", # Uniquely identifies the type of this resource. Value is always the fixed string `games#playerLevel`. 275 "level": 42, # The level for the user. 276 "maxExperiencePoints": "A String", # The maximum experience points for this level. 277 "minExperiencePoints": "A String", # The minimum experience points for this level. 278 }, 279 "kind": "A String", # Uniquely identifies the type of this resource. Value is always the fixed string `games#playerExperienceInfo`. 280 "lastLevelUpTimestampMillis": "A String", # The timestamp when the player was leveled up, in millis since Unix epoch UTC. 281 "nextLevel": { # 1P/3P metadata about a user's level. # The next level of the player. If the current level is the maximum level, this should be same as the current level. 282 "kind": "A String", # Uniquely identifies the type of this resource. Value is always the fixed string `games#playerLevel`. 283 "level": 42, # The level for the user. 284 "maxExperiencePoints": "A String", # The maximum experience points for this level. 285 "minExperiencePoints": "A String", # The minimum experience points for this level. 286 }, 287 }, 288 "friendStatus": "A String", # 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. 289 "kind": "A String", # Uniquely identifies the type of this resource. Value is always the fixed string `games#player` 290 "name": { # A representation of the individual components of the name. 291 "familyName": "A String", # The family name of this player. In some places, this is known as the last name. 292 "givenName": "A String", # The given name of this player. In some places, this is known as the first name. 293 }, 294 "originalPlayerId": "A String", # 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. 295 "playerId": "A String", # The ID of the player. 296 "profileSettings": { # Profile settings # The player's profile settings. Controls whether or not the player's profile is visible to other players. 297 "friendsListVisibility": "A String", 298 "kind": "A String", # Uniquely identifies the type of this resource. Value is always the fixed string `games#profileSettings`. 299 "profileVisible": True or False, # Whether the player's profile is visible to the currently signed in player. 300 }, 301 "title": "A String", # The player's title rewarded for their game activities. 302 }, 303 "scoreRank": "A String", # The rank of this score for this leaderboard. 304 "scoreTag": "A String", # Additional information about the score. Values must contain no more than 64 URI-safe characters as defined by section 2.3 of RFC 3986. 305 "scoreValue": "A String", # The numerical value of this score. 306 "timeSpan": "A String", # The time span of this high score. 307 "writeTimestampMillis": "A String", # The timestamp at which this score was recorded, in milliseconds since the epoch in UTC. 308 }, 309 ], 310 "kind": "A String", # Uniquely identifies the type of this resource. Value is always the fixed string `games#leaderboardScores`. 311 "nextPageToken": "A String", # The pagination token for the next page of results. 312 "numScores": "A String", # The total number of scores in the leaderboard. 313 "playerScore": { # The Leaderboard Entry resource. # The score of the requesting player on the leaderboard. The player's score may appear both here and in the list of scores above. If you are viewing a public leaderboard and the player is not sharing their gameplay information publicly, the `scoreRank`and `formattedScoreRank` values will not be present. 314 "formattedScore": "A String", # The localized string for the numerical value of this score. 315 "formattedScoreRank": "A String", # The localized string for the rank of this score for this leaderboard. 316 "kind": "A String", # Uniquely identifies the type of this resource. Value is always the fixed string `games#leaderboardEntry`. 317 "player": { # A Player resource. # The player who holds this score. 318 "avatarImageUrl": "A String", # The base URL for the image that represents the player. 319 "bannerUrlLandscape": "A String", # The url to the landscape mode player banner image. 320 "bannerUrlPortrait": "A String", # The url to the portrait mode player banner image. 321 "displayName": "A String", # The name to display for the player. 322 "experienceInfo": { # 1P/3P metadata about the player's experience. # An object to represent Play Game experience information for the player. 323 "currentExperiencePoints": "A String", # The current number of experience points for the player. 324 "currentLevel": { # 1P/3P metadata about a user's level. # The current level of the player. 325 "kind": "A String", # Uniquely identifies the type of this resource. Value is always the fixed string `games#playerLevel`. 326 "level": 42, # The level for the user. 327 "maxExperiencePoints": "A String", # The maximum experience points for this level. 328 "minExperiencePoints": "A String", # The minimum experience points for this level. 329 }, 330 "kind": "A String", # Uniquely identifies the type of this resource. Value is always the fixed string `games#playerExperienceInfo`. 331 "lastLevelUpTimestampMillis": "A String", # The timestamp when the player was leveled up, in millis since Unix epoch UTC. 332 "nextLevel": { # 1P/3P metadata about a user's level. # The next level of the player. If the current level is the maximum level, this should be same as the current level. 333 "kind": "A String", # Uniquely identifies the type of this resource. Value is always the fixed string `games#playerLevel`. 334 "level": 42, # The level for the user. 335 "maxExperiencePoints": "A String", # The maximum experience points for this level. 336 "minExperiencePoints": "A String", # The minimum experience points for this level. 337 }, 338 }, 339 "friendStatus": "A String", # 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. 340 "kind": "A String", # Uniquely identifies the type of this resource. Value is always the fixed string `games#player` 341 "name": { # A representation of the individual components of the name. 342 "familyName": "A String", # The family name of this player. In some places, this is known as the last name. 343 "givenName": "A String", # The given name of this player. In some places, this is known as the first name. 344 }, 345 "originalPlayerId": "A String", # 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. 346 "playerId": "A String", # The ID of the player. 347 "profileSettings": { # Profile settings # The player's profile settings. Controls whether or not the player's profile is visible to other players. 348 "friendsListVisibility": "A String", 349 "kind": "A String", # Uniquely identifies the type of this resource. Value is always the fixed string `games#profileSettings`. 350 "profileVisible": True or False, # Whether the player's profile is visible to the currently signed in player. 351 }, 352 "title": "A String", # The player's title rewarded for their game activities. 353 }, 354 "scoreRank": "A String", # The rank of this score for this leaderboard. 355 "scoreTag": "A String", # Additional information about the score. Values must contain no more than 64 URI-safe characters as defined by section 2.3 of RFC 3986. 356 "scoreValue": "A String", # The numerical value of this score. 357 "timeSpan": "A String", # The time span of this high score. 358 "writeTimestampMillis": "A String", # The timestamp at which this score was recorded, in milliseconds since the epoch in UTC. 359 }, 360 "prevPageToken": "A String", # The pagination token for the previous page of results. 361}</pre> 362</div> 363 364<div class="method"> 365 <code class="details" id="listWindow">listWindow(leaderboardId, collection, timeSpan, language=None, maxResults=None, pageToken=None, resultsAbove=None, returnTopIfAbsent=None, x__xgafv=None)</code> 366 <pre>Lists the scores in a leaderboard around (and including) a player's score. 367 368Args: 369 leaderboardId: string, The ID of the leaderboard. (required) 370 collection: string, The collection of scores you're requesting. (required) 371 Allowed values 372 SCORE_COLLECTION_UNSPECIFIED - Default value. This value is unused. 373 PUBLIC - List all scores in the public leaderboard. 374 SOCIAL - (Obsolete) Legacy G+ social scores. 375 FRIENDS - List only scores of friends. 376 timeSpan: string, The time span for the scores and ranks you're requesting. (required) 377 Allowed values 378 SCORE_TIME_SPAN_UNSPECIFIED - Default value. This value is unused. 379 ALL_TIME - The score is an all-time score. 380 WEEKLY - The score is a weekly score. 381 DAILY - The score is a daily score. 382 language: string, The preferred language to use for strings returned by this method. 383 maxResults: integer, The maximum number of leaderboard scores to return in the response. For any response, the actual number of leaderboard scores returned may be less than the specified `maxResults`. 384 pageToken: string, The token returned by the previous request. 385 resultsAbove: integer, The preferred number of scores to return above the player's score. More scores may be returned if the player is at the bottom of the leaderboard; fewer may be returned if the player is at the top. Must be less than or equal to maxResults. 386 returnTopIfAbsent: boolean, True if the top scores should be returned when the player is not in the leaderboard. Defaults to true. 387 x__xgafv: string, V1 error format. 388 Allowed values 389 1 - v1 error format 390 2 - v2 error format 391 392Returns: 393 An object of the form: 394 395 { # A ListScores response. 396 "items": [ # The scores in the leaderboard. 397 { # The Leaderboard Entry resource. 398 "formattedScore": "A String", # The localized string for the numerical value of this score. 399 "formattedScoreRank": "A String", # The localized string for the rank of this score for this leaderboard. 400 "kind": "A String", # Uniquely identifies the type of this resource. Value is always the fixed string `games#leaderboardEntry`. 401 "player": { # A Player resource. # The player who holds this score. 402 "avatarImageUrl": "A String", # The base URL for the image that represents the player. 403 "bannerUrlLandscape": "A String", # The url to the landscape mode player banner image. 404 "bannerUrlPortrait": "A String", # The url to the portrait mode player banner image. 405 "displayName": "A String", # The name to display for the player. 406 "experienceInfo": { # 1P/3P metadata about the player's experience. # An object to represent Play Game experience information for the player. 407 "currentExperiencePoints": "A String", # The current number of experience points for the player. 408 "currentLevel": { # 1P/3P metadata about a user's level. # The current level of the player. 409 "kind": "A String", # Uniquely identifies the type of this resource. Value is always the fixed string `games#playerLevel`. 410 "level": 42, # The level for the user. 411 "maxExperiencePoints": "A String", # The maximum experience points for this level. 412 "minExperiencePoints": "A String", # The minimum experience points for this level. 413 }, 414 "kind": "A String", # Uniquely identifies the type of this resource. Value is always the fixed string `games#playerExperienceInfo`. 415 "lastLevelUpTimestampMillis": "A String", # The timestamp when the player was leveled up, in millis since Unix epoch UTC. 416 "nextLevel": { # 1P/3P metadata about a user's level. # The next level of the player. If the current level is the maximum level, this should be same as the current level. 417 "kind": "A String", # Uniquely identifies the type of this resource. Value is always the fixed string `games#playerLevel`. 418 "level": 42, # The level for the user. 419 "maxExperiencePoints": "A String", # The maximum experience points for this level. 420 "minExperiencePoints": "A String", # The minimum experience points for this level. 421 }, 422 }, 423 "friendStatus": "A String", # 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. 424 "kind": "A String", # Uniquely identifies the type of this resource. Value is always the fixed string `games#player` 425 "name": { # A representation of the individual components of the name. 426 "familyName": "A String", # The family name of this player. In some places, this is known as the last name. 427 "givenName": "A String", # The given name of this player. In some places, this is known as the first name. 428 }, 429 "originalPlayerId": "A String", # 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. 430 "playerId": "A String", # The ID of the player. 431 "profileSettings": { # Profile settings # The player's profile settings. Controls whether or not the player's profile is visible to other players. 432 "friendsListVisibility": "A String", 433 "kind": "A String", # Uniquely identifies the type of this resource. Value is always the fixed string `games#profileSettings`. 434 "profileVisible": True or False, # Whether the player's profile is visible to the currently signed in player. 435 }, 436 "title": "A String", # The player's title rewarded for their game activities. 437 }, 438 "scoreRank": "A String", # The rank of this score for this leaderboard. 439 "scoreTag": "A String", # Additional information about the score. Values must contain no more than 64 URI-safe characters as defined by section 2.3 of RFC 3986. 440 "scoreValue": "A String", # The numerical value of this score. 441 "timeSpan": "A String", # The time span of this high score. 442 "writeTimestampMillis": "A String", # The timestamp at which this score was recorded, in milliseconds since the epoch in UTC. 443 }, 444 ], 445 "kind": "A String", # Uniquely identifies the type of this resource. Value is always the fixed string `games#leaderboardScores`. 446 "nextPageToken": "A String", # The pagination token for the next page of results. 447 "numScores": "A String", # The total number of scores in the leaderboard. 448 "playerScore": { # The Leaderboard Entry resource. # The score of the requesting player on the leaderboard. The player's score may appear both here and in the list of scores above. If you are viewing a public leaderboard and the player is not sharing their gameplay information publicly, the `scoreRank`and `formattedScoreRank` values will not be present. 449 "formattedScore": "A String", # The localized string for the numerical value of this score. 450 "formattedScoreRank": "A String", # The localized string for the rank of this score for this leaderboard. 451 "kind": "A String", # Uniquely identifies the type of this resource. Value is always the fixed string `games#leaderboardEntry`. 452 "player": { # A Player resource. # The player who holds this score. 453 "avatarImageUrl": "A String", # The base URL for the image that represents the player. 454 "bannerUrlLandscape": "A String", # The url to the landscape mode player banner image. 455 "bannerUrlPortrait": "A String", # The url to the portrait mode player banner image. 456 "displayName": "A String", # The name to display for the player. 457 "experienceInfo": { # 1P/3P metadata about the player's experience. # An object to represent Play Game experience information for the player. 458 "currentExperiencePoints": "A String", # The current number of experience points for the player. 459 "currentLevel": { # 1P/3P metadata about a user's level. # The current level of the player. 460 "kind": "A String", # Uniquely identifies the type of this resource. Value is always the fixed string `games#playerLevel`. 461 "level": 42, # The level for the user. 462 "maxExperiencePoints": "A String", # The maximum experience points for this level. 463 "minExperiencePoints": "A String", # The minimum experience points for this level. 464 }, 465 "kind": "A String", # Uniquely identifies the type of this resource. Value is always the fixed string `games#playerExperienceInfo`. 466 "lastLevelUpTimestampMillis": "A String", # The timestamp when the player was leveled up, in millis since Unix epoch UTC. 467 "nextLevel": { # 1P/3P metadata about a user's level. # The next level of the player. If the current level is the maximum level, this should be same as the current level. 468 "kind": "A String", # Uniquely identifies the type of this resource. Value is always the fixed string `games#playerLevel`. 469 "level": 42, # The level for the user. 470 "maxExperiencePoints": "A String", # The maximum experience points for this level. 471 "minExperiencePoints": "A String", # The minimum experience points for this level. 472 }, 473 }, 474 "friendStatus": "A String", # 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. 475 "kind": "A String", # Uniquely identifies the type of this resource. Value is always the fixed string `games#player` 476 "name": { # A representation of the individual components of the name. 477 "familyName": "A String", # The family name of this player. In some places, this is known as the last name. 478 "givenName": "A String", # The given name of this player. In some places, this is known as the first name. 479 }, 480 "originalPlayerId": "A String", # 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. 481 "playerId": "A String", # The ID of the player. 482 "profileSettings": { # Profile settings # The player's profile settings. Controls whether or not the player's profile is visible to other players. 483 "friendsListVisibility": "A String", 484 "kind": "A String", # Uniquely identifies the type of this resource. Value is always the fixed string `games#profileSettings`. 485 "profileVisible": True or False, # Whether the player's profile is visible to the currently signed in player. 486 }, 487 "title": "A String", # The player's title rewarded for their game activities. 488 }, 489 "scoreRank": "A String", # The rank of this score for this leaderboard. 490 "scoreTag": "A String", # Additional information about the score. Values must contain no more than 64 URI-safe characters as defined by section 2.3 of RFC 3986. 491 "scoreValue": "A String", # The numerical value of this score. 492 "timeSpan": "A String", # The time span of this high score. 493 "writeTimestampMillis": "A String", # The timestamp at which this score was recorded, in milliseconds since the epoch in UTC. 494 }, 495 "prevPageToken": "A String", # The pagination token for the previous page of results. 496}</pre> 497</div> 498 499<div class="method"> 500 <code class="details" id="listWindow_next">listWindow_next(previous_request, previous_response)</code> 501 <pre>Retrieves the next page of results. 502 503Args: 504 previous_request: The request for the previous page. (required) 505 previous_response: The response from the request for the previous page. (required) 506 507Returns: 508 A request object that you can call 'execute()' on to request the next 509 page. Returns None if there are no more items in the collection. 510 </pre> 511</div> 512 513<div class="method"> 514 <code class="details" id="list_next">list_next(previous_request, previous_response)</code> 515 <pre>Retrieves the next page of results. 516 517Args: 518 previous_request: The request for the previous page. (required) 519 previous_response: The response from the request for the previous page. (required) 520 521Returns: 522 A request object that you can call 'execute()' on to request the next 523 page. Returns None if there are no more items in the collection. 524 </pre> 525</div> 526 527<div class="method"> 528 <code class="details" id="submit">submit(leaderboardId, score, language=None, scoreTag=None, x__xgafv=None)</code> 529 <pre>Submits a score to the specified leaderboard. 530 531Args: 532 leaderboardId: string, The ID of the leaderboard. (required) 533 score: string, The score you're submitting. The submitted score is ignored if it is worse than a previously submitted score, where worse depends on the leaderboard sort order. The meaning of the score value depends on the leaderboard format type. For fixed-point, the score represents the raw value. For time, the score represents elapsed time in milliseconds. For currency, the score represents a value in micro units. (required) 534 language: string, The preferred language to use for strings returned by this method. 535 scoreTag: string, Additional information about the score you're submitting. Values must contain no more than 64 URI-safe characters as defined by section 2.3 of RFC 3986. 536 x__xgafv: string, V1 error format. 537 Allowed values 538 1 - v1 error format 539 2 - v2 error format 540 541Returns: 542 An object of the form: 543 544 { # A list of leaderboard entry resources. 545 "beatenScoreTimeSpans": [ # The time spans where the submitted score is better than the existing score for that time span. 546 "A String", 547 ], 548 "formattedScore": "A String", # The formatted value of the submitted score. 549 "kind": "A String", # Uniquely identifies the type of this resource. Value is always the fixed string `games#playerScoreResponse`. 550 "leaderboardId": "A String", # The leaderboard ID that this score was submitted to. 551 "scoreTag": "A String", # Additional information about this score. Values will contain no more than 64 URI-safe characters as defined by section 2.3 of RFC 3986. 552 "unbeatenScores": [ # The scores in time spans that have not been beaten. As an example, the submitted score may be better than the player's `DAILY` score, but not better than the player's scores for the `WEEKLY` or `ALL_TIME` time spans. 553 { # A player score. 554 "formattedScore": "A String", # The formatted score for this player score. 555 "kind": "A String", # Uniquely identifies the type of this resource. Value is always the fixed string `games#playerScore`. 556 "score": "A String", # The numerical value for this player score. 557 "scoreTag": "A String", # Additional information about this score. Values will contain no more than 64 URI-safe characters as defined by section 2.3 of RFC 3986. 558 "timeSpan": "A String", # The time span for this player score. 559 }, 560 ], 561}</pre> 562</div> 563 564<div class="method"> 565 <code class="details" id="submitMultiple">submitMultiple(body=None, language=None, x__xgafv=None)</code> 566 <pre>Submits multiple scores to leaderboards. 567 568Args: 569 body: object, The request body. 570 The object takes the form of: 571 572{ # A list of score submission requests. 573 "kind": "A String", # Uniquely identifies the type of this resource. Value is always the fixed string `games#playerScoreSubmissionList`. 574 "scores": [ # The score submissions. 575 { # A request to submit a score to leaderboards. 576 "kind": "A String", # Uniquely identifies the type of this resource. Value is always the fixed string `games#scoreSubmission`. 577 "leaderboardId": "A String", # The leaderboard this score is being submitted to. 578 "score": "A String", # The new score being submitted. 579 "scoreTag": "A String", # Additional information about this score. Values will contain no more than 64 URI-safe characters as defined by section 2.3 of RFC 3986. 580 "signature": "A String", # Signature Values will contain URI-safe characters as defined by section 2.3 of RFC 3986. 581 }, 582 ], 583} 584 585 language: string, The preferred language to use for strings returned by this method. 586 x__xgafv: string, V1 error format. 587 Allowed values 588 1 - v1 error format 589 2 - v2 error format 590 591Returns: 592 An object of the form: 593 594 { # A list of score submission statuses. 595 "kind": "A String", # Uniquely identifies the type of this resource. Value is always the fixed string `games#playerScoreListResponse`. 596 "submittedScores": [ # The score submissions statuses. 597 { # A list of leaderboard entry resources. 598 "beatenScoreTimeSpans": [ # The time spans where the submitted score is better than the existing score for that time span. 599 "A String", 600 ], 601 "formattedScore": "A String", # The formatted value of the submitted score. 602 "kind": "A String", # Uniquely identifies the type of this resource. Value is always the fixed string `games#playerScoreResponse`. 603 "leaderboardId": "A String", # The leaderboard ID that this score was submitted to. 604 "scoreTag": "A String", # Additional information about this score. Values will contain no more than 64 URI-safe characters as defined by section 2.3 of RFC 3986. 605 "unbeatenScores": [ # The scores in time spans that have not been beaten. As an example, the submitted score may be better than the player's `DAILY` score, but not better than the player's scores for the `WEEKLY` or `ALL_TIME` time spans. 606 { # A player score. 607 "formattedScore": "A String", # The formatted score for this player score. 608 "kind": "A String", # Uniquely identifies the type of this resource. Value is always the fixed string `games#playerScore`. 609 "score": "A String", # The numerical value for this player score. 610 "scoreTag": "A String", # Additional information about this score. Values will contain no more than 64 URI-safe characters as defined by section 2.3 of RFC 3986. 611 "timeSpan": "A String", # The time span for this player score. 612 }, 613 ], 614 }, 615 ], 616}</pre> 617</div> 618 619</body></html>