我們即將 停用 Google 登入 Google Web Designer 網頁版程式庫。但 2023 年 3 月 31 日的淘汰日期過後即無法下載。請改用新版網頁版 Google 身分識別服務。
根據預設,新建立的用戶端 ID 現在會遭到封鎖,無法使用舊版平台程式庫,現有的用戶端 ID 則不受影響。凡是在 2022 年 7 月 29 日前建立的用戶端 ID,都可以設定 ‘plugin_name` 來啟用 Google Platform 程式庫。

開始將 Google 登入功能整合至您的 Android 應用程式

透過集合功能整理內容 你可以依據偏好儲存及分類內容。

您必須先設定 Google API 控制台專案並設定 Android Studio 專案,才能開始在自己的應用程式中整合 Google 登入功能。您可以參考這個頁面中的步驟。接下來,再後續步驟將 Google 登入功能整合至您的應用程式。

必要條件

Android 適用的 Google 登入功能符合下列規定:

  • 相容的 Android 裝置。搭載 Android 4.4 以上版本,包括 Google Play 商店,或具有 AVD 的模擬器,以及搭載 Android 4.2.2 以上版本的 Google API 平台,並搭載 Google Play 服務 15.0.0 以上版本。
  • 最新版本的 Android SDK,包括 SDK 工具元件。 您可以透過 Android Studio 的 Android SDK Manager 取得 SDK。
  • 針對 Android 4.4 (KitKat) 以上版本進行編譯的專案。

本指南的適用對象為 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:20.3.0'
    }

設定 Google API 控制台專案

如要設定 Google API 控制台專案,請點擊下方按鈕,並在系統提示時指定應用程式的套件名稱。您也必須提供簽署憑證的 SHA-1 雜湊。詳情請參閱驗證用戶端一文。

設定專案

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

如果應用程式使用後端伺服器進行驗證從後端伺服器存取 Google API,您必須取得為伺服器建立的 OAuth 2.0 用戶端 ID。如何尋找 OAuth 2.0 用戶端 ID:

  1. 在 API 控制台中開啟「憑證」頁面
  2. 網頁應用程式類型的用戶端 ID 是後端伺服器和 3.0 版 OAuth 用戶端 ID。

建立 GoogleSignInOptions 物件時,請將此用戶端 ID 傳遞至 requestIdTokenrequestServerAuthCode 方法。

後續步驟

設定 Google API Console 專案並設定 Android Studio 專案後,即可在應用程式中整合 Google 登入功能。