Where To Go To Find Your Google Play Game Service Id

This document covers how to use the Google Play Console to set up Google Play games services for your Android game. The Google Play Panel provides a centralized identify for you to manage game services and configure metadata for authorizing and authenticating your game.

To add your game to the Google Play Panel, follow these general steps:

Create a game project for your game and specify details such equally the name and description of the game.
Create and link the necessary credentials to authorize and cosign your game to Google Play Games Services.

These steps are covered in more item in the sections below.

Step 1. Sign in to the Google Play Console

To sign in, go the Google Play Console. If you haven't registered for the Google Play Console before, you will be prompted to do then.

Step 2. Add your game to the Google Play Console

To add together your game, follow these steps:

Create a game in Play Console if you haven't already. See here for more details.
Navigate to Grow > Play Games Services > Setup and management > Configuration.
Specify whether your game already uses Google APIs (such as Firebase). Choosing the correct pick is very of import.
- If this is a game you are creating from scratch, or yous have never prepare Google APIs for it previously, choose No, my game doesn't utilise Google APIs. Enter your game's name and and then click Create.
- If this is a game for which you lot accept already set up up i or more Google APIs, choose Yes, my game already uses Google APIs. You will see a list of projects from the Google Cloud Console for which yous are listed equally a developer. Select your projection from the list so click Apply.
- If you lot want to use an existing Play Games Services project, cull Employ an existing Play Games Services project. You lot volition see a list of existing Play Games Services projects for your account. Select the right game projection from the list and so click Use. This is not a typical option, but you might practice this if you are creating a new game in Play Panel to alter the package proper name, or if you take gratis and paid versions of your game with unlike package names.
A Play Games Services game projection is created, and a corresponding entry is created for y'all in the Google Cloud Console.
In the Properties department, you lot can select Edit Properties and add the description, category, and graphic assets for your game.
- Only the display name is required for testing. The other fields must be filled out earlier yous can publish your game.
- The display proper noun and description for your game should match what yous have set up for your game's Play Shop list.
- For guidelines on creating the graphic avails, see the Google Play for Developers guide and the Google Play Featured-Epitome Guidelines.

Pace iii. Generate an OAuth two.0 customer ID

Your game must take an OAuth ii.0 client ID in order to be authenticated and authorized to call the Google Play games services. To set up upward a credential for Play Games Services, which is the association betwixt a client ID and your game, use Google Deject Platform to create the client ID. And so, use Google Play Console to add a credential, linking the client ID to your game.

For more than detailed instructions, see the following steps:

a. Configure the OAuth consent screen

If y'all haven't yet configured the OAuth consent screen, the Credentials department will display a message prompting you lot to configure.

Prompt to configure OAuth consent screen

Click Configure. This opens a dialog with further instructions and a deep link to the Google Cloud Platform.

If you accept completed the setup of the OAuth consent screen, click Done. Google Play Console refreshes automatically, and if configuration was successful you will be able to create a credential:

Creating a credential

b. Create a credential

In order to authorize your game to communicate with Google Play games services, you must create a credential with an authorized OAuth2 client ID.

In the Credentials department, click Add together credential.

In the wizard, choose whether you want to create an Android credential (if your game APK will cosign the user and utilize PGS APIs) or a game server credential (if your game server volition use PGS APIs). Follow the instructions specific to your desired credential type.

Android

Set credential details

Ensure that the proper noun in the Name field matches the name of your game. Cull whether to enable Anti-Piracy.

Ready authorisation

Side by side, choose an OAuth customer ID to use for this game projection. If you already have OAuth2 customer IDs, you tin choose one. However, you will usually create a new one. Click Create OAuth client. This opens a dialog with deep links and instructions for creating an OAuth Client ID in Google Deject Platform.

Select Android as the application type.
Enter your game's name in the Name field.
Enter your Android application's package proper name in the Bundle name field.
Open a last and run the Keytool utility to get the SHA1 fingerprints of the release and debug certificates.

To get the release certificate fingerprint, run the following command:

keytool -list -keystore <path-to-product-keystore> -v

To get the debug certificate fingerprint, run the following control:

keytool -listing -keystore <path-to-debug-keystore> -5
The keytool utility prompts you to enter a password for the keystore. The default password for the debug keystore is android. The keytool and then prints the fingerprint to the last.
Paste the SHA1 fingerprint into the Signing document fingerprint (SHA1) field.
Click Create.

