blob: 6ecca1faa78073dd15447fb0b1658aeebb06d475 [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://www.googleapis.com/",
"batchPath": "batch/games/v1management",
"canonicalName": "Games Management",
"description": "The Google Play Game Management API allows developers to manage resources from the Google\n 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",
"mtlsRootUrl": "https://www.mtls.googleapis.com/",
"name": "gamesManagement",
"ownerDomain": "google.com",
"ownerName": "Google",
"parameters": {
"$.xgafv": {
"description": "V1 error format.",
"enum": [
"1",
"2"
],
"enumDescriptions": [
"v1 error format",
"v2 error format"
],
"location": "query",
"type": "string"
},
"access_token": {
"description": "OAuth access token.",
"location": "query",
"type": "string"
},
"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"
},
"callback": {
"description": "JSONP",
"location": "query",
"type": "string"
},
"fields": {
"description": "Selector specifying which fields to include in a partial response.",
"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"
},
"oauth_token": {
"description": "OAuth 2.0 token for the current user.",
"location": "query",
"type": "string"
},
"prettyPrint": {
"default": "true",
"description": "Returns response with indentations and line breaks.",
"location": "query",
"type": "boolean"
},
"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"
},
"uploadType": {
"description": "Legacy upload protocol for media (e.g. \"media\", \"multipart\").",
"location": "query",
"type": "string"
},
"upload_protocol": {
"description": "Upload protocol for media (e.g. \"raw\", \"multipart\").",
"location": "query",
"type": "string"
}
},
"protocol": "rest",
"resources": {
"achievements": {
"methods": {
"reset": {
"description": "Resets the achievement with the given ID for the currently authenticated\nplayer. This method is only accessible to whitelisted tester accounts for\nyour application.",
"flatPath": "games/v1management/achievements/{achievementId}/reset",
"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"
]
},
"resetAll": {
"description": "Resets all achievements for the currently authenticated player for your\napplication. This method is only accessible to whitelisted tester accounts\nfor your application.",
"flatPath": "games/v1management/achievements/reset",
"httpMethod": "POST",
"id": "gamesManagement.achievements.resetAll",
"parameterOrder": [],
"parameters": {},
"path": "games/v1management/achievements/reset",
"response": {
"$ref": "AchievementResetAllResponse"
},
"scopes": [
"https://www.googleapis.com/auth/games"
]
},
"resetAllForAllPlayers": {
"description": "Resets all draft achievements for all players. This method is only\navailable to user accounts for your developer console.",
"flatPath": "games/v1management/achievements/resetAllForAllPlayers",
"httpMethod": "POST",
"id": "gamesManagement.achievements.resetAllForAllPlayers",
"parameterOrder": [],
"parameters": {},
"path": "games/v1management/achievements/resetAllForAllPlayers",
"scopes": [
"https://www.googleapis.com/auth/games"
]
},
"resetForAllPlayers": {
"description": "Resets the achievement with the given ID for all players. This method is\nonly available to user accounts for your developer console. Only draft\nachievements can be reset.",
"flatPath": "games/v1management/achievements/{achievementId}/resetForAllPlayers",
"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\navailable to user accounts for your developer console. Only draft\nachievements may be reset.",
"flatPath": "games/v1management/achievements/resetMultipleForAllPlayers",
"httpMethod": "POST",
"id": "gamesManagement.achievements.resetMultipleForAllPlayers",
"parameterOrder": [],
"parameters": {},
"path": "games/v1management/achievements/resetMultipleForAllPlayers",
"request": {
"$ref": "AchievementResetMultipleForAllRequest"
},
"scopes": [
"https://www.googleapis.com/auth/games"
]
}
}
},
"applications": {
"methods": {
"listHidden": {
"description": "Get the list of players hidden from the given application. This method is\nonly available to user accounts for your developer console.",
"flatPath": "games/v1management/applications/{applicationId}/players/hidden",
"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"
},
"maxResults": {
"description": "The maximum number of player resources to return in the response, used for\npaging. For any response, the actual number of player resources returned\nmay be less than the specified `maxResults`.",
"format": "int32",
"location": "query",
"type": "integer"
},
"pageToken": {
"description": "The token returned by the previous request.",
"location": "query",
"type": "string"
}
},
"path": "games/v1management/applications/{applicationId}/players/hidden",
"response": {
"$ref": "HiddenPlayerList"
},
"scopes": [
"https://www.googleapis.com/auth/games"
]
}
}
},
"events": {
"methods": {
"reset": {
"description": "Resets all player progress on the event with the given ID for the currently\nauthenticated player. This method is only accessible to whitelisted tester\naccounts for your application.",
"flatPath": "games/v1management/events/{eventId}/reset",
"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"
]
},
"resetAll": {
"description": "Resets all player progress on all events for the currently authenticated\nplayer. This method is only accessible to whitelisted tester accounts for\nyour application.",
"flatPath": "games/v1management/events/reset",
"httpMethod": "POST",
"id": "gamesManagement.events.resetAll",
"parameterOrder": [],
"parameters": {},
"path": "games/v1management/events/reset",
"scopes": [
"https://www.googleapis.com/auth/games"
]
},
"resetAllForAllPlayers": {
"description": "Resets all draft events for all players. This method is only available to\nuser accounts for your developer console.",
"flatPath": "games/v1management/events/resetAllForAllPlayers",
"httpMethod": "POST",
"id": "gamesManagement.events.resetAllForAllPlayers",
"parameterOrder": [],
"parameters": {},
"path": "games/v1management/events/resetAllForAllPlayers",
"scopes": [
"https://www.googleapis.com/auth/games"
]
},
"resetForAllPlayers": {
"description": "Resets the event with the given ID for all players. This method is only\navailable to user accounts for your developer console. Only draft events\ncan be reset.",
"flatPath": "games/v1management/events/{eventId}/resetForAllPlayers",
"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\navailable to user accounts for your developer console. Only draft events\nmay be reset.",
"flatPath": "games/v1management/events/resetMultipleForAllPlayers",
"httpMethod": "POST",
"id": "gamesManagement.events.resetMultipleForAllPlayers",
"parameterOrder": [],
"parameters": {},
"path": "games/v1management/events/resetMultipleForAllPlayers",
"request": {
"$ref": "EventsResetMultipleForAllRequest"
},
"scopes": [
"https://www.googleapis.com/auth/games"
]
}
}
},
"players": {
"methods": {
"hide": {
"description": "Hide the given player's leaderboard scores from the given application. This\nmethod is only available to user accounts for your developer console.",
"flatPath": "games/v1management/applications/{applicationId}/players/hidden/{playerId}",
"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\nauthenticated 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.\nThis method is only available to user accounts for your developer console.",
"flatPath": "games/v1management/applications/{applicationId}/players/hidden/{playerId}",
"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\nauthenticated player's ID.",
"location": "path",
"required": true,
"type": "string"
}
},
"path": "games/v1management/applications/{applicationId}/players/hidden/{playerId}",
"scopes": [
"https://www.googleapis.com/auth/games"
]
}
}
},
"scores": {
"methods": {
"reset": {
"description": "Resets scores for the leaderboard with the given ID for the currently\nauthenticated player. This method is only accessible to whitelisted tester\naccounts for your application.",
"flatPath": "games/v1management/leaderboards/{leaderboardId}/scores/reset",
"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"
]
},
"resetAll": {
"description": "Resets all scores for all leaderboards for the currently authenticated\nplayers. This method is only accessible to whitelisted tester accounts for\nyour application.",
"flatPath": "games/v1management/scores/reset",
"httpMethod": "POST",
"id": "gamesManagement.scores.resetAll",
"parameterOrder": [],
"parameters": {},
"path": "games/v1management/scores/reset",
"response": {
"$ref": "PlayerScoreResetAllResponse"
},
"scopes": [
"https://www.googleapis.com/auth/games"
]
},
"resetAllForAllPlayers": {
"description": "Resets scores for all draft leaderboards for all players. This method is\nonly available to user accounts for your developer console.",
"flatPath": "games/v1management/scores/resetAllForAllPlayers",
"httpMethod": "POST",
"id": "gamesManagement.scores.resetAllForAllPlayers",
"parameterOrder": [],
"parameters": {},
"path": "games/v1management/scores/resetAllForAllPlayers",
"scopes": [
"https://www.googleapis.com/auth/games"
]
},
"resetForAllPlayers": {
"description": "Resets scores for the leaderboard with the given ID for all players. This\nmethod is only available to user accounts for your developer console. Only\ndraft leaderboards can be reset.",
"flatPath": "games/v1management/leaderboards/{leaderboardId}/scores/resetForAllPlayers",
"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\nmethod is only available to user accounts for your developer console. Only\ndraft leaderboards may be reset.",
"flatPath": "games/v1management/scores/resetMultipleForAllPlayers",
"httpMethod": "POST",
"id": "gamesManagement.scores.resetMultipleForAllPlayers",
"parameterOrder": [],
"parameters": {},
"path": "games/v1management/scores/resetMultipleForAllPlayers",
"request": {
"$ref": "ScoresResetMultipleForAllRequest"
},
"scopes": [
"https://www.googleapis.com/auth/games"
]
}
}
}
},
"revision": "20200528",
"rootUrl": "https://www.googleapis.com/",
"schemas": {
"AchievementResetAllResponse": {
"description": "Achievement reset all response.",
"id": "AchievementResetAllResponse",
"properties": {
"kind": {
"description": "Uniquely identifies the type of this resource. Value is always the fixed\nstring `gamesManagement#achievementResetAllResponse`.",
"type": "string"
},
"results": {
"description": "The achievement reset results.",
"items": {
"$ref": "AchievementResetResponse"
},
"type": "array"
}
},
"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\nstring `gamesManagement#achievementResetMultipleForAllRequest`.",
"type": "string"
}
},
"type": "object"
},
"AchievementResetResponse": {
"description": "An achievement reset response.",
"id": "AchievementResetResponse",
"properties": {
"currentState": {
"description": "The current state of the achievement. This is the same as the initial\nstate of the achievement. \u003cbr/\u003ePossible values are: \u003cul\u003e\n\u003cli\u003e\"`HIDDEN`\"- Achievement is hidden.\u003c/li\u003e\n\u003cli\u003e\"`REVEALED`\" - Achievement is revealed.\u003c/li\u003e\n\u003cli\u003e\"`UNLOCKED`\" - Achievement is unlocked.\u003c/li\u003e \u003c/ul\u003e",
"type": "string"
},
"definitionId": {
"description": "The ID of an achievement for which player state has been updated.",
"type": "string"
},
"kind": {
"description": "Uniquely identifies the type of this resource. Value is always the fixed\nstring `gamesManagement#achievementResetResponse`.",
"type": "string"
},
"updateOccurred": {
"description": "Flag to indicate if the requested update actually occurred.",
"type": "boolean"
}
},
"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\nstring `gamesManagement#eventsResetMultipleForAllRequest`.",
"type": "string"
}
},
"type": "object"
},
"GamesPlayerExperienceInfoResource": {
"description": "1P/3P metadata about the player's experience.",
"id": "GamesPlayerExperienceInfoResource",
"properties": {
"currentExperiencePoints": {
"description": "The current number of experience points for the player.",
"format": "int64",
"type": "string"
},
"currentLevel": {
"$ref": "GamesPlayerLevelResource",
"description": "The current level of the player."
},
"lastLevelUpTimestampMillis": {
"description": "The timestamp when the player was leveled up, in millis since Unix epoch\nUTC.",
"format": "int64",
"type": "string"
},
"nextLevel": {
"$ref": "GamesPlayerLevelResource",
"description": "The next level of the player. If the current level is the maximum level,\nthis should be same as the current level."
}
},
"type": "object"
},
"GamesPlayerLevelResource": {
"description": "1P/3P metadata about a user's level.",
"id": "GamesPlayerLevelResource",
"properties": {
"level": {
"description": "The level for the user.",
"format": "int32",
"type": "integer"
},
"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"
}
},
"type": "object"
},
"HiddenPlayer": {
"description": "The HiddenPlayer resource.",
"id": "HiddenPlayer",
"properties": {
"hiddenTimeMillis": {
"description": "Output only. The time this player was hidden.",
"format": "int64",
"type": "string"
},
"kind": {
"description": "Output only. Uniquely identifies the type of this resource. Value is always the fixed\nstring `gamesManagement#hiddenPlayer`.",
"type": "string"
},
"player": {
"$ref": "Player",
"description": "Output only. The player information."
}
},
"type": "object"
},
"HiddenPlayerList": {
"description": "A list of hidden players.",
"id": "HiddenPlayerList",
"properties": {
"items": {
"description": "The players.",
"items": {
"$ref": "HiddenPlayer"
},
"type": "array"
},
"kind": {
"description": "Uniquely identifies the type of this resource. Value is always the fixed\nstring `gamesManagement#hiddenPlayerList`.",
"type": "string"
},
"nextPageToken": {
"description": "The pagination token for the next page of results.",
"type": "string"
}
},
"type": "object"
},
"Player": {
"description": "A Player resource.",
"id": "Player",
"properties": {
"avatarImageUrl": {
"description": "The base URL for the image that represents the player.",
"type": "string"
},
"bannerUrlLandscape": {
"description": "The url to the landscape mode player banner image.",
"type": "string"
},
"bannerUrlPortrait": {
"description": "The url to the portrait mode player banner image.",
"type": "string"
},
"displayName": {
"description": "The name to display for the player.",
"type": "string"
},
"experienceInfo": {
"$ref": "GamesPlayerExperienceInfoResource",
"description": "An object to represent Play Game experience information for the player."
},
"kind": {
"description": "Uniquely identifies the type of this resource. Value is always the fixed\nstring `gamesManagement#player`.",
"type": "string"
},
"name": {
"description": "An object representation of the individual components of the player's name.\nFor 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\nname.",
"type": "string"
},
"givenName": {
"description": "The given name of this player. In some places, this is known as the first\nname.",
"type": "string"
}
},
"type": "object"
},
"originalPlayerId": {
"description": "The player ID that was used for this player the first time they signed into\nthe game in question. This is only populated for calls to player.get for\nthe requesting player, only if the player ID has subsequently changed, and\nonly to clients that support remapping player IDs.",
"type": "string"
},
"playerId": {
"description": "The ID of the player.",
"type": "string"
},
"profileSettings": {
"$ref": "ProfileSettings",
"description": "The player's profile settings. Controls whether or not the player's profile\nis visible to other players."
},
"title": {
"description": "The player's title rewarded for their game activities.",
"type": "string"
}
},
"type": "object"
},
"PlayerScoreResetAllResponse": {
"description": "A list of leaderboard reset resources.",
"id": "PlayerScoreResetAllResponse",
"properties": {
"kind": {
"description": "Uniquely identifies the type of this resource. Value is always the fixed\nstring `gamesManagement#playerScoreResetAllResponse`.",
"type": "string"
},
"results": {
"description": "The leaderboard reset results.",
"items": {
"$ref": "PlayerScoreResetResponse"
},
"type": "array"
}
},
"type": "object"
},
"PlayerScoreResetResponse": {
"description": "A list of reset leaderboard entry resources.",
"id": "PlayerScoreResetResponse",
"properties": {
"definitionId": {
"description": "The ID of an leaderboard for which player state has been updated.",
"type": "string"
},
"kind": {
"description": "Uniquely identifies the type of this resource. Value is always the fixed\nstring `gamesManagement#playerScoreResetResponse`.",
"type": "string"
},
"resetScoreTimeSpans": {
"description": "The time spans of the updated score. \u003cbr/\u003ePossible values are: \u003cul\u003e\n\u003cli\u003e\"`ALL_TIME`\" - The score is an all-time score.\u003c/li\u003e\n\u003cli\u003e\"`WEEKLY`\" - The score is a weekly score.\u003c/li\u003e\n\u003cli\u003e\"`DAILY`\" - The score is a daily score.\u003c/li\u003e \u003c/ul\u003e",
"items": {
"type": "string"
},
"type": "array"
}
},
"type": "object"
},
"ProfileSettings": {
"description": "Profile settings",
"id": "ProfileSettings",
"properties": {
"kind": {
"description": "Uniquely identifies the type of this resource. Value is always the fixed\nstring `gamesManagement#profileSettings`.",
"type": "string"
},
"profileVisible": {
"type": "boolean"
}
},
"type": "object"
},
"ScoresResetMultipleForAllRequest": {
"id": "ScoresResetMultipleForAllRequest",
"properties": {
"kind": {
"description": "Uniquely identifies the type of this resource. Value is always the fixed\nstring `gamesManagement#scoresResetMultipleForAllRequest`.",
"type": "string"
},
"leaderboard_ids": {
"description": "The IDs of leaderboards to reset.",
"items": {
"type": "string"
},
"type": "array"
}
},
"type": "object"
}
},
"servicePath": "",
"title": "Google Play Game Management",
"version": "v1management"
}