Skip to main content

iOS

The purpose of this article is to explain how to set up Google Authentication so that your game can be logged in through the Google channel using the Player Network login authentication service.

Prerequisites​

1. Set up your game in the Google Play admin center
note

For the IEGG project, please contact [miaruan (Ruan Mingjun)] for Google Apps registration and configuration.

1. Create Google Apps

Follow the prompts to register an account on Google Play Console.

info

Google charges a $25 service fee.Please have your credit card ready in advance.

  1. Go to Google Play Console.
  2. On the All apps page, click Create app to create the game app.
    Image: Google - create a game app
  3. Enter the application information.
    Image: Google - enter information for the app
2. Configuring the Play game service

Set up the Play game service to manage game metadata and automate game production and distribution tasks.

  1. Go to Google Play Console.
  2. In the left navigation bar, select Grow users > Play Games Services > Setup and management > Configuration.
  3. Under Which Play Games Services project do you want to use, select the corresponding option to create a Play Games Services project.
    Image: Google service creation
  4. In the Properties section, click Edit Properties.
  5. Enter the basic information about the game and click Save changes.
    Image: Google basic game information
3. add a credential to connect the OAuth 2.0 client ID to the game

  1. Go to Google Cloud Platform.

  2. In the left navigation bar, click OAuth consent screen.

  3. Follow the instructions to set up the OAuth OAuth consent screen.
    Image: Google, consent to the agreement

  4. Click Clients on the left navigation bar.

  5. On the Clients page, select CREATE CLIENT > Create OAuth Client ID to create an OAuth client ID.
    Image: Google, create OAuth clients

  6. Add both Android and Web OAuth clients.

    • The Android client is used for client login.
    • The Web client is used by the Player Network SDK to obtain offline authorization. client ID is the server client ID.
      Image: Google, create Android and Web clients
Android
  1. In the Authentication type list, click Android.
  2. Enter Package Name and SHA-1 Certificate Fingerprint.
    Confirm Package Name and SHA-1 Certificate Fingerprint with the development team.The OAuth client for Android requires the user to configure the SHA-1 certificate fingerprint and package name in the KeyStore.Make sure these two values are correct.Otherwise, the login process will be abnormal.
    Image: Google, create an Android client
  3. Click SAVE to complete the configuration.
  4. Go to the Android app details page.
    Image: Google, Web client details
  5. Locate the Client ID and Client Secret and enter them into the Player Network console's game configuration.
    Image: Google, Web client Client ID and Secret
Web
  1. In the Authentication type list, click Web.
  2. Enter the required information.
    In the Authorization Redirect URL section of the web application details page, add https://test-common-web.intlgame.com/jssdk/googlelogincallback.html and https://common-web.intlgame.com/ jssdk/googlelogincallback.html.
    Image: Windows redirect URIs
  3. Click SAVE to complete the configuration.
  4. Go to the Web application details page.
    Image: Google, Web client details
  5. Locate the Client ID and Client Secret and enter them into the Player Network console's game configuration.
    Image: Google, Web client Client ID and Secret
  1. Click Audience > ADD USERS to add a login test user.
    Image: Google, add test users
4. Adding game testers
  1. Go to Google Play Console.
  2. In the left navigation bar, select Grow users > Play Games Services > Setup and management > Testers.
  3. In the Testers tab, click Add testers to add testers to your game.
    Image: Google testers
note

Only testers can log in until the game app is released.Make sure that the application is in a test state.

5. Configuring achievements and leaderboards

Locate the Achievements and Leaderboards features on the Gaming Services screen and configure them as needed.

Image: Google leaderboard

6. Get Google API ID

Access the Info Center from the Google Cloud Platform panel.The Google API ID is the Project No. on this page.

Image: Google ID

7. Obtain the Client ID and Client secret.

Follow the steps in Add credentials to link OAuth 2.0 client IDs to the game to get application information.

Image: Google Web Client ID and Secret

  1. Obtain Player Network Console login account.
  2. Create a new project for your game, or join an existing one.
  3. Download SDK.
  4. Integrate the SDK.
  5. Add Google as a business login authentication method in the Player Network console.

Step 1：Configure SDK for Google Sign-in​

  1. Open the INTLConfig.ini file.
INTLConfig.ini
[INTL environment]
# WARNING: You should change this URL to the production environment when you release your game.
INTL_URL = https://test.intlgame.com
GAME_ID = {INTL_GAME_ID}
SDK_KEY = {INTL_SDK_KEY}
[INTL Log]
LOG_LEVEL = 1
LOG_CONSOLE_OUTPUT_ENABLE = 1
LOG_FILE_OUTPUT_ENABLE = 1
LOG_ENCRYPT_ENABLE = 0
LOG_COMPRESS_ENABLE = 0
[Google Channel Configuration]
GOOGLE_CLIENT_KEY_IOS = {INTL_GOOGLE_CLIENT_KEY}
  • Set the SDK backend environment to INTL_URL = https://test.intlgame.com.
  • Replace {INTL_GAME_ID} and {INTL_SDK_KEY} with the values of GAME_ID and SDK_KEY assigned by the Player Network Console.
  • Set LOG_LEVEL = 1, LOG_CONSOLE_OUTPUT_ENABLE = 1, LOG_FILE_OUTPUT_ENABLE = 1, LOG_ENCRYPT_ENABLE = 0 and LOG_COMPRESS_ENABLE = 0 to output console logs and log files without encrypting or compressing the output without encrypting or compressing the output.
  • Replace {INTL_GOOGLE_CLIENT_KEY} with the Client ID assigned by Google.

  1. Get Google Reverse Client ID

    • Open the Google Cloud Console.
    • Navigate to APIs & Services > Credentials.
    • To create a new certificate, select OAuth client ID.
    • Select iOS as the app type and fill in the Bundle ID of your iOS app.
    • Once created, you will be prompted to download the GoogleService-Info.plist file.
    • Open the GoogleService-Info.plist file and copy the value corresponding to the key REVERSED_CLIENT_ID.

    Image: Google Reverse Client ID

  2. Add Google Configuration

