Close httplib2 connections.
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'.
get_next(previous_request, previous_response)
Retrieves the next page of results.
Lists the scores in a leaderboard, starting from the top.
Lists the scores in a leaderboard around (and including) a player's score.
listWindow_next(previous_request, previous_response)
Retrieves the next page of results.
list_next(previous_request, previous_response)
Retrieves the next page of results.
submit(leaderboardId, score, scoreTag=None, language=None, x__xgafv=None)
Submits a score to the specified leaderboard.
submitMultiple(body=None, language=None, x__xgafv=None)
Submits multiple scores to leaderboards.
close()
Close httplib2 connections.
get(playerId, leaderboardId, timeSpan, pageToken=None, includeRankType=None, maxResults=None, language=None, x__xgafv=None)
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'. Args: playerId: string, A player ID. A value of `me` may be used in place of the authenticated player's ID. (required) leaderboardId: string, The ID of the leaderboard. Can be set to 'ALL' to retrieve data for all leaderboards for this application. (required) timeSpan: string, The time span for the scores and ranks you're requesting. (required) Allowed values SCORE_TIME_SPAN_UNSPECIFIED - Default value. This value is unused. ALL - Get the high scores for all time spans. If this is used, maxResults values will be ignored. ALL_TIME - Get the all time high score. WEEKLY - List the top scores for the current day. DAILY - List the top scores for the current week. pageToken: string, The token returned by the previous request. includeRankType: string, The types of ranks to return. If the parameter is omitted, no ranks will be returned. Allowed values INCLUDE_RANK_TYPE_UNSPECIFIED - Default value. Should be unused. ALL - Retrieve all supported ranks. In HTTP, this parameter value can also be specified as `ALL`. PUBLIC - Retrieve public ranks, if the player is sharing their gameplay activity publicly. SOCIAL - (Obsolete) Retrieve the social rank. FRIENDS - Retrieve the rank on the friends collection. 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`. language: string, The preferred language to use for strings returned by this method. x__xgafv: string, V1 error format. Allowed values 1 - v1 error format 2 - v2 error format Returns: An object of the form: { # A list of player leaderboard scores. "kind": "A String", # Uniquely identifies the type of this resource. Value is always the fixed string `games#playerLeaderboardScoreListResponse`. "items": [ # The leaderboard scores. { # A player leaderboard score object. "socialRank": { # A score rank in a leaderboard. # The social rank of the score in this leaderboard. "kind": "A String", # Uniquely identifies the type of this resource. Value is always the fixed string `games#leaderboardScoreRank`. "formattedRank": "A String", # The rank in the leaderboard as a string. "numScores": "A String", # The number of scores in the leaderboard. "rank": "A String", # The rank in the leaderboard. "formattedNumScores": "A String", # The number of scores in the leaderboard as a string. }, "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. "kind": "A String", # Uniquely identifies the type of this resource. Value is always the fixed string `games#leaderboardScoreRank`. "formattedRank": "A String", # The rank in the leaderboard as a string. "numScores": "A String", # The number of scores in the leaderboard. "rank": "A String", # The rank in the leaderboard. "formattedNumScores": "A String", # The number of scores in the leaderboard as a string. }, "writeTimestamp": "A String", # The timestamp at which this score was recorded, in milliseconds since the epoch in UTC. "scoreValue": "A String", # The numerical value of this score. "friendsRank": { # A score rank in a leaderboard. # The rank of the score in the friends collection for this leaderboard. "kind": "A String", # Uniquely identifies the type of this resource. Value is always the fixed string `games#leaderboardScoreRank`. "formattedRank": "A String", # The rank in the leaderboard as a string. "numScores": "A String", # The number of scores in the leaderboard. "rank": "A String", # The rank in the leaderboard. "formattedNumScores": "A String", # The number of scores in the leaderboard as a string. }, "kind": "A String", # Uniquely identifies the type of this resource. Value is always the fixed string `games#playerLeaderboardScore`. "leaderboard_id": "A String", # The ID of the leaderboard this score is in. "timeSpan": "A String", # The time span of this score. "scoreString": "A String", # The formatted value of this score. "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. }, ], "player": { # A Player resource. # The Player resources for the owner of this score. "displayName": "A String", # The name to display for the player. "profileSettings": { # Profile settings # The player's profile settings. Controls whether or not the player's profile is visible to other players. "friendsListVisibility": "A String", "kind": "A String", # Uniquely identifies the type of this resource. Value is always the fixed string `games#profileSettings`. "profileVisible": True or False, # Whether the player's profile is visible to the currently signed in player. }, "bannerUrlPortrait": "A String", # The url to the portrait mode player banner image. "name": { # A representation of the individual components of the name. "givenName": "A String", # The given name of this player. In some places, this is known as the first name. "familyName": "A String", # The family name of this player. In some places, this is known as the last name. }, "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. "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. "playerId": "A String", # The ID of the player. "kind": "A String", # Uniquely identifies the type of this resource. Value is always the fixed string `games#player` "experienceInfo": { # 1P/3P metadata about the player's experience. # An object to represent Play Game experience information for the player. "kind": "A String", # Uniquely identifies the type of this resource. Value is always the fixed string `games#playerExperienceInfo`. "currentLevel": { # 1P/3P metadata about a user's level. # The current level of the player. "level": 42, # The level for the user. "minExperiencePoints": "A String", # The minimum experience points for this level. "kind": "A String", # Uniquely identifies the type of this resource. Value is always the fixed string `games#playerLevel`. "maxExperiencePoints": "A String", # The maximum experience points for this level. }, "currentExperiencePoints": "A String", # The current number of experience points for the player. "lastLevelUpTimestampMillis": "A String", # The timestamp when the player was leveled up, in millis since Unix epoch UTC. "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. "level": 42, # The level for the user. "minExperiencePoints": "A String", # The minimum experience points for this level. "kind": "A String", # Uniquely identifies the type of this resource. Value is always the fixed string `games#playerLevel`. "maxExperiencePoints": "A String", # The maximum experience points for this level. }, }, "bannerUrlLandscape": "A String", # The url to the landscape mode player banner image. "avatarImageUrl": "A String", # The base URL for the image that represents the player. "title": "A String", # The player's title rewarded for their game activities. }, "nextPageToken": "A String", # The pagination token for the next page of results. }
get_next(previous_request, previous_response)
Retrieves the next page of results. Args: previous_request: The request for the previous page. (required) previous_response: The response from the request for the previous page. (required) Returns: A request object that you can call 'execute()' on to request the next page. Returns None if there are no more items in the collection.
list(leaderboardId, collection, timeSpan, language=None, maxResults=None, pageToken=None, x__xgafv=None)
Lists the scores in a leaderboard, starting from the top. Args: leaderboardId: string, The ID of the leaderboard. (required) collection: string, The collection of scores you're requesting. (required) Allowed values SCORE_COLLECTION_UNSPECIFIED - Default value. This value is unused. PUBLIC - List all scores in the public leaderboard. SOCIAL - (Obsolete) Legacy G+ social scores. FRIENDS - List only scores of friends. timeSpan: string, The time span for the scores and ranks you're requesting. (required) Allowed values SCORE_TIME_SPAN_UNSPECIFIED - Default value. This value is unused. ALL_TIME - The score is an all-time score. WEEKLY - The score is a weekly score. DAILY - The score is a daily score. language: string, The preferred language to use for strings returned by this method. 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`. pageToken: string, The token returned by the previous request. x__xgafv: string, V1 error format. Allowed values 1 - v1 error format 2 - v2 error format Returns: An object of the form: { # A ListScores response. "prevPageToken": "A String", # The pagination token for the previous page of results. "items": [ # The scores in the leaderboard. { # The Leaderboard Entry resource. "formattedScore": "A String", # The localized string for the numerical value of this score. "formattedScoreRank": "A String", # The localized string for the rank of this score for this leaderboard. "scoreRank": "A String", # The rank of this score for this leaderboard. "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. "writeTimestampMillis": "A String", # The timestamp at which this score was recorded, in milliseconds since the epoch in UTC. "player": { # A Player resource. # The player who holds this score. "displayName": "A String", # The name to display for the player. "profileSettings": { # Profile settings # The player's profile settings. Controls whether or not the player's profile is visible to other players. "friendsListVisibility": "A String", "kind": "A String", # Uniquely identifies the type of this resource. Value is always the fixed string `games#profileSettings`. "profileVisible": True or False, # Whether the player's profile is visible to the currently signed in player. }, "bannerUrlPortrait": "A String", # The url to the portrait mode player banner image. "name": { # A representation of the individual components of the name. "givenName": "A String", # The given name of this player. In some places, this is known as the first name. "familyName": "A String", # The family name of this player. In some places, this is known as the last name. }, "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. "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. "playerId": "A String", # The ID of the player. "kind": "A String", # Uniquely identifies the type of this resource. Value is always the fixed string `games#player` "experienceInfo": { # 1P/3P metadata about the player's experience. # An object to represent Play Game experience information for the player. "kind": "A String", # Uniquely identifies the type of this resource. Value is always the fixed string `games#playerExperienceInfo`. "currentLevel": { # 1P/3P metadata about a user's level. # The current level of the player. "level": 42, # The level for the user. "minExperiencePoints": "A String", # The minimum experience points for this level. "kind": "A String", # Uniquely identifies the type of this resource. Value is always the fixed string `games#playerLevel`. "maxExperiencePoints": "A String", # The maximum experience points for this level. }, "currentExperiencePoints": "A String", # The current number of experience points for the player. "lastLevelUpTimestampMillis": "A String", # The timestamp when the player was leveled up, in millis since Unix epoch UTC. "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. "level": 42, # The level for the user. "minExperiencePoints": "A String", # The minimum experience points for this level. "kind": "A String", # Uniquely identifies the type of this resource. Value is always the fixed string `games#playerLevel`. "maxExperiencePoints": "A String", # The maximum experience points for this level. }, }, "bannerUrlLandscape": "A String", # The url to the landscape mode player banner image. "avatarImageUrl": "A String", # The base URL for the image that represents the player. "title": "A String", # The player's title rewarded for their game activities. }, "timeSpan": "A String", # The time span of this high score. "scoreValue": "A String", # The numerical value of this score. "kind": "A String", # Uniquely identifies the type of this resource. Value is always the fixed string `games#leaderboardEntry`. }, ], "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. "formattedScore": "A String", # The localized string for the numerical value of this score. "formattedScoreRank": "A String", # The localized string for the rank of this score for this leaderboard. "scoreRank": "A String", # The rank of this score for this leaderboard. "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. "writeTimestampMillis": "A String", # The timestamp at which this score was recorded, in milliseconds since the epoch in UTC. "player": { # A Player resource. # The player who holds this score. "displayName": "A String", # The name to display for the player. "profileSettings": { # Profile settings # The player's profile settings. Controls whether or not the player's profile is visible to other players. "friendsListVisibility": "A String", "kind": "A String", # Uniquely identifies the type of this resource. Value is always the fixed string `games#profileSettings`. "profileVisible": True or False, # Whether the player's profile is visible to the currently signed in player. }, "bannerUrlPortrait": "A String", # The url to the portrait mode player banner image. "name": { # A representation of the individual components of the name. "givenName": "A String", # The given name of this player. In some places, this is known as the first name. "familyName": "A String", # The family name of this player. In some places, this is known as the last name. }, "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. "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. "playerId": "A String", # The ID of the player. "kind": "A String", # Uniquely identifies the type of this resource. Value is always the fixed string `games#player` "experienceInfo": { # 1P/3P metadata about the player's experience. # An object to represent Play Game experience information for the player. "kind": "A String", # Uniquely identifies the type of this resource. Value is always the fixed string `games#playerExperienceInfo`. "currentLevel": { # 1P/3P metadata about a user's level. # The current level of the player. "level": 42, # The level for the user. "minExperiencePoints": "A String", # The minimum experience points for this level. "kind": "A String", # Uniquely identifies the type of this resource. Value is always the fixed string `games#playerLevel`. "maxExperiencePoints": "A String", # The maximum experience points for this level. }, "currentExperiencePoints": "A String", # The current number of experience points for the player. "lastLevelUpTimestampMillis": "A String", # The timestamp when the player was leveled up, in millis since Unix epoch UTC. "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. "level": 42, # The level for the user. "minExperiencePoints": "A String", # The minimum experience points for this level. "kind": "A String", # Uniquely identifies the type of this resource. Value is always the fixed string `games#playerLevel`. "maxExperiencePoints": "A String", # The maximum experience points for this level. }, }, "bannerUrlLandscape": "A String", # The url to the landscape mode player banner image. "avatarImageUrl": "A String", # The base URL for the image that represents the player. "title": "A String", # The player's title rewarded for their game activities. }, "timeSpan": "A String", # The time span of this high score. "scoreValue": "A String", # The numerical value of this score. "kind": "A String", # Uniquely identifies the type of this resource. Value is always the fixed string `games#leaderboardEntry`. }, "nextPageToken": "A String", # The pagination token for the next page of results. "numScores": "A String", # The total number of scores in the leaderboard. "kind": "A String", # Uniquely identifies the type of this resource. Value is always the fixed string `games#leaderboardScores`. }
listWindow(leaderboardId, collection, timeSpan, pageToken=None, returnTopIfAbsent=None, resultsAbove=None, language=None, maxResults=None, x__xgafv=None)
Lists the scores in a leaderboard around (and including) a player's score. Args: leaderboardId: string, The ID of the leaderboard. (required) collection: string, The collection of scores you're requesting. (required) Allowed values SCORE_COLLECTION_UNSPECIFIED - Default value. This value is unused. PUBLIC - List all scores in the public leaderboard. SOCIAL - (Obsolete) Legacy G+ social scores. FRIENDS - List only scores of friends. timeSpan: string, The time span for the scores and ranks you're requesting. (required) Allowed values SCORE_TIME_SPAN_UNSPECIFIED - Default value. This value is unused. ALL_TIME - The score is an all-time score. WEEKLY - The score is a weekly score. DAILY - The score is a daily score. pageToken: string, The token returned by the previous request. returnTopIfAbsent: boolean, True if the top scores should be returned when the player is not in the leaderboard. Defaults to true. 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. language: string, The preferred language to use for strings returned by this method. 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`. x__xgafv: string, V1 error format. Allowed values 1 - v1 error format 2 - v2 error format Returns: An object of the form: { # A ListScores response. "prevPageToken": "A String", # The pagination token for the previous page of results. "items": [ # The scores in the leaderboard. { # The Leaderboard Entry resource. "formattedScore": "A String", # The localized string for the numerical value of this score. "formattedScoreRank": "A String", # The localized string for the rank of this score for this leaderboard. "scoreRank": "A String", # The rank of this score for this leaderboard. "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. "writeTimestampMillis": "A String", # The timestamp at which this score was recorded, in milliseconds since the epoch in UTC. "player": { # A Player resource. # The player who holds this score. "displayName": "A String", # The name to display for the player. "profileSettings": { # Profile settings # The player's profile settings. Controls whether or not the player's profile is visible to other players. "friendsListVisibility": "A String", "kind": "A String", # Uniquely identifies the type of this resource. Value is always the fixed string `games#profileSettings`. "profileVisible": True or False, # Whether the player's profile is visible to the currently signed in player. }, "bannerUrlPortrait": "A String", # The url to the portrait mode player banner image. "name": { # A representation of the individual components of the name. "givenName": "A String", # The given name of this player. In some places, this is known as the first name. "familyName": "A String", # The family name of this player. In some places, this is known as the last name. }, "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. "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. "playerId": "A String", # The ID of the player. "kind": "A String", # Uniquely identifies the type of this resource. Value is always the fixed string `games#player` "experienceInfo": { # 1P/3P metadata about the player's experience. # An object to represent Play Game experience information for the player. "kind": "A String", # Uniquely identifies the type of this resource. Value is always the fixed string `games#playerExperienceInfo`. "currentLevel": { # 1P/3P metadata about a user's level. # The current level of the player. "level": 42, # The level for the user. "minExperiencePoints": "A String", # The minimum experience points for this level. "kind": "A String", # Uniquely identifies the type of this resource. Value is always the fixed string `games#playerLevel`. "maxExperiencePoints": "A String", # The maximum experience points for this level. }, "currentExperiencePoints": "A String", # The current number of experience points for the player. "lastLevelUpTimestampMillis": "A String", # The timestamp when the player was leveled up, in millis since Unix epoch UTC. "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. "level": 42, # The level for the user. "minExperiencePoints": "A String", # The minimum experience points for this level. "kind": "A String", # Uniquely identifies the type of this resource. Value is always the fixed string `games#playerLevel`. "maxExperiencePoints": "A String", # The maximum experience points for this level. }, }, "bannerUrlLandscape": "A String", # The url to the landscape mode player banner image. "avatarImageUrl": "A String", # The base URL for the image that represents the player. "title": "A String", # The player's title rewarded for their game activities. }, "timeSpan": "A String", # The time span of this high score. "scoreValue": "A String", # The numerical value of this score. "kind": "A String", # Uniquely identifies the type of this resource. Value is always the fixed string `games#leaderboardEntry`. }, ], "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. "formattedScore": "A String", # The localized string for the numerical value of this score. "formattedScoreRank": "A String", # The localized string for the rank of this score for this leaderboard. "scoreRank": "A String", # The rank of this score for this leaderboard. "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. "writeTimestampMillis": "A String", # The timestamp at which this score was recorded, in milliseconds since the epoch in UTC. "player": { # A Player resource. # The player who holds this score. "displayName": "A String", # The name to display for the player. "profileSettings": { # Profile settings # The player's profile settings. Controls whether or not the player's profile is visible to other players. "friendsListVisibility": "A String", "kind": "A String", # Uniquely identifies the type of this resource. Value is always the fixed string `games#profileSettings`. "profileVisible": True or False, # Whether the player's profile is visible to the currently signed in player. }, "bannerUrlPortrait": "A String", # The url to the portrait mode player banner image. "name": { # A representation of the individual components of the name. "givenName": "A String", # The given name of this player. In some places, this is known as the first name. "familyName": "A String", # The family name of this player. In some places, this is known as the last name. }, "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. "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. "playerId": "A String", # The ID of the player. "kind": "A String", # Uniquely identifies the type of this resource. Value is always the fixed string `games#player` "experienceInfo": { # 1P/3P metadata about the player's experience. # An object to represent Play Game experience information for the player. "kind": "A String", # Uniquely identifies the type of this resource. Value is always the fixed string `games#playerExperienceInfo`. "currentLevel": { # 1P/3P metadata about a user's level. # The current level of the player. "level": 42, # The level for the user. "minExperiencePoints": "A String", # The minimum experience points for this level. "kind": "A String", # Uniquely identifies the type of this resource. Value is always the fixed string `games#playerLevel`. "maxExperiencePoints": "A String", # The maximum experience points for this level. }, "currentExperiencePoints": "A String", # The current number of experience points for the player. "lastLevelUpTimestampMillis": "A String", # The timestamp when the player was leveled up, in millis since Unix epoch UTC. "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. "level": 42, # The level for the user. "minExperiencePoints": "A String", # The minimum experience points for this level. "kind": "A String", # Uniquely identifies the type of this resource. Value is always the fixed string `games#playerLevel`. "maxExperiencePoints": "A String", # The maximum experience points for this level. }, }, "bannerUrlLandscape": "A String", # The url to the landscape mode player banner image. "avatarImageUrl": "A String", # The base URL for the image that represents the player. "title": "A String", # The player's title rewarded for their game activities. }, "timeSpan": "A String", # The time span of this high score. "scoreValue": "A String", # The numerical value of this score. "kind": "A String", # Uniquely identifies the type of this resource. Value is always the fixed string `games#leaderboardEntry`. }, "nextPageToken": "A String", # The pagination token for the next page of results. "numScores": "A String", # The total number of scores in the leaderboard. "kind": "A String", # Uniquely identifies the type of this resource. Value is always the fixed string `games#leaderboardScores`. }
listWindow_next(previous_request, previous_response)
Retrieves the next page of results. Args: previous_request: The request for the previous page. (required) previous_response: The response from the request for the previous page. (required) Returns: A request object that you can call 'execute()' on to request the next page. Returns None if there are no more items in the collection.
list_next(previous_request, previous_response)
Retrieves the next page of results. Args: previous_request: The request for the previous page. (required) previous_response: The response from the request for the previous page. (required) Returns: A request object that you can call 'execute()' on to request the next page. Returns None if there are no more items in the collection.
submit(leaderboardId, score, scoreTag=None, language=None, x__xgafv=None)
Submits a score to the specified leaderboard. Args: leaderboardId: string, The ID of the leaderboard. (required) 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) 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. language: string, The preferred language to use for strings returned by this method. x__xgafv: string, V1 error format. Allowed values 1 - v1 error format 2 - v2 error format Returns: An object of the form: { # A list of leaderboard entry resources. "leaderboardId": "A String", # The leaderboard ID that this score was submitted to. "kind": "A String", # Uniquely identifies the type of this resource. Value is always the fixed string `games#playerScoreResponse`. "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. { # A player score. "kind": "A String", # Uniquely identifies the type of this resource. Value is always the fixed string `games#playerScore`. "timeSpan": "A String", # The time span for this player score. "formattedScore": "A String", # The formatted score for this player score. "score": "A String", # The numerical value for this player score. "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. }, ], "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. "beatenScoreTimeSpans": [ # The time spans where the submitted score is better than the existing score for that time span. "A String", ], "formattedScore": "A String", # The formatted value of the submitted score. }
submitMultiple(body=None, language=None, x__xgafv=None)
Submits multiple scores to leaderboards. Args: body: object, The request body. The object takes the form of: { # A list of score submission requests. "scores": [ # The score submissions. { # A request to submit a score to leaderboards. "score": "A String", # The new score being submitted. "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. "leaderboardId": "A String", # The leaderboard this score is being submitted to. "kind": "A String", # Uniquely identifies the type of this resource. Value is always the fixed string `games#scoreSubmission`. "signature": "A String", # Signature Values will contain URI-safe characters as defined by section 2.3 of RFC 3986. }, ], "kind": "A String", # Uniquely identifies the type of this resource. Value is always the fixed string `games#playerScoreSubmissionList`. } language: string, The preferred language to use for strings returned by this method. x__xgafv: string, V1 error format. Allowed values 1 - v1 error format 2 - v2 error format Returns: An object of the form: { # A list of score submission statuses. "submittedScores": [ # The score submissions statuses. { # A list of leaderboard entry resources. "leaderboardId": "A String", # The leaderboard ID that this score was submitted to. "kind": "A String", # Uniquely identifies the type of this resource. Value is always the fixed string `games#playerScoreResponse`. "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. { # A player score. "kind": "A String", # Uniquely identifies the type of this resource. Value is always the fixed string `games#playerScore`. "timeSpan": "A String", # The time span for this player score. "formattedScore": "A String", # The formatted score for this player score. "score": "A String", # The numerical value for this player score. "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. }, ], "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. "beatenScoreTimeSpans": [ # The time spans where the submitted score is better than the existing score for that time span. "A String", ], "formattedScore": "A String", # The formatted value of the submitted score. }, ], "kind": "A String", # Uniquely identifies the type of this resource. Value is always the fixed string `games#playerScoreListResponse`. }