開始將 Google 登入整合至 Android 應用程式

您必須先設定 Google API 控制台專案,並設定 Android Studio 專案,才能開始將 Google 登入整合至自己的應用程式。本頁中的步驟方便你進行這項操作。接下來,後續步驟就會說明如何將 Google 登入整合至應用程式。

先備知識

Android 版 Google 登入必須符合下列需求條件:

  • 搭載 Android 5.0 以上版本的相容 Android 裝置,內含 Google Play 商店或具備 AVD 的模擬器,且執行以 Android 4.2.2 以上版本執行 Google API 平台,並安裝 Google Play 服務 15.0.0 以上版本的模擬器。
  • 最新版 Android SDK,包括 SDK 工具元件。您可以透過 Android Studio 中的 Android SDK Manager 取得這個 SDK。
  • 設定針對 Android 5.0 (Lollipop) 以上版本進行編譯的專案。

本指南適用於 Android Studio 的使用者,這是建議的開發環境。

新增 Google Play 服務

在專案的頂層 build.gradle 檔案中,確認已納入 Google 的 Maven 存放區:

allprojects {
    repositories {
        google()

        // If you're using a version of Gradle lower than 4.1, you must instead use:
        // maven {
        //     url 'https://maven.google.com'
        // }
    }
}

然後在應用程式層級的 build.gradle 檔案中,宣告「Google Play 服務」為依附元件:

apply plugin: 'com.android.application'
    ...

    dependencies {
        implementation 'com.google.android.gms:play-services-auth:21.2.0'
    }

設定 Google API 控制台專案

  1. API 控制台中開啟專案;如果尚未建立專案,請建立一個。
  2. 在 OAuth 同意畫面中,確認所有資訊均完整正確。
  3. 在「憑證」頁面上,為應用程式建立 Android 類型的用戶端 ID。您必須指定應用程式的套件名稱和 SHA-1 憑證指紋。詳情請參閱驗證用戶端

取得後端伺服器的 OAuth 2.0 用戶端 ID

如果應用程式透過後端伺服器進行驗證從後端伺服器存取 Google API,您必須取得代表後端伺服器的 OAuth 2.0 用戶端 ID。

如何為伺服器建立用戶端 ID:

  1. API 控制台中開啟專案。

  2. 在「憑證」頁面上,建立網頁應用程式類型的用戶端 ID。記下用戶端 ID 字串,建立 GoogleSignInOptions 物件時,您必須將該字串傳遞至 requestIdTokenrequestServerAuthCode 方法。

後續步驟

設定 Google API 控制台專案並設定 Android Studio 專案後,您現在可以將 Google 登入整合到應用程式中。