接收提示 UI 狀態的通知

為協助使用者登入或註冊，您可以與多個識別資訊提供者通訊，以尋找可用的憑證。建議您瞭解我們的提示 UI 狀態，以便呼叫下一個識別資訊提供者。

如要在不同時刻收到提示 UI 狀態通知，請將回呼函式名稱設為 data-moment_callback 屬性，或者將函式設定為 prompt() 方法 (如果您使用 JavaScript API)。

系統會在下列時間傳送通知：

  • 顯示時刻：在呼叫 prompt() 方法後發生。通知包含布林值，用於表示 UI 是否顯示。

  • 略過時刻：如果 One Tap 提示因自動取消、手動取消或 Google 無法核發憑證 (例如所選工作階段登出 Google 時) 而關閉，就會發生這個情況。

    在這種情況下，建議您繼續前往下一個識別資訊提供者 (如果有的話)。

  • 關閉的時刻：當 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>