Create a leaderboard localization
Add a new leaderboard localization.
URL
POST https://api.appstoreconnect.apple.com/v1/gameCenterLeaderboardLocalizationsResponse Codes
| Status | Reason | Type | Description |
|---|---|---|---|
| 201 | Created Content-Type: application/json | GameCenterLeaderboardLocalizationResponse | |
| 400 | Bad Request Content-Type: application/json | ErrorResponse | |
| 401 | Unauthorized Content-Type: application/json | ErrorResponse | |
| 403 | Forbidden Content-Type: application/json | ErrorResponse | |
| 409 | Conflict Content-Type: application/json | ErrorResponse | |
| 422 | Content-Type: application/json | ErrorResponse | |
| 429 | Content-Type: application/json | ErrorResponse |
Discussion
Use leaderboard formatters to specify the unit of measurement for a Game Center leaderboard. There is a new required attribute defaultFormatter when you use Create a leaderboard, which gives all your localizations the same formatter. You can also optionally use formatterOverride to override a specific leaderboard localization when calling Create a leaderboard localization or Modify a leaderboard localization.
Before App Store Connect API version 3.0, formatters were based on localizations and were required for each localization. Legacy leaderboards created before the new addition of the Game Center APIs will not have a defaultFormatter value, the value would be null in this case. Any localizations created before the new addition of the Game Center APIs will always have a formatterOverride.
Example Request and Response
HTTP Body
See Also
Managing leaderboard localizations
Read Game Center leaderboard localization informationList all images for a Game Center leaderboard localizationGet all image IDs for a Game Center leaderboard localizationCreate a Game Center leaderboard localizationModify a Game Center leaderboard localizationDelete a Game Center leaderboard localizationRead leaderboard localization informationRead the image for a leaderboard localizationGET /v1/gameCenterLeaderboardLocalizations/{id}/relationships/gameCenterLeaderboardImageModify a leaderboard localizationDelete a leaderboard localization