接收提示 UI 狀態的通知

為方便使用者登入或註冊,您可以與多個身分識別服務供應商聯絡,找出可用的憑證。您可能需要瞭解提示 UI 狀態,才能呼叫下一個 ID 提供者。

如要接收提示 UI 狀態的通知,請將回呼函式名稱設為 data-moment_callback 屬性,或將函式設為 prompt() 方法 (如果您使用 JavaScript API)。

系統會在下列時刻傳送通知:

  • 顯示時刻:這是在呼叫 prompt() 方法後發生的事件。通知包含布林值,用於指出是否要顯示 UI。

  • 略過時刻:當 One Tap 提示訊息因自動取消、手動取消,或 Google 無法核發憑證而關閉時,就會發生這種情況,例如當所選工作階段登出 Google 時。

    在這種情況下,建議您繼續使用其他身分驗證服務供應商 (如有)。

  • Dismissed moment:當 Google 成功擷取憑證,或使用者想要停止憑證擷取流程時,就會觸發這個事件。舉例來說,當使用者開始在登入對話方塊中輸入使用者名稱和密碼時,您可以呼叫 google.accounts.id.cancel() 方法來關閉 One Tap 提示,並觸發已關閉的狀態。

以下程式碼範例實作略過片段:

<script>
 
function continueWithNextIdp(notification) {
     
if (notification.isNotDisplayed() || notification.isSkippedMoment()) {
         
// try Next provider if One Tap is not displayed or skipped
     
}
 
}
</script>
...
<div id="g_id_onload"
     data-client_id="
YOUR_GOOGLE_CLIENT_ID"
     data-login_uri="
https://your.domain/your_login_endpoint"
     data-moment_callback="continueWithNextIdp"
</div>