For more information about OAuth 2.0 on Android, see Authenticating to OAuth2 Services.

Later you click Done in the dialog, the available Client IDs will refresh. Choose the credential yous created from the driblet-downwards menu and and so click Save Changes. This creates the credential as a draft, enabling you to authenticate to Play Games Services in your game.

You lot may want to create two credentials: one with the release document fingerprint, and one with the debug document fingerprint. Brand sure to utilize the same package name for both. This allows Google Play Games Services to recognize calls from your linked APKs that are signed with either document. For more information nigh certificate signing for Android, see Sign your app.

Game server

Set credential details

Ensure that the name in the Proper name field matches the name of your game.

Gear up authorization

Next, choose an OAuth customer ID to utilise for this game projection. If you already have OAuth2 client IDs, you can cull one. However, you volition unremarkably create a new one. Click Create OAuth client. This opens a dialog with deep links and instructions for creating an OAuth Client ID in Google Cloud Platform.

Select Web awarding as the application type.
Enter your game's name in the Name field.
Click Create.

For more data nigh OAuth 2.0 on Android, come across Authenticating to OAuth2 Services.

After yous click Done in the dialog, the available Client IDs volition refresh. Choose the credential yous created from the drib-down menu then click Save Changes. This creates the credential equally a draft, enabling you to authenticate to Play Games Services from your game server. For more than information about using Play Games Services with your game server, come across Enabling Server-Side Access to Google Play Games Services.

Fugitive mutual setup problems

To avoid common setup mistakes, make sure to follow these recommendations when setting up your game to use Google Play games services.

one. Set up your game with the Google Play Console: If you created an Oauth 2.0 client ID for your app in the Google Cloud Console, Google Play games services volition non know nigh the clan between the game's achievement and leaderboards and the client ID. To create this association, you must create a credential using the Oauth 2.0 client ID as described in Create a credential.
two. Use the correct application ID in Android: The application ID is a required string resource that yous must reference in your Android manifest. The application ID string consists only of the digits (typically 12 or more than) at the beginning of the client ID provided past the Google Play Console. The awarding ID tin can be plant at the top of the Configuration page and is labeled as Projection ID below the proper name of your game.
3. Sign your APK with the correct certificate: When linking your Android app to your game in the Google Play Console, you must use exactly the same parcel proper name and certificate fingerprint that yous used to publish your app. If there is a mismatch, calls to Google Play games services will fail. Y'all should create ii client IDs, one with the release certificate fingerprint and another with the debug certificate fingerprint, and utilize the same package name for both. To larn more than about how to specify the signing document in the Google Play Console, see Signing Your Applications.
4. When developing for Android, include the Play Games SDK equally a library projection, not as a standalone JAR: Make sure that the Google Play services SDK is referenced every bit a library project in your Android project, otherwise this could atomic number 82 to errors when your app is unable to find Google Play services resources. To learn how to set your Android project to use Google Play services, meet Setting Upward Google Play Services.
5. Sign in with a tester account during development: If y'all have not published your game setting changes in the Google Play Console, y'all might meet errors during testing if you are non signed in with a whitelisted tester account. Yous should always enable your Google Play Console publisher account for testing. To learn how to manage tester accounts, see Enabling accounts for testing.
half dozen. Publish the consent screen in Google Cloud Platform: Before publishing the app in the Google Play Console, publish the consent screen in Google Deject Platform. Without this pace, the public audience won't be able to utilize whatsoever of the Play Games Services features.
7. At release, publish the Play Games Services settings showtime before you lot publish your game: Developers might accidentally publish their app without publishing the corresponding Google Play games services settings for their app. This might cause players who are signing in with not-tester accounts to meet errors since the app cannot reference the correct game settings. When releasing your game, remember to commencement publish your game settings by using the Publish Game pick in the Google Play Console. To learn how to publish your changes, meet Publishing your game changes.

For additional tips, refer to:

Android troubleshooting guide - Developer documentation that describes how to troubleshoot issues while developing Android games.

Adjacent steps

Before proceeding further, you lot should add exam accounts to your game equally described in Enabling accounts for testing. Users with authorized examination accounts volition have admission to your unpublished Play Games Services game projection and can exam that your configured Google Play games services are working correctly.

Once you take completed the initial setup tasks described above, you can go along to configure features for your game, such as leaderboards and achievements. To learn more, come across Enable features.