Google Play games services features

There are two ways to create achievements for the first time using the Google Play Console:

• Create an achievement: Add definitions and metadata for each achievement one at a time.
• Import achievementsImport definitions and other metadata for multiple achievements together in a single step.

Note:Use APIs to unlock achievements for the signed in player. This will reveal any hidden achievements to the player.

To create an achievement for a new and unpublished game, complete these steps using Google Play Console:

1. In the Google Play Console, select a game.
2. In the Play Games Services - Achievements page (Grow > Play Games Services > Setup and management > Achievements), select Create achievement.
3. In the Add achievements page, complete the form.
4. Click Save as draft.

After you have created an achievement, you need to publish your game.

Add more achievements

If you already have existing achievements and want to add more:

1. In the Google Play Console, select a game.

2. In the Play Games Services - Achievements page (Grow > Play Games Services > Setup and management > Achievements), select Add achievements.

To add multiple achievements to your game at once, use the following steps:

1. Create a zip file containing your achievements.

1. 1 Upload the file.

For more information about the zip file, see Zip file guidelines.

To import achievements:

1. In the Google Play Console, select a game.
2. In the Play Games Services - Achievements page (Grow > Play Games Services > Setup and management > Achievements), select Import achievements.
3. In the Import achievements page, click Upload.
4. Select the zip file to upload.
5. Click Save as draft.
6. After you have imported achievements, you need to publish your game.

Once you test and publish your game, all of your game's achievements are published with it.

To edit an achievement that you've already created, select the achievement in the Achievements tab of Google Play Console. At this point, you will see the same form you used when first creating the achievement, and you can edit any of the fields as you need.

When you're done editing an achievement, click the Save as draft button. The newly edited achievement will be in a "ready to test" stage, and you'll be able to test it out. If it is working correctly, select Republish from the drop-down list. This republishes your game, along with all your updated achievements, to the public.

Note: Once an achievement is published, its initial state (hidden or revealed) and its type (incremental or standard) is fixed and can't be changed.

If you decide you don't like your current achievement and want to go back to your achievement the way it was before, select Revert from the drop-down list in Google Play Console, and all of your achievements will revert back to the previously published version.

Once your achievement has been published, it cannot be deleted.

You can only delete an achievement in a pre-published state by clicking the button labeled Delete at the bottom of the form for that achievement.

You can only reset player progress data for your draft achievements.

• To reset achievements in Google Play Console, click the button labeled Reset achievement progress at the bottom of the form for that event.
• To reset achievement data programmatically, call the Management API Achievements methods.

The AchievementsMetadata.csv file contains the metadata for each achievement. It should include the information as comma-separated values in the following order:

These fields are described in the following table:

AchievementsMetadata.csv file requirements:

• Each row must have seven values. If you want to omit a value, leave it blank.
• The Name and Description fields are used as the default locale.
• The Name field should be unique across all achievements.
• The following fields shouldn't contain commas: Name and Description.

A sample AchievementsMetadata.csv file:

The AchievementsLocalizations.csv file is an optional file that sets up all the data that is needed to describe each achievement to users in different locales. Achievements are translated in alignment with the locales specified for the game.

It should include the information as comma-separated values in the following order:

These fields are described in the following table:

AchievementsLocalizations.csv file requirements:

• Achievement names within a game must be unique per locale. For example, if a game supports both en-US and fr-FR locales, an achievement named "Achievement1" for en-US can also be named "Achievement1" for fr-FR.
• Each row should have four values. If you want to omit the Localized description value, leave it blank.

A sample AchievementsLocalizations.csv file:

CSV column headers	Required or Optional	Description
Name	Required	Must match the Name column from AchievementsMetadata.csv.
Icon filename	Required	The name of your icon file.

Icons you reference in AchievementsIconMappings.csv file must exist in the current zip archive you import. For more information, see Icon guidelines.

You can specify your own translations for achievements that are associated with your game. Before you do so, first make sure to complete the steps described in Adding translations for your game.

There are two ways in which you can add translations for your game:

• You can use the Import achievements option to upload translations for many new achievements at once. You cannot use this option to upload translations for already existing achievements.
• You can add translations for each achievement in your game. To add your own translation for each achievement:
  1. In the Google Play Console open the Achievements tab for your game, then select an existing achievement.
  2. In the achievements details page, select the tab for a language that you previously added in the Game details tab.
  3. In the achievement details page for that language, edit the form with your translations for that achievement.
  4. Click Save to store your translated achievement details.

If you decide you don't like your newly-edited leaderboard and want to go back to the previous iteration, simply select Revert from the box at the top of the Leaderboard form. Your leaderboard reverts back to the already published version.

To enable the Saved Games service, complete these steps in Play Console:

1. In the Google Play Console, select a game.
2. In the Play Games Services - Configuration page (Grow > Play Games Services > Setup and management > Configuration), select Edit properties.
3. Turn the Saved Games option to ON.
4. Click Save.

After performing the steps, it may take up to 24 hours for Google Play Games Services to activate the Saved Games service for your game. If you want to test the Saved Games service immediately, manually clear the data in the Google Play Services app on your test device.

To clear the cached data on Android, open Settings > Apps > Google Play services, click on Manage Space, then click Clear All Data.

For more information about the Saved Games service, see the Saved Games game guide.

To edit Play Games Services settings within Play Console, you must ensure that your team has the right permissions to manage Play Game Services. See Add developer account users and manage permissions for more information about permissions in Play Console.