Open the INTLGoogleKit.projmods file and replace {INTL_GOOGLE_REVERSED_CLIENT_ID} with the corresponding Google Reverse Client ID before exporting the Xcode project from Unity.

{
    "group": "INTL",
    "libs": ["libz.tbd", "libsqlite3.0.tbd"],
    "frameworks": ["SafariServices.framework", "LocalAuthentication.framework", " AuthenticationServices.framework"],
    "Info.plist":{
        "CFBundleURLTypes" :
        [
            {
                "CFBundleTypeRole": "Editor",
                "CFBundleURLName": "Google",
                " CFBundleURLSchemes":["{INTL_GOOGLE_REVERSED_CLIENT_ID}"]
            }
        ]
    }
}

Step 2: Implement Google Login​

All Google actions require a connection to Google services.

AuthLogin​

During automatic sign-in, the device may not be able to connect to Google services.It is therefore recommended to let Player Network SDK connect to Google services during automatic login by default.(Game teams can disable this connection by configuring the GOOGLE_LOGOUT_NEED_CONNECT field in the Google Channel Configuration section of the INTLConfig configuration file.).

Login​

Before calling Google Login, the Player Network SDK checks to see if Google Mobile Services (GMS) is available.The login service can only be invoked when GMS is available.If GMS is not available, the Player Network SDK will return the error code sent by Google to the game via the ThirdCode field of INTLAuthResult.

Return CodeReturn valuemisdescription
SERVICE_MISSING1GMS is not available on the device.
SERVICE_VERSION_UPDATE_REQUIRED2The installed version of GMS is out of date.
SERVICE_DISABLED3GMS is disabled.
SERVICE_INVALID9The version of GMS installed is incorrect.
SERVICE_UPDATING18The GMS on the device is being updated.

For more information, see Google Docs and Google Frequently Asked Questions

  1. Register login-related callbacks.
// Add callbacks
public void AddAuthObserver()
{
    INTLAPI.AddAuthResultObserver(OnAuthResultEvent);
}

// Remove callbacks
public void RemoveAuthObserver()
{
    INTLAPI.RemoveAuthResultObserver(OnAuthResultEvent);
}

// Process the INTLAuthResult callback
public void OnAuthResultEvent(INTLAuthResult ret)
{
    Debug.Log($"MethodID: {ret.MethodId}");
    
    string methodTag = "";
    if (authRet.MethodId == (int)INTLMethodID.INTL_AUTH_LOGIN)
    {
        methodTag = "Login";
    }
    else if (authRet.MethodId == (int)INTLMethodID.INTL_AUTH_BIND)
    {
        methodTag = "Bind";
    }
    else if (authRet.MethodId == (int)INTLMethodID.INTL_AUTH_AUTOLOGIN)
    {
        methodTag = "AutoLogin";
    }
    else if (authRet.MethodId == (int)INTLMethodID.INTL_AUTH_QUERY_USER_INFO)
    {
        methodTag = "QueryUserInfo";
    }
    else if (authRet.MethodId == (int)INTLMethodID.INTL_AUTH_GET_AUTH_RESULT)
    {
        methodTag = "GetAuthResult";
    }
}
  1. Call the AutoLogin interface to log in automatically.
INTLAPI.AutoLogin();
  1. If automatic login fails, call the Login interface to let the player log in manually.
INTLAPI.Login(INTLChannel.Google);
  1. Synchronize client authentication status with the game backend and wait for the final verification result.

[Optional] Set email permission​

To get the player's email when logging in to Google, you need to set the corresponding permission, which will return email in the ChannelInfo of AuthResult.

  • For compliance considerations, masking of returned email for specific origins can be done. Please contact Player Network Assistant to enable it if needed.
  • In the background log, you can report the hash of base64(sha256(email)). Contact Player Network Assistant if needed.
  • Can be used to verify whether the player's information or the binding list contains email information. Contact Player Network Assistant if needed.
  • Can be used for iOS Firebase's Private Set Membership (PSM) feature. See Firebase iOS Project Configuration.

Enable the email return feature in the Player Network Console by setting return_email to YES. For details, see Third-Party Channel Configuration.

Step 3: Acceptance testing for login functionality​

Search for the keyword "AuthResult" in the Player Network SDK logs to confirm whether the channel name and OpenID are returned correctly.If correct, it means the integration configuration is successful, and login functionality has been successfully added.

If you encounter problems during the integration process, please refer to Frequently Asked Questions.

Step 4：Publish the game​

Before you are ready to release a production version, create a test version using Android App Bundle.

The nice thing about releasing Beta is that users can download it from Google play, but don't have access to add comments.Specific channels are set up for users to submit feedback.

Creating a production version

  1. Go to Google Play Console.

  2. In the left navigation bar, select Release > Production.

    Figure: Select corresponding channel

  3. Follow the instructions to create a production version.

Image: Google beta testing

Changing the Publishing Status
caution

Authentication may fail if the user does not release the application.

  1. Go to the OAuth consent interface page for Google Cloud Platform (https://console.cloud.google.com/apis/credentials/consent).
  2. Change PUBLISHING STATUS to PUBLISH APP.

Image: Google app release

Privacy PolicyTerms of ServiceDPAOpen Source Licenses
©2025 Proxima Beta Pte. Ltd. All rights reserved.