blob: 08c7d4c164b49d6b39f4bb5aa7a9660159794c55 [file] [log] [blame]
{
"auth": {
"oauth2": {
"scopes": {
"https://www.googleapis.com/auth/games": {
"description": "Create, edit, and delete your Google Play Games activity"
}
}
}
},
"basePath": "",
"baseUrl": "https://gamesmanagement.googleapis.com/",
"batchPath": "batch",
"canonicalName": "Games Management",
"description": "The Google Play Game Management API allows developers to manage resources from the Google Play Game service.",
"discoveryVersion": "v1",
"documentationLink": "https://developers.google.com/games/",
"icons": {
"x16": "http://www.google.com/images/icons/product/search-16.gif",
"x32": "http://www.google.com/images/icons/product/search-32.gif"
},
"id": "gamesManagement:v1management",
"kind": "discovery#restDescription",
"name": "gamesManagement",
"ownerDomain": "google.com",
"ownerName": "Google",
"parameters": {
"alt": {
"default": "json",
"description": "Data format for response.",
"enum": [
"json",
"media",
"proto"
],
"enumDescriptions": [
"Responses with Content-Type of application/json",
"Media download with context-dependent Content-Type",
"Responses with Content-Type of application/x-protobuf"
],
"location": "query",
"type": "string"
},
"uploadType": {
"description": "Legacy upload protocol for media (e.g. \"media\", \"multipart\").",
"location": "query",
"type": "string"
},
"quotaUser": {
"description": "Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.",
"location": "query",
"type": "string"
},
"oauth_token": {
"description": "OAuth 2.0 token for the current user.",
"location": "query",
"type": "string"
},
"key": {
"description": "API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.",
"location": "query",
"type": "string"
},
"callback": {
"description": "JSONP",
"location": "query",
"type": "string"
},
"fields": {
"description": "Selector specifying which fields to include in a partial response.",
"location": "query",
"type": "string"
},
"$.xgafv": {
"description": "V1 error format.",
"enum": [
"1",
"2"
],
"enumDescriptions": [
"v1 error format",
"v2 error format"
],
"location": "query",
"type": "string"
},
"prettyPrint": {
"default": "true",
"description": "Returns response with indentations and line breaks.",
"location": "query",
"type": "boolean"
},
"access_token": {
"description": "OAuth access token.",
"location": "query",
"type": "string"
},
"upload_protocol": {
"description": "Upload protocol for media (e.g. \"raw\", \"multipart\").",
"location": "query",
"type": "string"
}
},
"protocol": "rest",
"resources": {
"players": {
"methods": {
"hide": {
"description": "Hide the given player's leaderboard scores from the given application. This method is only available to user accounts for your developer console.",
"httpMethod": "POST",
"id": "gamesManagement.players.hide",
"parameterOrder": [
"applicationId",
"playerId"
],
"parameters": {
"applicationId": {
"description": "The application ID from the Google Play developer console.",
"location": "path",
"required": true,
"type": "string"
},
"playerId": {
"description": "A player ID. A value of `me` may be used in place of the authenticated player's ID.",
"location": "path",
"required": true,
"type": "string"
}
},
"path": "games/v1management/applications/{applicationId}/players/hidden/{playerId}",
"scopes": [
"https://www.googleapis.com/auth/games"
]
},
"unhide": {
"description": "Unhide the given player's leaderboard scores from the given application. This method is only available to user accounts for your developer console.",
"httpMethod": "DELETE",
"id": "gamesManagement.players.unhide",
"parameterOrder": [
"applicationId",
"playerId"
],
"parameters": {
"applicationId": {
"description": "The application ID from the Google Play developer console.",
"location": "path",
"required": true,
"type": "string"
},
"playerId": {
"description": "A player ID. A value of `me` may be used in place of the authenticated player's ID.",
"location": "path",
"required": true,
"type": "string"
}
},
"path": "games/v1management/applications/{applicationId}/players/hidden/{playerId}",
"scopes": [
"https://www.googleapis.com/auth/games"
]
}
}
},
"achievements": {
"methods": {
"reset": {
"description": "Resets the achievement with the given ID for the currently authenticated player. This method is only accessible to whitelisted tester accounts for your application.",
"httpMethod": "POST",
"id": "gamesManagement.achievements.reset",
"parameterOrder": [
"achievementId"
],
"parameters": {
"achievementId": {
"description": "The ID of the achievement used by this method.",
"location": "path",
"required": true,
"type": "string"
}
},
"path": "games/v1management/achievements/{achievementId}/reset",
"response": {
"$ref": "AchievementResetResponse"
},
"scopes": [
"https://www.googleapis.com/auth/games"
]
},
"resetAllForAllPlayers": {
"description": "Resets all draft achievements for all players. This method is only available to user accounts for your developer console.",
"httpMethod": "POST",
"id": "gamesManagement.achievements.resetAllForAllPlayers",
"parameterOrder": [],
"parameters": {},
"path": "games/v1management/achievements/resetAllForAllPlayers",
"scopes": [
"https://www.googleapis.com/auth/games"
]
},
"resetAll": {
"description": "Resets all achievements for the currently authenticated player for your application. This method is only accessible to whitelisted tester accounts for your application.",
"httpMethod": "POST",
"id": "gamesManagement.achievements.resetAll",
"parameterOrder": [],
"parameters": {},
"path": "games/v1management/achievements/reset",
"response": {
"$ref": "AchievementResetAllResponse"
},
"scopes": [
"https://www.googleapis.com/auth/games"
]
},
"resetForAllPlayers": {
"description": "Resets the achievement with the given ID for all players. This method is only available to user accounts for your developer console. Only draft achievements can be reset.",
"httpMethod": "POST",
"id": "gamesManagement.achievements.resetForAllPlayers",
"parameterOrder": [
"achievementId"
],
"parameters": {
"achievementId": {
"description": "The ID of the achievement used by this method.",
"location": "path",
"required": true,
"type": "string"
}
},
"path": "games/v1management/achievements/{achievementId}/resetForAllPlayers",
"scopes": [
"https://www.googleapis.com/auth/games"
]
},
"resetMultipleForAllPlayers": {
"description": "Resets achievements with the given IDs for all players. This method is only available to user accounts for your developer console. Only draft achievements may be reset.",
"httpMethod": "POST",
"id": "gamesManagement.achievements.resetMultipleForAllPlayers",
"parameterOrder": [],
"parameters": {},
"path": "games/v1management/achievements/resetMultipleForAllPlayers",
"request": {
"$ref": "AchievementResetMultipleForAllRequest"
},
"scopes": [
"https://www.googleapis.com/auth/games"
]
}
}
},
"scores": {
"methods": {
"resetAll": {
"description": "Resets all scores for all leaderboards for the currently authenticated players. This method is only accessible to whitelisted tester accounts for your application.",
"httpMethod": "POST",
"id": "gamesManagement.scores.resetAll",
"parameterOrder": [],
"parameters": {},
"path": "games/v1management/scores/reset",
"response": {
"$ref": "PlayerScoreResetAllResponse"
},
"scopes": [
"https://www.googleapis.com/auth/games"
]
},
"resetForAllPlayers": {
"description": "Resets scores for the leaderboard with the given ID for all players. This method is only available to user accounts for your developer console. Only draft leaderboards can be reset.",
"httpMethod": "POST",
"id": "gamesManagement.scores.resetForAllPlayers",
"parameterOrder": [
"leaderboardId"
],
"parameters": {
"leaderboardId": {
"description": "The ID of the leaderboard.",
"location": "path",
"required": true,
"type": "string"
}
},
"path": "games/v1management/leaderboards/{leaderboardId}/scores/resetForAllPlayers",
"scopes": [
"https://www.googleapis.com/auth/games"
]
},
"resetMultipleForAllPlayers": {
"description": "Resets scores for the leaderboards with the given IDs for all players. This method is only available to user accounts for your developer console. Only draft leaderboards may be reset.",
"httpMethod": "POST",
"id": "gamesManagement.scores.resetMultipleForAllPlayers",
"parameterOrder": [],
"parameters": {},
"path": "games/v1management/scores/resetMultipleForAllPlayers",
"request": {
"$ref": "ScoresResetMultipleForAllRequest"
},
"scopes": [
"https://www.googleapis.com/auth/games"
]
},
"reset": {
"description": "Resets scores for the leaderboard with the given ID for the currently authenticated player. This method is only accessible to whitelisted tester accounts for your application.",
"httpMethod": "POST",
"id": "gamesManagement.scores.reset",
"parameterOrder": [
"leaderboardId"
],
"parameters": {
"leaderboardId": {
"description": "The ID of the leaderboard.",
"location": "path",
"required": true,
"type": "string"
}
},
"path": "games/v1management/leaderboards/{leaderboardId}/scores/reset",
"response": {
"$ref": "PlayerScoreResetResponse"
},
"scopes": [
"https://www.googleapis.com/auth/games"
]
},
"resetAllForAllPlayers": {
"description": "Resets scores for all draft leaderboards for all players. This method is only available to user accounts for your developer console.",
"httpMethod": "POST",
"id": "gamesManagement.scores.resetAllForAllPlayers",
"parameterOrder": [],
"parameters": {},
"path": "games/v1management/scores/resetAllForAllPlayers",
"scopes": [
"https://www.googleapis.com/auth/games"
]
}
}
},
"events": {
"methods": {
"resetAll": {
"description": "Resets all player progress on all events for the currently authenticated player. This method is only accessible to whitelisted tester accounts for your application.",
"httpMethod": "POST",
"id": "gamesManagement.events.resetAll",
"parameterOrder": [],
"parameters": {},
"path": "games/v1management/events/reset",
"scopes": [
"https://www.googleapis.com/auth/games"
]
},
"resetForAllPlayers": {
"description": "Resets the event with the given ID for all players. This method is only available to user accounts for your developer console. Only draft events can be reset.",
"httpMethod": "POST",
"id": "gamesManagement.events.resetForAllPlayers",
"parameterOrder": [
"eventId"
],
"parameters": {
"eventId": {
"description": "The ID of the event.",
"location": "path",
"required": true,
"type": "string"
}
},
"path": "games/v1management/events/{eventId}/resetForAllPlayers",
"scopes": [
"https://www.googleapis.com/auth/games"
]
},
"resetMultipleForAllPlayers": {
"description": "Resets events with the given IDs for all players. This method is only available to user accounts for your developer console. Only draft events may be reset.",
"httpMethod": "POST",
"id": "gamesManagement.events.resetMultipleForAllPlayers",
"parameterOrder": [],
"parameters": {},
"path": "games/v1management/events/resetMultipleForAllPlayers",
"request": {
"$ref": "EventsResetMultipleForAllRequest"
},
"scopes": [
"https://www.googleapis.com/auth/games"
]
},
"resetAllForAllPlayers": {
"description": "Resets all draft events for all players. This method is only available to user accounts for your developer console.",
"httpMethod": "POST",
"id": "gamesManagement.events.resetAllForAllPlayers",
"parameterOrder": [],
"parameters": {},
"path": "games/v1management/events/resetAllForAllPlayers",
"scopes": [
"https://www.googleapis.com/auth/games"
]
},
"reset": {
"description": "Resets all player progress on the event with the given ID for the currently authenticated player. This method is only accessible to whitelisted tester accounts for your application.",
"httpMethod": "POST",
"id": "gamesManagement.events.reset",
"parameterOrder": [
"eventId"
],
"parameters": {
"eventId": {
"description": "The ID of the event.",
"location": "path",
"required": true,
"type": "string"
}
},
"path": "games/v1management/events/{eventId}/reset",
"scopes": [
"https://www.googleapis.com/auth/games"
]
}
}
},
"applications": {
"methods": {
"listHidden": {
"description": "Get the list of players hidden from the given application. This method is only available to user accounts for your developer console.",
"httpMethod": "GET",
"id": "gamesManagement.applications.listHidden",
"parameterOrder": [
"applicationId"
],
"parameters": {
"applicationId": {
"description": "The application ID from the Google Play developer console.",
"location": "path",
"required": true,
"type": "string"
},
"pageToken": {
"description": "The token returned by the previous request.",
"location": "query",
"type": "string"
},
"maxResults": {
"description": "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`.",
"format": "int32",
"location": "query",
"type": "integer"
}
},
"path": "games/v1management/applications/{applicationId}/players/hidden",
"response": {
"$ref": "HiddenPlayerList"
},
"scopes": [
"https://www.googleapis.com/auth/games"
]
}
}
}
},
"revision": "20201001",
"rootUrl": "https://gamesmanagement.googleapis.com/",
"schemas": {
"GamesPlayerExperienceInfoResource": {
"description": "1P/3P metadata about the player's experience.",
"id": "GamesPlayerExperienceInfoResource",
"properties": {
"nextLevel": {
"$ref": "GamesPlayerLevelResource",
"description": "The next level of the player. If the current level is the maximum level, this should be same as the current level."
},
"lastLevelUpTimestampMillis": {
"description": "The timestamp when the player was leveled up, in millis since Unix epoch UTC.",
"format": "int64",
"type": "string"
},
"currentLevel": {
"$ref": "GamesPlayerLevelResource",
"description": "The current level of the player."
},
"currentExperiencePoints": {
"description": "The current number of experience points for the player.",
"format": "int64",
"type": "string"
}
},
"type": "object"
},
"ProfileSettings": {
"description": "Profile settings",
"id": "ProfileSettings",
"properties": {
"kind": {
"description": "Uniquely identifies the type of this resource. Value is always the fixed string `gamesManagement#profileSettings`.",
"type": "string"
},
"profileVisible": {
"type": "boolean"
}
},
"type": "object"
},
"PlayerScoreResetAllResponse": {
"description": "A list of leaderboard reset resources.",
"id": "PlayerScoreResetAllResponse",
"properties": {
"results": {
"description": "The leaderboard reset results.",
"items": {
"$ref": "PlayerScoreResetResponse"
},
"type": "array"
},
"kind": {
"description": "Uniquely identifies the type of this resource. Value is always the fixed string `gamesManagement#playerScoreResetAllResponse`.",
"type": "string"
}
},
"type": "object"
},
"HiddenPlayer": {
"description": "The HiddenPlayer resource.",
"id": "HiddenPlayer",
"properties": {
"hiddenTimeMillis": {
"description": "Output only. The time this player was hidden.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"kind": {
"description": "Output only. Uniquely identifies the type of this resource. Value is always the fixed string `gamesManagement#hiddenPlayer`.",
"readOnly": true,
"type": "string"
},
"player": {
"$ref": "Player",
"description": "Output only. The player information.",
"readOnly": true
}
},
"type": "object"
},
"PlayerScoreResetResponse": {
"description": "A list of reset leaderboard entry resources.",
"id": "PlayerScoreResetResponse",
"properties": {
"kind": {
"description": "Uniquely identifies the type of this resource. Value is always the fixed string `gamesManagement#playerScoreResetResponse`.",
"type": "string"
},
"resetScoreTimeSpans": {
"description": "The time spans of the updated score. Possible values are: - \"`ALL_TIME`\" - The score is an all-time score. - \"`WEEKLY`\" - The score is a weekly score. - \"`DAILY`\" - The score is a daily score. ",
"items": {
"type": "string"
},
"type": "array"
},
"definitionId": {
"description": "The ID of an leaderboard for which player state has been updated.",
"type": "string"
}
},
"type": "object"
},
"AchievementResetAllResponse": {
"description": "Achievement reset all response.",
"id": "AchievementResetAllResponse",
"properties": {
"kind": {
"description": "Uniquely identifies the type of this resource. Value is always the fixed string `gamesManagement#achievementResetAllResponse`.",
"type": "string"
},
"results": {
"description": "The achievement reset results.",
"items": {
"$ref": "AchievementResetResponse"
},
"type": "array"
}
},
"type": "object"
},
"GamesPlayerLevelResource": {
"description": "1P/3P metadata about a user's level.",
"id": "GamesPlayerLevelResource",
"properties": {
"maxExperiencePoints": {
"description": "The maximum experience points for this level.",
"format": "int64",
"type": "string"
},
"minExperiencePoints": {
"description": "The minimum experience points for this level.",
"format": "int64",
"type": "string"
},
"level": {
"description": "The level for the user.",
"format": "int32",
"type": "integer"
}
},
"type": "object"
},
"Player": {
"description": "A Player resource.",
"id": "Player",
"properties": {
"profileSettings": {
"$ref": "ProfileSettings",
"description": "The player's profile settings. Controls whether or not the player's profile is visible to other players."
},
"bannerUrlLandscape": {
"description": "The url to the landscape mode player banner image.",
"type": "string"
},
"originalPlayerId": {
"description": "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.",
"type": "string"
},
"displayName": {
"description": "The name to display for the player.",
"type": "string"
},
"bannerUrlPortrait": {
"description": "The url to the portrait mode player banner image.",
"type": "string"
},
"avatarImageUrl": {
"description": "The base URL for the image that represents the player.",
"type": "string"
},
"kind": {
"description": "Uniquely identifies the type of this resource. Value is always the fixed string `gamesManagement#player`.",
"type": "string"
},
"name": {
"description": "An object representation of the individual components of the player's name. For some players, these fields may not be present.",
"properties": {
"familyName": {
"description": "The family name of this player. In some places, this is known as the last name.",
"type": "string"
},
"givenName": {
"description": "The given name of this player. In some places, this is known as the first name.",
"type": "string"
}
},
"type": "object"
},
"playerId": {
"description": "The ID of the player.",
"type": "string"
},
"experienceInfo": {
"$ref": "GamesPlayerExperienceInfoResource",
"description": "An object to represent Play Game experience information for the player."
},
"title": {
"description": "The player's title rewarded for their game activities.",
"type": "string"
}
},
"type": "object"
},
"HiddenPlayerList": {
"description": "A list of hidden players.",
"id": "HiddenPlayerList",
"properties": {
"kind": {
"description": "Uniquely identifies the type of this resource. Value is always the fixed string `gamesManagement#hiddenPlayerList`.",
"type": "string"
},
"nextPageToken": {
"description": "The pagination token for the next page of results.",
"type": "string"
},
"items": {
"description": "The players.",
"items": {
"$ref": "HiddenPlayer"
},
"type": "array"
}
},
"type": "object"
},
"EventsResetMultipleForAllRequest": {
"description": "Multiple events reset all request.",
"id": "EventsResetMultipleForAllRequest",
"properties": {
"event_ids": {
"description": "The IDs of events to reset.",
"items": {
"type": "string"
},
"type": "array"
},
"kind": {
"description": "Uniquely identifies the type of this resource. Value is always the fixed string `gamesManagement#eventsResetMultipleForAllRequest`.",
"type": "string"
}
},
"type": "object"
},
"ScoresResetMultipleForAllRequest": {
"id": "ScoresResetMultipleForAllRequest",
"properties": {
"leaderboard_ids": {
"description": "The IDs of leaderboards to reset.",
"items": {
"type": "string"
},
"type": "array"
},
"kind": {
"description": "Uniquely identifies the type of this resource. Value is always the fixed string `gamesManagement#scoresResetMultipleForAllRequest`.",
"type": "string"
}
},
"type": "object"
},
"AchievementResetResponse": {
"description": "An achievement reset response.",
"id": "AchievementResetResponse",
"properties": {
"definitionId": {
"description": "The ID of an achievement for which player state has been updated.",
"type": "string"
},
"updateOccurred": {
"description": "Flag to indicate if the requested update actually occurred.",
"type": "boolean"
},
"currentState": {
"description": "The current state of the achievement. This is the same as the initial state of the achievement. Possible values are: - \"`HIDDEN`\"- Achievement is hidden. - \"`REVEALED`\" - Achievement is revealed. - \"`UNLOCKED`\" - Achievement is unlocked. ",
"type": "string"
},
"kind": {
"description": "Uniquely identifies the type of this resource. Value is always the fixed string `gamesManagement#achievementResetResponse`.",
"type": "string"
}
},
"type": "object"
},
"AchievementResetMultipleForAllRequest": {
"id": "AchievementResetMultipleForAllRequest",
"properties": {
"achievement_ids": {
"description": "The IDs of achievements to reset.",
"items": {
"type": "string"
},
"type": "array"
},
"kind": {
"description": "Uniquely identifies the type of this resource. Value is always the fixed string `gamesManagement#achievementResetMultipleForAllRequest`.",
"type": "string"
}
},
"type": "object"
}
},
"servicePath": "",
"title": "Google Play Game Management",
"version": "v1management"
}