自動登入及登出

本頁面說明如何實作與使用者透過 Google One Tap 登入或登出的功能相關的功能。

Google One Tap 支援自動登入功能，可省去使用者返回網站時必須採取的手動步驟，提供順暢的使用者體驗 (UX)。使用者不必記得上次造訪時選取的 Google 帳戶，因此在您的平台上建立不必要的複製帳戶的機率也會降低。

自動登入旨在與「使用 Google 帳戶登入」按鈕和 One Tap 對話方塊相輔相成。這類機制可在整個網站使用，只有在使用者首次登出網站後才發生，您可以手動註冊或切換帳戶。

要讓自動登入的情況發生，必須符合下列條件：

使用者必須先登入自己的 Google 帳戶
先前已同意將帳戶個人資料提供給您的應用程式，
使用 FedCM 時，過去 10 分鐘內只嘗試登入一次。如果在這個時間範圍內多次嘗試登入，系統就會顯示 One Tap。
使用 FedCM 時，Chrome 會要求使用者在每個 Chrome 例項中重新確認是否要使用 Google 帳戶登入網站，即使使用者在 FedCM 推出前已核准該網站也一樣。這項變更可能會影響使用 One Tap 的現有網站轉換率。在 Chrome M121 更新中，自動登入功能改善可緩解轉換率下降的問題。

如果網頁已啟用自動登入功能，且符合這些條件，系統會自動傳回使用者的 ID 權杖憑證，無須使用者互動。如果不符合這些條件，且即使頁面已啟用自動登入功能，使用者仍會預設採用 One Tap 流程來登入或同意。如果使用者擁有多個 Google 帳戶，並造訪您的網站，他們必須先登入單一 Google 帳戶，並授予該帳戶的同意聲明。

您可以使用傳回憑證物件 select_by 欄位的 auto 值，評估自動登入成功率。

如要啟用自動登入功能，請在程式碼中新增 data-auto_select="true"，如以下程式碼片段所示：

<div id="g_id_onload"
     data-client_id="YOUR_GOOGLE_CLIENT_ID"
     data-login_uri="https://your.domain/your_login_endpoint"
     data-auto_select="true">
</div>

登出

使用者登出網站時，系統會將他們導向至自動顯示 Google One Tap 提示的網頁。對於這種設定，必須禁止自動選取。否則，使用者會自動重新登入，導致遇到無效迴圈的使用者體驗。

使用 FedCM

為改善使用者體驗，系統會在每次自動登入嘗試之間保留 10 分鐘的靜默期。在這段期間，系統會改為顯示 One Tap 提示。使用者必須明確點選「一鍵登入」才能登入。

不使用 FedCM

如要禁止使用者登出後自動選取，請在所有登出連結和按鈕中加入類別名稱 g_id_signout。請參閱下列程式碼片段：

<div class="g_id_signout">Sign Out</div>

下列 JavaScript 程式碼片段也可以用來登出：

const button = document.getElementById('signout_button');
button.onclick = () => {
  google.accounts.id.disableAutoSelect();
}

因此系統會透過您網域中的 Cookie 記錄登出狀態，避免發生無效迴圈的使用者體驗。

系統會將登出狀態儲存到網域中的 g_state Cookie。如果您有監控網域中所有 Cookie 的服務，就必須通知對方這項 Cookie。

如果您不想在登入後的網頁上載入用戶端程式庫，請使用下列解決方案，避免登出後發生死循環的使用者體驗：

在登出時，將使用者重新導向至不會顯示 One Tap 或一律停用自動登入功能的頁面 (例如 https://example.com/logged_out)。
在登出時，將參數新增至網址。例如：logged_out=1。在轉譯 One Tap by JavaScript API 時，請檢查網址參數，並在出現時停用自動登入功能。