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

您必須先設定 Google API 控制台專案，並建立 Android Studio 專案，才能開始在自己的應用程式中整合 Google 登入。本頁的步驟就是要協助您完成這項工作。接著，後續步驟會說明如何將 Google 登入功能整合至應用程式。

必要條件

Android 適用的 Google 登入有下列需求條件：

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

本指南適用於 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 物件時，將這串字串傳遞至 requestIdToken 或 requestServerAuthCode 方法。

後續步驟

設定 Google API 控制台專案並建立 Android Studio 專案後，您就可以將 Google 登入整合至應用程式。